Skip to content

UlazAI developer docs

Seedream API

Seedream API

Endpoints for Seedream 3.0 (images) and V1 Pro/Lite image‑to‑video (3–12s). Webhooks + polling fallback, automatic refunds on failure.

POST /api/v1/seedream/generate/

Image (Seedream 3.0)

curl -X POST https://ulazai.com/api/v1/seedream/generate/ \
  -H 'Content-Type: application/json' \
  -b 'sessionid=YOUR_SESSION' \
  -d '{
    "generation_type": "image",
    "prompt": "Modern product photo, studio, soft edge light",
    "image_size": "square_hd",
    "guidance_scale": 2.5,
    "enable_safety_checker": true
  }'
POST /api/v1/seedream/generate/

Video — V1 Pro (I2V)

curl -X POST https://ulazai.com/api/v1/seedream/generate/ \
  -H 'Content-Type: application/json' \
  -b 'sessionid=YOUR_SESSION' \
  -d '{
    "generation_type": "video",
    "prompt": "Parallax push-in, subtle particles over logo plate",
    "video_model": "bytedance/v1-pro-image-to-video",
    "input_image_url": "https://example.com/still.jpg",
    "resolution": "720p",
    "duration": 6,
    "camera_fixed": false
  }'
POST /api/v1/seedream/generate/

Video — V1 Lite (I2V)

curl -X POST https://ulazai.com/api/v1/seedream/generate/ \
  -H 'Content-Type: application/json' \
  -b 'sessionid=YOUR_SESSION' \
  -d '{
    "generation_type": "video",
    "prompt": "Slow reveal, ambient dust, gentle camera push",
    "video_model": "bytedance/v1-lite-image-to-video",
    "input_image_url": "https://example.com/still.png",
    "resolution": "720p",
    "duration": 5,
    "camera_fixed": false
  }'
GET /seedream/status/<generation_id>/
curl https://ulazai.com/seedream/status/UUID/ \
  -b 'sessionid=YOUR_SESSION'
POST /api/v1/seedream/enhance/
curl -X POST https://ulazai.com/api/v1/seedream/enhance/ \
  -H 'Content-Type: application/json' \
  -b 'sessionid=YOUR_SESSION' \
  -d '{"prompt":"Hero product on matte plate, cinematic lighting","generation_type":"video"}'

Notes:

  • Images: 4 credits. V1 Pro: 6/10/16 credits per second by resolution. V1 Lite: 3s=20, +5 per extra second (3–12s).
  • Callbacks + polling ensure reliable completion. Auto‑refund on failure.

Seedream API clients need a current model name and explicit edit inputs

Choose generation or edit mode, validate the source images and send only supported fields from this reference. Save the returned identifier and surface provider failures rather than replacing them with a generic timeout.

Read the current credit estimate shown here. Do not promise local execution or a free API key unless the product explicitly offers it.

Music Studio Songs, instrumentals and your own lyrics.