Seedream API в России

Seedream — семейство картиночных моделей ByteDance: изображение по описанию и правка присланного снимка, в изданиях Pro и Lite. Генерация стоит от 3,15 ₽ — до 10,8% ниже официальной цены. Платят рублями с российской карты, API ключ один на весь каталог, а VPN для вызова не нужен.

Версии Seedream

Цена за генерацию. Счёт идёт по фактическому расходу, задача с ошибкой не тарифицируется.

Модель Поставщик Скидка от официальной цены Цена от, за генерацию
Seedream 5 Pro ByteDance до −10,8% $0.04054,05 ₽
Seedream 5 Lite ByteDance до −10% $0.03153,15 ₽

Что ByteDance говорит о Seedream

Линейку делает команда ByteDance Seed, и адресата она называет прямо: «Based on thorough research into the needs of designers and other user groups, the Seedream team prioritized industry-aligned goals such as text-image alignment, structural coherence, and aesthetic appeal». Перевод наш: «Разобравшись в том, что нужно дизайнерам и другим группам пользователей, команда Seedream поставила во главу угла отраслевые цели: соответствие текста и картинки, связность построения и эстетику». Страница — отчёт о Seedream 3.0.

Что команда считала главными трудностями, перечислено там же: «Core challenges tackled included small-text generation, complex text layout, native 2K high-definition output, and rapid image generation». Перевод наш: «Главными задачами были мелкий текст, сложная раскладка текста, родной вывод в 2K и быстрая генерация».

О четвёртом поколении разработчик говорит шире одной генерации: «Seedream 4.0 is more than just an image generation model—it's an all-around multimodal creative engine». Перевод наш: «Seedream 4.0 — больше, чем модель генерации изображений: это разносторонний многомодальный творческий движок». Страница — анонс Seedream 4.0.

В перечне моделей своей платформы ByteDance подписывает нынешнее поколение коротко: «Dola Seedream 5.0. Leading image generation model. Enhanced reference consistency and improved generation quality for professional scenarios». Перевод наш: «Dola Seedream 5.0. Ведущая модель генерации изображений. Выше согласованность с образцом и качество генерации для профессиональных задач». Приставку Dola разработчик добавляет к именам на своей платформе; страница — список моделей BytePlus ModelArk.

Правило счёта он распространяет на всю линейку: «Images that are not successfully output due to reasons such as content moderation are not billed». Перевод наш: «Картинки, которые не вышли — например, из-за проверки содержимого, — не оплачиваются». Страница — страница цен BytePlus ModelArk. Через GEN202 работает то же самое: неудавшаяся задача возвращает удержанное обратно на баланс.

Слова ByteDance о Seedream приведены по страницам ByteDance Seed и BytePlus на 15 сентября 2026 года.

Первый вызов Seedream API

POST https://api.gen202.com/api/v1/jobs/createTask
GET https://api.gen202.com/api/v1/jobs/recordInfo?taskId=…

Генерация занимает десятки секунд, поэтому изображение не приходит в ответ на запрос. Первый вызов ставит задачу и сразу отвечает её номером, второй по этому номеру отдаёт состояние задачи, а когда она готова — ссылку на результат. Ключ передаётся в обоих запросах заголовком Authorization: Bearer sk-… и выпускается в кабинете. На один ключ шлюз пропускает 30 постановок задачи и 300 запросов состояния в минуту.

task.sh
# 1. Поставить задачу — в ответе придёт её номер
TASK=$(curl -s https://api.gen202.com/api/v1/jobs/createTask \
  -H "Authorization: Bearer sk-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/5-pro-text-to-image",
    "input": {
      "prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет",
      "aspect_ratio": "1:1",
      "quality": "basic"
    }
  }' | jq -r '.data.taskId')

# 2. Спрашивать состояние, пока задача не закончится: waiting, queuing и
#    generating означают «работа идёт», success и fail — окончательные
while true; do
  RECORD=$(curl -s "https://api.gen202.com/api/v1/jobs/recordInfo?taskId=$TASK" \
    -H "Authorization: Bearer sk-ваш-ключ")
  STATE=$(echo "$RECORD" | jq -r '.data.state')
  case "$STATE" in success|fail) break;; esac
  sleep 3
done

# 3. Забрать результат. Ссылка на файл лежит в resultJson — это строка JSON
#    внутри JSON, поэтому её разбирают вторым разбором (fromjson)
echo "$RECORD" | jq -r '.data |
  if .state == "fail"
  then "отказ \(.failCode): \(.failMsg)"
  else .resultJson | fromjson | .resultUrls[0]
  end'
task.py
import json
import time

import requests

headers = {"Authorization": "Bearer sk-ваш-ключ"}

# 1. Поставить задачу — в ответе придёт её номер
created = requests.post(
    "https://api.gen202.com/api/v1/jobs/createTask",
    headers=headers,
    json={
      "model": "seedream/5-pro-text-to-image",
      "input": {
        "prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет",
        "aspect_ratio": "1:1",
        "quality": "basic"
      }
    },
).json()
task_id = created["data"]["taskId"]

# 2. Спрашивать состояние, пока задача не закончится: waiting, queuing и
#    generating означают «работа идёт», success и fail — окончательные
while True:
    task = requests.get(
        "https://api.gen202.com/api/v1/jobs/recordInfo",
        headers=headers,
        params={"taskId": task_id},
    ).json()["data"]
    if task["state"] in ("success", "fail"):
        break
    time.sleep(3)

# 3. Разобрать итог. У неудачи причина в failCode и failMsg
if task["state"] == "fail":
    raise SystemExit("отказ " + task["failCode"] + ": " + task["failMsg"])

# resultJson — строка JSON внутри JSON, поэтому разбор второй
result = json.loads(task["resultJson"])
print(result["resultUrls"][0])
print("списано кредитов:", task["creditsConsumed"])

Песочница

Input

Ещё настройки

Войдите и получите 50 кредитов на тесты и любое использование сервиса. Без регистрации доступна одна генерация в 1K.

{
  "model": "seedream/5-pro-text-to-image",
  "input": {
    "prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}
Output
пример генерации модели seedream/5-pro-text-to-image
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cm8r4t0vk0001s60p2xq7f9ab",
    "model": "seedream/5-pro-text-to-image",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://gen202.com/assets/sample-seedream-5-pro.jpg\"]}",
    "failCode": "",
    "failMsg": "",
    "creditsConsumed": 8.1
  }
}
Input

Ещё настройки

Войдите и получите 50 кредитов на тесты и любое использование сервиса. Без регистрации доступна одна генерация в 1K.

{
  "model": "seedream/5-lite-text-to-image",
  "input": {
    "prompt": "Рыжий кот в скафандре на фоне Земли, мягкий свет",
    "aspect_ratio": "1:1",
    "quality": "basic"
  }
}
Output
пример генерации модели seedream/5-lite-text-to-image
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "cm8r4t0vk0001s60p2xq7f9ab",
    "model": "seedream/5-lite-text-to-image",
    "state": "success",
    "resultJson": "{\"resultUrls\":[\"https://gen202.com/assets/sample-seedream-5-lite.jpg\"]}",
    "failCode": "",
    "failMsg": "",
    "creditsConsumed": 6.3
  }
}

Линейка Seedream: поколения, даты и что менялось

Линейку ведёт команда ByteDance Seed, а продажи наружу идут через платформу BytePlus ModelArk, и номера поколений у обеих сторон одни и те же.

В таблице — имя у разработчика, дата на его странице, суть перемены и место объявления. Издания пятого поколения ведут на свою карточку, прошлые поколения — на страницы разработчика.

Имя у разработчикаДата у разработчикаЧто изменилосьГде объявлено
Seedream 2.010 марта 2025Описанная в статье двуязычная модель: описание и надписи на китайском и английскомстатья о Seedream 2.0
Seedream 3.016 апреля 2025Вывод в 2K без дополнительной обработки и картинка примерно за три секундыотчёт о Seedream 3.0
Seedream 4.09 сентября 2025Генерация и правка сведены в одну модель, предел разрешения поднят с 2K до 4Kанонс Seedream 4.0
Seedream 4.53 декабря 2025Доводка: точнее подробности, устойчивее предметы, до десяти образцов на входеобъявление о Seedream 4.5
Seedream 5 Lite13 февраля 2026Пятое поколение: рассуждение перед рисованием и поиск по сетианонс Seedream 5.0 Lite
Seedream 5 Pro8 июля 2026Старшее издание поколения: правка по пометкам на картинке и разбор кадра на слоианонс Seedream 5.0 Pro

Третье поколение разработчик мерил разрешением и временем: «Native 2K Output for Diverse Aspect Ratios: Delivers 2K resolution images directly without post-processing» и «3-Second Image Generation for Greater Efficiency: Designed for poster design and creative visuals, it can generate high-quality images in around 3 seconds». Перевод наш: «Родной вывод в 2K при разных пропорциях: картинка в 2K выдаётся сразу, без дополнительной обработки» и «Картинка за три секунды: модель рассчитана на постеры и творческие макеты и делает качественное изображение примерно за 3 секунды».

Четвёртое поколение он подал как смену устройства: «Self-adaptation and 4K generation: It can generate images in the optimal aspect ratio based on instructions or reference images, while also supporting custom sizing. The maximum resolution has been increased from 2K to 4K ultra-high definition». Перевод наш: «Подстройка и 4K: модель сама выбирает подходящие пропорции по указанию или по образцу и позволяет задать размер вручную. Предельное разрешение поднято с 2K до 4K».

Выпуск 4.5 разработчик описывает как доводку предыдущего: «Enhanced Multi-Image Fusion. Seedream 4.5 improves the execution quality of multi-image compositions, maintaining structure, consistency, and accuracy even with up to 10 reference images». Перевод наш: «Лучшее сведение нескольких изображений. Seedream 4.5 качественнее собирает композиции из нескольких картинок, сохраняя устройство, согласованность и точность даже при десяти образцах».

Даты столбца напечатаны на самих страницах разработчика, снимок сделан 15 сентября 2026 года. У Seedream 2.0 это дата статьи: отдельного объявления о выпуске у неё нет.

Чем пятое поколение Seedream отличается от прошлых

Пятое поколение вышло двумя изданиями: младшее разработчик объявил 13 февраля 2026 года, старшее — 8 июля 2026 года.

Прибавку старшего издания он описывает работой по пометкам: «Interactive Editing — Accurately responds to spatial annotations and sketch-based guidance. Supports layer separation, which unlocks more creative possibilities». Перевод наш: «Интерактивная правка — модель точно отвечает на пометки поверх картинки и на наброски; поддерживается разделение на слои, а это открывает больше возможностей».

Младшему изданию он приписывает связь с текущими событиями: «Connected to the Latest Trends — Accompanies with online search capability, real-time news and topics can be visualized in an instant». Перевод наш: «Связь с текущими событиями — благодаря поиску по сети свежие новости и темы можно тут же показать картинкой».

В каталоге GEN202 стоит это поколение: 2 модели — Seedream 5 Pro и Seedream 5 Lite. Описание у старшего издания принимается длиной до 5 000 знаков, у младшего — до 3 000; на вход оба издания берут до 10 изображений.

Прошлые поколения разработчик держит у себя: на 15 сентября 2026 года опознаватель seedream-4-0-250828 стоит и в его списке моделей, и в прайсе, а страница третьего поколения в документации помечена снятой с показа.

Что показали независимые проверки Seedream

Первый разбор — заметка издания The Decoder, автор Matthias Bastian, 10 сентября 2025 года. Она пересказывает числа разработчика и прямо помечает, чьи они: «ByteDance reports that Seedream 4.0 takes the top spot in its internal "MagicBench" and "MagicArena" benchmarks for both text-to-image and single-image editing». Перевод наш: «ByteDance сообщает, что Seedream 4.0 занимает первое место в её внутренних наборах проверок "MagicBench" и "MagicArena" и в создании картинки по тексту, и в правке одной картинки». Заметка — разбор Seedream 4.0 в The Decoder.

Второй разбор — заметка того же издания, автор Maximilian Schreiner, 18 апреля 2025 года, про третье поколение: «The model performs especially well on text-heavy prompts, achieving a text rendering rate of 94 percent in both English and Chinese, even with dense typography». Перевод наш: «Модель особенно хорошо работает на запросах с обилием текста: доля верно отрисованного текста — 94 процента и на английском, и на китайском, даже при плотной вёрстке». Заметка — разбор Seedream 3.0 в The Decoder.

Единственная найденная работа, где нынешнее поколение измерено по общему правилу с чужими моделями, — статья «Persistent Identity Preservation in Generative Image Models» на arXiv, авторы Mengwei Ren, Xuaner Zhang и Zhihao Xia, выложена 3 сентября 2026 года. Сторона тут заинтересованная: авторы сравнивают чужие модели со своим подходом. Общий вывод касается сразу всех закрытых моделей: «identity preservation remains a distinct limitation of current generative foundation models: strong image quality and instruction following do not necessarily imply strong identity fidelity». Перевод наш: «Удержание личности остаётся отдельной слабостью нынешних порождающих моделей: высокое качество картинки и хорошее следование указаниям ещё не означают хорошей верности лицу». Работа — статья arXiv:2609.04151.

Поколения линейки между собой расставляет LMArena — площадка слепых попарных сравнений, где человек смотрит две картинки, не зная, чья какая, и выбирает лучшую. На её арене «текст в картинку», обновлённой 7 сентября 2026 года, у строки seedream-5.0-pro стоит 1257 очков, у seedream-4.5 — 1147, у seedream-3 — 1082. Страница — арена «текст в картинку» на LMArena.

Две площадки расставили четвёртое поколение по-разному. У Artificial Analysis Seedream 4.0 стоит выше Seedream 4.5 — 1033 очка против 1008, а у LMArena наоборот: 1147 у Seedream 4.5 против 1140 у Seedream 4.0. Шкалы у площадок свои, между собой эти числа не сравниваются, а объяснения расхождению ни одна из них не даёт. Список — «текст в картинку» у Artificial Analysis.

Ни одна из этих проверок не шла через GEN202: замеры и голоса чужие. Заметки изданий, статья и таблицы арен о Seedream приведены на 15 сентября 2026 года.

Как купить доступ к Seedream API в России

Покупка идёт у нас, а не у ByteDance: счёт от него получает GEN202, а вам счёт выставляем мы и в рублях.

Шагов тоже три — войти, положить деньги на баланс и создать ключ в кабинете.

  1. Учётная запись. Её открывает Яндекс либо ссылка, присланная на почту; пароль придумывать не нужно.
  2. Деньги. Баланс пополняют картой российского банка, и заявок после оплаты ждать не надо.
  3. Ключ. Его создают в кабинете одной кнопкой и сразу подставляют в свой запрос.

Пакет пополнения выбирают на странице тарифов: нижний обходится в 500 ₽ за 1 000 кредитов.

Кредиты на балансе общие для всего каталога: ими же оплачиваются модели других разработчиков.

Подписки здесь нет: списывается стоимость готовых картинок, а задача, кончившаяся неудачей, возвращает удержанное.

Что меняется у Seedream при доступе через GEN202

Сама модель не меняется: работает то же издание ByteDance, с теми же сильными местами и теми же промахами.

Меняются путь запроса и сторона, которой вы платите. Запрос уходит на адрес GEN202, а деньги — российскому продавцу.

Форма запроса у нас своя. У разработчика перечень размеров свой у каждого издания — у старшего до 2K, у младшего от 2K до 4K, — а в каталоге GEN202 стоит уровень качества, и к нему привязана цена.

Картинка приходит той же ссылкой, какую вернул ByteDance: с файлом по дороге ничего не делается.

Проверку содержимого ведёт разработчик, и её решение мы не пересматриваем: отказ передаётся вам вместе с причиной.

Что нужно, чтобы выпустить ключ к Seedream API

Достаточно войти на сайт: ключ создаётся в кабинете и получает имя длиной до 60 знаков.

Ключей на счёте бывает сколько угодно, и выключение одного соседних не задевает. Под каждое своё приложение удобно завести отдельный: расход по нему считается своей строкой.

Тем же ключом вызывается любая другая модель каталога — и картинки, и языковые модели.

Сколько ждать картинку Seedream и сколько хранится файл

Готовая картинка на первый запрос не возвращается: постановка задачи и получение результата разведены на два обращения.

  • Постановка отвечает номером задачи, и дальше по этому номеру спрашивают состояние картинки Seedream.
  • Состояние спрашивают отдельным запросом тогда, когда удобно, — держать открытым соединение не надо.
  • Адрес готового файла приходит внутри поля resultJson, и само поле разбирается вторым разбором JSON.
  • Сколько кредитов ушло, видно в том же ответе, а у задачи, кончившейся неудачей, там остаётся ноль.

Ссылка на файл живёт 14 дней, поэтому картинку забирают к себе сразу после готовности.

Задача закрывается сама, если она не кончилась за 15 минут; кредитов такая задача не стоит.

Разом на счёте держится до 50 незакрытых задач, дальше новая постановка ждёт очереди. Перечень отказов с кодами стоит в разделе документации.

Отказ по форме запроса не стоит ничего: негодное поле отклоняется сразу, и до ByteDance такой запрос не доходит.

Нужен ли ключ ByteDance, чтобы вызвать Seedream

Нет. Ключа платформы BytePlus ModelArk у вас не спросят.

Регистрация у разработчика, проверка организации и долларовый счёт — всё это остаётся на нашей стороне.

Обращение к модели идёт с нашего адреса и нашим ключом, а порядок из двух запросов показан в примере выше.

Можно ли купить у нас API ключ ByteDance

Ключи своей платформы ByteDance выдаёт сам: получают их в кабинете BytePlus ModelArk.

У нас продаются готовые картинки по нашей цене и по нашему адресу, без долларового счёта у ByteDance.

Выпущенный здесь ключ остаётся вашим, отключается вами же, а неизрасходованные кредиты лежат на счёте до первого запроса.

Есть ли бесплатный доступ к Seedream API

50 приветственных кредитов начисляются при первом входе, и на них делаются первые картинки.

До входа работает проба: одна картинка в 1K без оплаты, прямо в песочнице выше — и так 1 раз в сутки.

Бессрочного бесплатного тарифа нет: дальше платят за сделанное, по факту расхода.

Откуда берутся рубли в ценах этой страницы

Все рублёвые суммы на узле — цена GEN202. Она считается из каталога GEN202 — по тем же ставкам, по которым списывается баланс, а не переписана со страницы разработчика. Разбор пакетов пополнения стоит на странице цен.

Seedream API из России

Работать из России можно без VPN, а платить — рублями с карты российского банка. Прямой доступ идёт через биллинг поставщика, и счёт он выставляет в долларах. GEN202 стоит между вами и поставщиком: расчёты с ним наши, вы платите российскому продавцу.

Частые вопросы

Как подключить Seedream API из России
Подключение идёт к GEN202: ключ выпускается в кабинете, а запрос отправляется на api.gen202.com. Учётной записи в BytePlus ModelArk и его ключа для этого не нужно — счёт от разработчика приходит нам. Тем же ключом вызываются Seedream 5 Pro, Seedream 5 Lite и любая другая модель каталога.
Сколько стоит генерация через Seedream API
Цена от 3,15 ₽ за генерацию. Точная зависит от версии и разрешения. Счёт идёт по фактическому расходу, задача с ошибкой не тарифицируется.
Чем оплачивается Seedream и нужен ли VPN
Оплата рублями с карты российского банка, и ни VPN, ни карта иностранного банка при этом не нужны. Баланс ведётся в кредитах: они списываются по мере генерации, а покупаются за рубли — нижний пакет стоит 500 ₽ и приносит 1 000 кредитов, остальные перечислены на странице цен.
Какую версию Seedream выбрать
Seedream 5 Pro принимает более длинное описание.
Чем Seedream 5 Pro отличается от Seedream 5 Lite
Возрастом и пределами. Младшее издание разработчик объявил 13 февраля 2026 года, старшее — 8 июля 2026 года. В каталоге GEN202 старшее принимает описание до 5 000 знаков, младшее — до 3 000; на вход оба издания берут до 10 изображений. Цена старшего начинается от 4,05 ₽, младшего — от 3,15 ₽ за генерацию.
Какие поколения Seedream были до пятого
Seedream 2.0 описана статьёй от 10 марта 2025 года, отчёт о Seedream 3.0 вышел 16 апреля 2025 года, Seedream 4.0 объявлена 9 сентября 2025 года, а Seedream 4.5 — 3 декабря 2025 года. Даты и ссылки на объявления собраны таблицей выше.
Работают ли прошлые поколения Seedream сейчас
На 15 сентября 2026 года опознаватель seedream-4-0-250828 стоит и в списке моделей BytePlus ModelArk, и в его прайсе, а страница третьего поколения в той же документации помечена снятой с показа. Объявления об отключении разработчик не давал.