Vai al contenuto

Documenti per sviluppatori UlazAI

Immagine API

POST /api/v1/generate/

Endpoint di generazione di immagini canoniche

Utilizza questo endpoint per tutte le nuove integrazioni. Scegli un modello con model e facoltativamente passare image_urls per modificare i flussi di lavoro sui modelli supportati.

Stato del sondaggio con /api/v1/generate/{generation_id}/ e utilizzare /api/v1/generate/history/ per la storia lavorativa.

Richiedi contratto

Campo Tipo Obbligatorio Note
prompt stringa Da 1 a 5000 caratteri
model stringa No Il valore predefinito è gpt_image_15
size stringa No I valori consentiti dipendono dal modello selezionato. gpt_image_2 accetta anche rapporti personalizzati come 5:7 o 1024x768.
quality stringa No Modalità risoluzione o qualità, specifica del modello
image_urls array[stringa] No* Utilizzato per modificare i flussi di lavoro su modelli come gpt_image_2, qwen_image, e wan_2_7_image. Richiesto per ideogram_character.

Selettore del modello

Cambia le preimpostazioni del modello per aggiornare istantaneamente gli esempi di richiesta.

Seedream 5.0 Lite model=seedream_5_lite

Multimodal reasoning model with text-to-image and image editing.

Dimensioni consentite: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Valori di qualità consentiti: basic, high

Modalità modifica: supportato

Snippet di richieste in tempo reale

I frammenti di seguito seguono la preimpostazione del modello selezionato.

arricciatura

JavaScript (recupera)

Python (richieste)

Esempi di risposta

201 Creato

{
  "success": true,
  "data": {
    "generation_id": "5a6be42f-4f01-4e80-9e16-8105315f0e62",
    "status": "processing",
    "estimated_time": "varies by model and queue",
    "credits_used": 8,
    "credits_remaining": 124,
    "message": "Generation started successfully"
  }
}

402 Pagamento richiesto

{
  "success": false,
  "error": "Insufficient credits. Need 18, have 7",
  "credits_needed": 18,
  "credits_balance": 7
}

400 Richiesta errata

{
  "success": false,
  "error": "Invalid size. Must be one of: 1:1, 3:2, 2:3"
}