Hopp til innholdet

UlazAI utviklerdokumenter

Bilde API

POST /api/v1/generate/

Endepunkt for kanonisk bildegenerering

Bruk dette endepunktet for alle nye integrasjoner. Velg en modell med model og eventuelt bestå image_urls for redigering av arbeidsflyter på støttede modeller.

Avstemningsstatus med /api/v1/generate/{generation_id}/ og bruk /api/v1/generate/history/ for jobbhistorikk.

Be om kontrakt

Felt Type Obligatorisk Notater
prompt streng Ja 1 til 5000 tegn
model streng Nei Standard til gpt_image_15
size streng Nei Tillatte verdier avhenger av valgt modell. gpt_image_2 godtar også tilpassede forhold som 5:7 eller 1024x768.
quality streng Nei Oppløsning eller kvalitetsmodus, modellspesifikk
image_urls array [streng] Nei* Brukes til å redigere arbeidsflyter på modeller som gpt_image_2, qwen_image, og wan_2_7_image. Påkrevd for ideogram_character.

Modellvelger

Bytt modellforhåndsinnstillinger for å oppdatere forespørselseksempler umiddelbart.

Seedream 5.0 Lite model=seedream_5_lite

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

Tillatte størrelser: 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9

Tillatte kvalitetsverdier: basic, high

Redigeringsmodus: støttes

Direkte forespørselssnutter

Snuttene nedenfor følger den valgte modellforhåndsinnstillingen.

curL

JavaScript (hent)

Python (forespørsler)

Eksempler på respons

201 Opprettet

{
  "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 Betaling kreves

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

400 Dårlig forespørsel

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