Hoppa till innehållet

UlazAI utvecklardokument

Bild API

POST /api/v1/generate/

Endpoint för kanonisk bildgenerering

Använd denna slutpunkt för alla nya integrationer. Välj en modell med model och valfritt godkänt image_urls för att redigera arbetsflöden på modeller som stöds.

Omröstningsstatus med /api/v1/generate/{generation_id}/ och använda /api/v1/generate/history/ för jobbhistorik.

Begär kontrakt

Fält Typ Obligatoriskt Anteckningar
prompt sträng Ja 1 till 5000 tecken
model sträng Nej Standard till gpt_image_15
size sträng Nej Tillåtna värden beror på vald modell. gpt_image_2 accepterar också anpassade förhållanden som 5:7 eller 1024x768.
quality sträng Nej Upplösning eller kvalitetsläge, modellspecifikt
image_urls array[sträng] nej* Används för att redigera arbetsflöden på modeller som gpt_image_2, qwen_image, och wan_2_7_image. Krävs för ideogram_character.

Modellväljare

Byt modellförinställningar för att uppdatera exemplen på begäran omedelbart.

Seedream 5.0 Lite model=seedream_5_lite

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

Tillåtna storlekar: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Tillåtna kvalitetsvärden: basic, high

Redigeringsläge: stöds

Liveförfrågningsavsnitt

Utdrag nedan följer den valda modellens förinställning.

curL

JavaScript (hämta)

Python (förfrågningar)

Exempel på svar

201 Skapad

{
  "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 Betalning krävs

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

400 Dålig begäran

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