UlazAI developer docs

Legacy image APIs

Legacy endpoint compatibility

Legacy image routes remain available. Keep existing integrations running, but use the unified endpoint for new builds.

Recommended new path: /api/v1/generate/

Legacy endpoint list

Method Path Purpose
POST /api/v1/seedream45/generate/ Seedream 4.5 text-to-image
POST /api/v1/seedream45/edit/ Seedream 4.5 image edit
GET /api/v1/seedream45/status/{task_id}/ Seedream 4.5 task status
POST /api/v1/z-image/generate/ Z-Image photorealistic generation
GET /api/v1/z-image/status/{task_id}/ Z-Image task status
POST /nano-banana/api/generate/ Nano Banana text-to-image
POST /nano-banana/api/edit/ Nano Banana image edit
POST /nano-banana/api/pro/generate/ Nano Banana Pro text-to-image
POST /nano-banana/api/pro/edit/ Nano Banana Pro image edit
GET /nano-banana/api/status/{task_id}/ Nano Banana and Nano Banana Pro status

Migration guidance

Current model family Current route Unified alternative
Seedream 4.5 /api/v1/seedream45/* POST /api/v1/generate/ with model=seedream_5_lite
Nano Banana / Pro /nano-banana/api/* POST /api/v1/generate/ with model=nano_banana_2
Z-Image /api/v1/z-image/* POST /api/v1/generate/ with model=gpt_image_15 or model=grok_imagine

Reference snippets

Legacy Seedream 4.5

curl -X POST https://ulazai.com/api/v1/seedream45/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Architectural interior with warm evening light",
    "aspect_ratio": "16:9",
    "quality": "high"
  }'

Unified replacement

curl -X POST https://ulazai.com/api/v1/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Architectural interior with warm evening light",
    "model": "seedream_5_lite",
    "size": "16:9",
    "quality": "high"
  }'