Seedream Pro

Seedream Pro is ByteDance's flagship image model. 1K, 1.5K and 2K pictures from a description or your photos (up to 10). Strong text on images and character consistency.

One model, seedream-pro: no photos = generate from scratch; with photos = edit or references.

#Prompt only — the model creates the picture from scratch.

ID: seedream-pro · 1K $0.077 · 1.5K $0.077 · 2K $0.153 per image · ~2 min

Parameters (field input)

Example

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-pro","input":{"prompt":"A cat astronaut in a neon city, cinematic light","aspect_ratio":"auto","resolution":"1.5K"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "seedream-pro",
      "input": {
        "prompt": "A cat astronaut in a neon city, cinematic light",
        "aspect_ratio": "auto",
        "resolution": "1.5K"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "seedream-pro",
    "input": {
      "prompt": "A cat astronaut in a neon city, cinematic light",
      "aspect_ratio": "auto",
      "resolution": "1.5K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

#With photos in input: describe what to change.

ID: seedream-pro · 1K $0.077 · 1.5K $0.077 · 2K $0.153 per image · ~2 min

Parameters (field input)

Example

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-pro","input":{"prompt":"Make the background a neon city at night","image_urls":["https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"],"aspect_ratio":"auto","resolution":"1.5K"}}'

import os, requests

r = requests.post(
    "https://mixmedia.tech/api/v1/jobs/createTask",
    headers={"Authorization": f"Bearer {os.environ['API_KEY']}"},
    json={
      "model": "seedream-pro",
      "input": {
        "prompt": "Make the background a neon city at night",
        "image_urls": [
          "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
        ],
        "aspect_ratio": "auto",
        "resolution": "1.5K"
      }
    },
)
print(r.json())  # {"code": 200, "data": {"taskId": "..."}}

const r = await fetch("https://mixmedia.tech/api/v1/jobs/createTask", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "model": "seedream-pro",
    "input": {
      "prompt": "Make the background a neon city at night",
      "image_urls": [
        "https://mixmedia.tech/static/img/previews/gpt-t2i.jpg"
      ],
      "aspect_ratio": "auto",
      "resolution": "1.5K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

#Compatibility

Requests in the OpenAI format and other popular API formats work too:

• model: seedream-pro, seedream-5-0-pro, seedream-5.0-pro, doubao-seedream-5-0-pro.
• size instead of aspect_ratio: a ratio (16:9) or exact pixels (1600x1200) — we use the closest supported ratio.
• Photos can go in image_urls, image_input or input_urls. Parameters may also be sent at the top level of the body, without the input wrapper.
• resolution in any case (1k, 2K); jpg and jpeg are the same. n must be 1 (one image per request).
• nsfw_check, official_fallback, google_search are accepted but do not change the result.

#Result

Same as any task: call recordInfo or receive a callback. Image links are in resultJson (kept for 24 hours).

Upload your photos via files/upload or pass any public https links.

#Error handling

API responses are JSON {"code", "msg", "data"}; errors also have a string error field (type). On /api/v1/* the HTTP status matches body code.

#Example response bodies

400

{
  "code": 400,
  "msg": "input.duration: must be between 4 and 30, or \"auto\" / -1",
  "data": null,
  "error": "invalid_request_error"
}

401

{
  "code": 401,
  "msg": "Authentication failed. Please check your API key",
  "data": null,
  "error": "authentication_error"
}

402

{
  "code": 402,
  "msg": "Insufficient balance. Please top up and try again. Available: $0.01, required: $0.015. Top up at https://ai.aimixmedia.site/cabinet/billing",
  "data": {
    "balance": "0.0100",
    "required": "0.0150",
    "currency": "USD",
    "topUpUrl": "https://mixmedia.tech/cabinet/billing"
  },
  "error": "payment_required"
}

429

{
  "code": 429,
  "msg": "Rate limit exceeded: 10 createTask/upload requests per 10 s per key. Retry after 8s",
  "data": null,
  "error": "rate_limit_error"
}

500

{
  "code": 500,
  "msg": "Internal server error",
  "data": null,
  "error": "server_error"
}

#Codes on createTask / upload

Example msg values: Authentication failed. Please check your API key (401); Insufficient balance. Please top up and try again… (402).

#Task errors (recordInfo)

If the task was created and then failed: state: "fail" (alias status: "failed"), failCode / failMsg, and error: { code, message, type }. Money is refunded (refunded: true).

#Rate limits

Over the limit — HTTP 429 and Retry-After.