МиксМедиа API
RUEN
ВойтиНачать
Открыть как Markdown
← Попробовать на сайте

Seedream Flash

ByteDance · ~1 мин
от $0.077за картинку

Быстрая Seedream: картинки до 2K по описанию или по фото, удобно для черновиков и правок.

Seedream Flash — быстрая image-модель ByteDance из семейства Seedream 5.0. Картинки в 1K, 1.5K и 2K по описанию или по вашим фото (до 10). Подходит для быстрых вариантов и правок.

Одна модель seedream-flash: без фото — генерация с нуля; с фото — правка или референсы.

Только описание — модель создаст картинку с нуля.

ID: seedream-flash · 1K $0.077 · 1.5K $0.077 · 2K $0.153 за картинку · ~1 мин

Параметры (поле input)

ПараметрОбязательныйОписаниеЗначения (по умолчанию — жирным)
promptдаЧто нарисовать или что изменитьтекст, до 2000 символов
aspect_ratioнетФорма картинкиauto 1:1 4:3 3:4 16:9 9:16 3:2 2:3 2:1 1:2 21:9
resolutionнетРазмер по длинной стороне: 0.5K ≈ 512 px, 1K ≈ 1024 px, 2K ≈ 2048 px, 4K ≈ 4096 px. Размеры больше родного — апскейл готовой картинки (Lanczos + лёгкая резкость): 4K у Nano Banana 2 и Pro из 2K, 2K у Nano Banana из 1K, 2K и 4K у GPT Image из родных ~1,5K1K 1.5K 2K
output_formatнетФормат файлаjpeg png

Пример

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-flash","input":{"prompt":"Кот-астронавт в неоновом городе, кинематографичный свет","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-flash",
      "input": {
        "prompt": "Кот-астронавт в неоновом городе, кинематографичный свет",
        "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-flash",
    "input": {
      "prompt": "Кот-астронавт в неоновом городе, кинематографичный свет",
      "aspect_ratio": "auto",
      "resolution": "1.5K"
    }
  }),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }

С фото в input: опишите, что изменить.

ID: seedream-flash · 1K $0.077 · 1.5K $0.077 · 2K $0.153 за картинку · ~1 мин

Параметры (поле input)

ПараметрОбязательныйОписаниеЗначения (по умолчанию — жирным)
promptдаЧто нарисовать или что изменитьтекст, до 2000 символов
image_urlsдаСсылки на ваши фото (https), до 10 шт.["https://…"]
aspect_ratioнетФорма картинкиauto 1:1 4:3 3:4 16:9 9:16 3:2 2:3 2:1 1:2 21:9
resolutionнетРазмер по длинной стороне: 0.5K ≈ 512 px, 1K ≈ 1024 px, 2K ≈ 2048 px, 4K ≈ 4096 px. Размеры больше родного — апскейл готовой картинки (Lanczos + лёгкая резкость): 4K у Nano Banana 2 и Pro из 2K, 2K у Nano Banana из 1K, 2K и 4K у GPT Image из родных ~1,5K1K 1.5K 2K
output_formatнетФормат файлаjpeg png

Пример

curl -X POST https://mixmedia.tech/api/v1/jobs/createTask \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedream-flash","input":{"prompt":"Сделай фон ночным неоновым городом","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-flash",
      "input": {
        "prompt": "Сделай фон ночным неоновым городом",
        "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-flash",
    "input": {
      "prompt": "Сделай фон ночным неоновым городом",
      "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: "..." } }

Совместимость

Запросы в формате OpenAI и других популярных API тоже работают:

  • model: seedream-flash, seedream-5-0-flash, seedream-5.0-flash, doubao-seedream-5-0-flash.
  • size вместо aspect_ratio: соотношение (16:9) или точный размер (1600x1200) — возьмём ближайшее поддерживаемое соотношение.
  • Фото можно передать в image_urls, image_input или input_urls. Параметры можно передать и без обёртки input — на верхнем уровне тела запроса.
  • resolution в любом регистре (1k, 2K); jpg и jpeg — одно и то же. n — только 1 (одна картинка за запрос).
  • nsfw_check, official_fallback, google_search принимаются, но не влияют на результат.

Результат

Как у любой задачи: запросите recordInfo или получите callback. Ссылки на картинки — в resultJson (хранятся 24 часа).

Свои фото загрузите через files/upload или передайте любые публичные https-ссылки.

Обработка ошибок

Ответ API — JSON {"code", "msg", "data"}; при ошибке есть строковое поле error (тип). На /api/v1/* HTTP-статус совпадает с code в теле.

Примеры тел ответа

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

Коды при createTask / upload

codeerrorЧто значитЧто делать
400invalid_request_errorНеверный параметр или телоСмотрите msg
400unsupported_modelНет такой моделиСписок моделей
401authentication_errorНет ключа или он неверныйПроверьте ключ
402payment_requiredНе хватает денегПополните баланс
403permission_errorНет доступаНапишите в поддержку
429rate_limit_errorСлишком много запросовПодождите Retry-After
505model_disabledМодель временно отключенаВыберите другую
500server_errorСбой у насПовторите позже

Примеры msg: Authentication failed. Please check your API key (401); Insufficient balance. Please top up and try again… (402).

Ошибки задачи (recordInfo)

Если задача уже создана и завершилась неудачей: state: "fail" (алиас status: "failed"), failCode / failMsg, объект error: { code, message, type }. Деньги возвращаются (refunded: true).

failCodeerror.typeЧто значит
400nsfw_content_detected / invalid_request_errorМодерация / правила безопасности
422invalid_request_errorМодель не приняла параметры (например, не скачалось фото)
501server_errorМодель не смогла сгенерировать (failMsg)
504timeout_errorСлишком долго — повторите
500 / 503server_errorСервис временно недоступен

Лимиты запросов

ЧтоЛимит
createTask и upload20 за 10 с на ключ
recordInfo / list / balance100 за 10 с на ключ

Сверх лимита — HTTP 429 и Retry-After.

© 2026 МиксМедиа