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"
}'