Seedream 5.0 Pro API

What you can build

Use one REST workflow for prompt-based creation, reference-guided variations, and automated image generation.

Make your first Seedream 5.0 Pro API request

Create a task, keep its public task ID, then retrieve the task until it succeeds or fails.

1. 1

   Create an API key

   Generate a key from your Imya account settings.

2. 2

   Choose an input

   Use a prompt alone or add 1-10 reference images.

3. 3

   Retrieve the result

   Poll the public task ID at most every 5 seconds.

Send your Imya API key as a Bearer token. Every generation POST also requires a unique Idempotency-Key so network retries cannot create another task or charge.

Authorization: Bearer YOUR_IMYA_API_KEY
Content-Type: application/json
Idempotency-Key: YOUR_UNIQUE_REQUEST_KEY

Omit image_urls for text-to-image. Add 1-10 public HTTPS images for reference-image generation. The server returns the live credits_reserved for this request.

curl https://imya.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_IMYA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedream-product-shot-001" \
  -d '{
    "model": "seedream-5-pro",
    "prompt": "A premium skincare bottle on pale stone, soft morning light",
    "aspect_ratio": "4:3",
    "quality": "basic",
    "output_format": "png",
    "n": 1
  }'

curl https://imya.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_IMYA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedream-edit-001" \
  -d '{
    "model": "seedream-5-pro",
    "prompt": "Keep the product shape and place it in a warm studio",
    "image_urls": ["https://cdn.example.com/input/product.png"],
    "aspect_ratio": "4:3",
    "quality": "high",
    "output_format": "jpeg",
    "n": 1
  }'

Returns the latest state, final credit usage, stored image result, or a sanitized error. Poll no faster than every 5 seconds.

curl https://imya.ai/v1/tasks/task_0123456789abcdef0123456789abcdef \
  -H "Authorization: Bearer YOUR_IMYA_API_KEY"

Request parameters

Responses

{
  "id": "task_0123456789abcdef0123456789abcdef",
  "status": "pending",
  "model": "seedream-5-pro",
  "credits_reserved": 44
}

{
  "id": "task_0123456789abcdef0123456789abcdef",
  "status": "succeeded",
  "model": "seedream-5-pro",
  "credits_used": 44,
  "data": [
    {
      "url": "https://cdn.imya.ai/generated/example.png"
    }
  ]
}

A new task returns HTTP 202. An exact idempotent replay returns HTTP 200 with Idempotent-Replayed: true. Successful images are copied to Imya-managed storage before the task becomes succeeded. Failed tasks can report generation_failed, refund_pending, or media_deleted.

Task status

Errors