Seedream Pro
Картинки ByteDance: точный текст, до 2K, до 10 референсов — генерация и правка в одной модели.
Seedream Pro — старшая image-модель ByteDance. Делает картинки в 1K, 1.5K и 2K по описанию или по вашим фото (до 10). Хорошо пишет текст на изображении и держит стиль персонажа.
Одна модель seedream-pro: без фото — генерация с нуля; с фото — правка или референсы.
Только описание — модель создаст картинку с нуля.
ID: seedream-pro · 1K $0.077 · 1.5K $0.077 · 2K $0.153 за картинку · ~2 мин
Параметры (поле 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,5K | 1K 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-pro","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-pro",
"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-pro",
"input": {
"prompt": "Кот-астронавт в неоновом городе, кинематографичный свет",
"aspect_ratio": "auto",
"resolution": "1.5K"
}
}),
});
console.log(await r.json()); // { code: 200, data: { taskId: "..." } }
С фото в input: опишите, что изменить.
ID: seedream-pro · 1K $0.077 · 1.5K $0.077 · 2K $0.153 за картинку · ~2 мин
Параметры (поле 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,5K | 1K 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-pro","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-pro",
"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-pro",
"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-pro,seedream-5-0-pro,seedream-5.0-pro,doubao-seedream-5-0-pro.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
| code | error | Что значит | Что делать |
|---|---|---|---|
| 400 | invalid_request_error | Неверный параметр или тело | Смотрите msg |
| 400 | unsupported_model | Нет такой модели | Список моделей |
| 401 | authentication_error | Нет ключа или он неверный | Проверьте ключ |
| 402 | payment_required | Не хватает денег | Пополните баланс |
| 403 | permission_error | Нет доступа | Напишите в поддержку |
| 429 | rate_limit_error | Слишком много запросов | Подождите Retry-After |
| 505 | model_disabled | Модель временно отключена | Выберите другую |
| 500 | server_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).
| failCode | error.type | Что значит |
|---|---|---|
| 400 | nsfw_content_detected / invalid_request_error | Модерация / правила безопасности |
| 422 | invalid_request_error | Модель не приняла параметры (например, не скачалось фото) |
| 501 | server_error | Модель не смогла сгенерировать (failMsg) |
| 504 | timeout_error | Слишком долго — повторите |
| 500 / 503 | server_error | Сервис временно недоступен |
Лимиты запросов
| Что | Лимит |
|---|---|
| createTask и upload | 20 за 10 с на ключ |
| recordInfo / list / balance | 100 за 10 с на ключ |
Сверх лимита — HTTP 429 и Retry-After.