ByteDance · Картинки · API

Seedream API — цены в рублях и подключение за 5 минут

Seedream API (ByteDance) в рублях: версии Lite и Pro через один ключ Zerocoder. Цена за картинку, примеры кода, лимиты и возвраты.

Получить API-ключSeedream в студии без кода →ДокументацияДля бизнеса →

Что такое Seedream

Seedream — семейство моделей ByteDance для генерации и редактирования изображений по текстовому описанию. В линейке две модели: seedream-5.0-lite и seedream-5.0-pro. Lite — самая дешёвая модель семейства, подходит для массовых и черновых генераций; Pro — старшая модель с более высоким качеством и детализацией, дороже по цене за запрос.

Что даёт подключение через Zerocoder

Один API-ключ и один рублёвый кошелёк открывают доступ сразу ко всем моделям платформы, включая обе модели Seedream. Оплата картой РФ или по счёту для юрлица, без VPN и зарубежных карт. Текущие цены моделей смотрите в таблице выше или через GET /v1/models. Документация и управление ключами — в кабинете API. SDK и примеры кода для Python и Node уже оформлены на странице, достаточно подставить свой ключ.

Как устроен запрос

Генерация новой картинки идёт через POST /v1/images/generations: передаёте prompt, id модели, размер или соотношение сторон — в ответ приходит временная ссылка на файл, который нужно скачать сразу. Редактирование существующего изображения — через POST /v1/images/edits: передаёте prompt, исходное изображение (ссылку, data URI или файл) и, при необходимости, новое соотношение сторон. Списание происходит за каждую сгенерированную картинку в момент запроса.

Подключить Seedream API →

Доступные модели и цены

Таблица строится из живого прайса GET /v1/models: цены уже с наценкой, в рублях и в долларах по внутреннему курсу. Что пропало из таблицы — временно не отдаёт шлюз.

МодельЕдиница₽$Примеры стоимостиEndpoint
seedream-5.0-liteрекомендуемза картинку4,8 ₽$0.053
1 генерация: 4,8 ₽ · $0.053
10 генераций: 48 ₽ · $0.533
/v1/images/generations
seedream-5.0-proрекомендуемза картинку9,6 ₽$0.107
1 генерация: 9,6 ₽ · $0.107
10 генераций: 96 ₽ · $1.07
/v1/images/generations
Подключить Seedream API →

Калькулятор стоимости

Выберите модель и объём — калькулятор считает по тем же формулам, что биллинг API.

за картинку4,8 ₽ $0.053
в месяц · 1048 ₽ $0.533

Цены из GET /v1/models, курс — внутренний. Неудачная генерация не списывается.

Подключить Seedream API →

Первый запрос

Один ключ zc-sk-…, заголовок x-api-key (или Authorization: Bearer), база https://zerocoder.com/api/v1. Примеры собраны из реальных контрактов маршрутов.

1

Создайте ключ

В кабинете → API: пополните баланс в рублях и создайте ключ zc-sk-…

2

Отправьте запрос

Скопируйте пример ниже — id модели уже подставлен из прайса.

3

Проверьте списание

GET /v1/balance покажет баланс; цена вызова приходит в ответе.

model: seedream-5.0-lite
curl https://zerocoder.com/api/v1/images/generations \
  -H "x-api-key: zc-sk-…" -H "content-type: application/json" \
  -d '{"model": "seedream-5.0-lite", "prompt": "Studio photo of a ceramic coffee mug on a walnut table, soft window light", "aspect": "1:1"}'
# → {"created":…,"data":[{"url":"https://…"}]}   (the URL is temporary — download it)
import requests

r = requests.post("https://zerocoder.com/api/v1/images/generations",
    headers={"x-api-key": "zc-sk-…"},
    json={"model": "seedream-5.0-lite", "prompt": "Studio photo of a ceramic coffee mug on a walnut table, soft window light", "aspect": "1:1"})
r.raise_for_status()
print(r.json()["data"][0]["url"])
const r = await fetch("https://zerocoder.com/api/v1/images/generations", {
  method: "POST",
  headers: { "x-api-key": "zc-sk-…", "content-type": "application/json" },
  body: JSON.stringify({ model: "seedream-5.0-lite", prompt: "Studio photo of a ceramic coffee mug on a walnut table, soft window light", aspect: "1:1" }),
});
const { data } = await r.json();
console.log(data[0].url);

Редактирование картинок (/images/edits)

# JSON — image(s) by https URL or data URI, up to 4
curl https://zerocoder.com/api/v1/images/edits \
  -H "x-api-key: zc-sk-…" -H "content-type: application/json" \
  -d '{"model": "seedream-5.0-lite", "prompt": "Make it a night scene", "image": "https://example.com/photo.jpg", "aspect": "16:9"}'

# multipart — files from disk (≤ 8 MB each)
curl https://zerocoder.com/api/v1/images/edits \
  -H "x-api-key: zc-sk-…" \
  -F model=seedream-5.0-lite -F prompt="Make it a night scene" -F aspect=16:9 \
  -F "image[]=@photo1.jpg" -F "image[]=@photo2.jpg"
Подключить Seedream API →Seedream в студии без кода →Документация

Как подключить Seedream API: первый запрос за 5 минут

От ключа до продакшена — шесть шагов по реальным контрактам /api/v1. Каждый шаг ведёт в нужный раздел документации.

  1. 1

    Получите ключ в кабинете

    Зарегистрируйтесь, откройте раздел API в кабинете, пополните баланс в рублях и создайте ключ формата zc-sk-…. Один ключ открывает Seedream и все остальные модели каталога.

    Подробнее →
  2. 2

    Отправьте первый запрос

    POST /v1/images/generations с model, prompt и aspect или size — в ответе data[0].url с готовой картинкой Seedream.

    Подробнее →
  3. 3

    Сохраните результат и попробуйте правки

    Ссылка на картинку временная — сразу скачайте файл в своё хранилище. Для правок есть /v1/images/edits: до четырёх исходников по https-ссылке, data URI или multipart, до 8 МБ каждый.

    Подробнее →
  4. 4

    Обработайте лимиты и ошибки

    30 запросов в минуту на ключ: на 429 подождите и повторите с нарастающей паузой; 402 — пополните баланс; 400 — сверьте model по GET /v1/models. Неудачная генерация не списывается, повторять её безопасно.

    Подробнее →
  5. 5

    Следите за бюджетом

    GET /v1/balance отдаёт баланс и расход за 30 дней; цена каждого вызова приходит прямо в ответе — пишите её в свои логи и поставьте порог оповещения в своём мониторинге.

    Подробнее →
  6. 6

    Выводите в продакшен

    Ключ храните в секретах сервера, не во фронтенде. Под большой объём Seedream напишите нам — лимит поднимается индивидуально, юрлицам доступна оплата по счёту. Фактическую стабильность смотрите на странице статуса.

    Подробнее →

Без кода

Любой инструмент, который умеет HTTP-запрос, умеет и наш API: один POST с заголовком x-api-key.
HTTP Requestn8n

Узел HTTP Request: метод POST, адрес ручки /api/v1, заголовок x-api-key и JSON-тело из полей воркфлоу. Для видео — узел Wait и второй HTTP Request на GET ?id= в цикле до completed.

HTTP → Make a requestMake

Модуль HTTP «Make a request»: POST, Body type JSON, заголовок x-api-key. Ответ парсится автоматически — url картинки или текст ответа подставляются в следующие модули.

Webhooks by ZapierZapier

Действие Webhooks by Zapier → Custom Request: POST, Data — JSON с model и prompt, Headers — x-api-key. Поля ответа доступны следующим шагам запа.

Apps ScriptGoogle Sheets

В Apps Script — UrlFetchApp.fetch с method post, contentType application/json и payload из ячеек: промты в одной колонке, результат записывается в соседнюю.

любой бот-фреймворкTelegram-бот

Бот на aiogram, grammY или Telegraf вызывает тот же HTTP API: сообщение пользователя → запрос к модели → ответ в чат. Для видео — опрос статуса и отправка файла по готовой ссылке.

OpenAI-совместимый base URLPython / Node SDK

Для текстовых моделей официальные SDK OpenAI и Anthropic работают с заменённым base URL и нашим ключом — код приложения не меняется. Картинки и видео — обычный HTTP-запрос из любого языка.

Подключить Seedream API →
Для бизнеса

Поможем внедрить ИИ в ваш бизнес

Не только ключ: поможем встроить Seedream и другие модели в ваши процессы — от аудита до продакшена, с оплатой по счёту.

  • Аудит процессовСмотрим, где в ваших процессах ИИ окупается: поддержка, продажи, контент, документы. Называем конкретные сценарии и модели.
  • Интеграция в CRM, сайт, Telegram, n8nПодключаем по нашему API или готовыми сценариями без кода; один ключ и общий баланс на все модели.
  • Оплата в рублях по счётуЮрлицам — счёт на расчётный счёт, закрывающие документы для бухгалтерии, зачисление на API-баланс.
  • Поддержка и лимитыПомогаем с промтами и архитектурой, поднимаем лимит запросов под вашу нагрузку индивидуально.
Оставить заявку →Подробнее о решениях для бизнеса

Входные материалы, лимиты и возврат денег

  • Генерация: prompt + aspect 1:1 / 16:9 / 9:16 / 4:3 / 3:4 или size 1024x1024 / 1792x1024 / 1024x1792
  • Редактирование: до 4 картинок — https-ссылки, data URI или multipart
  • До 8 МБ на файл, до 48 МБ на запрос (иначе 413)
  • Ссылка на результат временная — сохраняйте файл сразу
  • Сбой провайдера — ничего не списывается
  • 30 запросов в минуту на ключ (все ручки вместе)

Ответы с ошибками и возвраты

# 401 {"type":"error","error":{"type":"authentication_error","message":"Invalid or revoked API key."}}
# 402 {"type":"error","error":{"type":"billing_error","message":"Not enough API balance: …"}}
# 429 {"type":"error","error":{"type":"rate_limit_error","message":"…"}}   ← 30 requests/min per key
# 400 {"type":"error","error":{"type":"invalid_request_error","message":"Unknown model \"…\". See GET /v1/models."}}
# 413 {"type":"error","error":{"type":"invalid_request_error","message":"…"}}   ← > 8 MB per file / > 48 MB body
# 502 {"type":"error","error":{"type":"api_error","message":"…"}}                ← provider failed → nothing charged
Подключить Seedream API →

Фактическая стабильность API и генерации картинок

Цифры — из публичной сводки /status: доля успешных запросов за период по всему API и по категории в целом (разбивки по отдельным моделям в сводке нет), без обещаний SLA. Неудачная генерация не списывается, повторять её безопасно.

API для разработчиковработает штатно

—сейчас (окно 2 ч)
65%за 30 дней
65%за 90 дней

Генерация картинокработает штатно

—сейчас (окно 2 ч)
91%за 30 дней
89%за 90 дней

Возвраты и списания

  • Сбой провайдера — ничего не списывается
  • Слишком большой файл — 413 ещё до списания
  • Ссылка на результат временная — сохраняйте файл сразу

Учёт ведётся с 6 авг. 2026.

Страница статусаКоды ошибок и ретраиЧто нового в API
Подключить Seedream API →

Сценарии использования

1

Генератор обложек и карточек товара для интернет-магазина по текстовому описанию товара

2

Бот в Telegram, который рисует иллюстрации по запросу пользователя в чате

3

Пайплайн автогенерации баннеров для лендингов продуктовой команды

4

Внутренний инструмент дизайнера для быстрых набросков концептов перед финальной отрисовкой

5

Сервис подбора и ретуши фото профиля с заменой фона через edits

6

Автоматизация для контент-команды: массовая генерация иллюстраций к статьям блога

Подключить Seedream API →

Как готовить промт

  • Опишите композицию и план кадра явно: что на переднем плане, что на фоне, где находится объект
  • Укажите стиль и материалы прямо в prompt: фотореализм, иллюстрация, 3D-рендер, конкретная текстура поверхности
  • Задайте источник и направление света отдельной фразой — это сильно влияет на итоговое настроение кадра
  • Выбирайте size или aspect под задачу: 1:1 для карточек товара, 16:9 для баннеров, 9:16 для сторис
  • В edits формулируйте правку точно: что изменить (фон, цвет, объект) и что оставить без изменений
  • Исключайте нежелательные детали явной фразой «без …», а не отрицанием в середине описания
  • Для консистентного персонажа передавайте референс через image в edits и описывайте только то, что меняется в сцене
Подключить Seedream API →

Готовые промты для Seedream

Скопируйте промт и параметры в тело запроса — поля называются так же, как в контракте /api/v1. Подставьте свой материал в угловых скобках.

Фото товара на светлом фоне

Product photo of a glass bottle of cold-pressed orange juice on a light beige background, soft daylight from the left, gentle shadow, clean catalog composition
aspect: 1:1

Баннер с местом под заголовок

Wide promotional banner for a summer sale: beach towels and sunglasses arranged on warm sand on the right side, empty space on the left for a headline, bright midday light
aspect: 16:9

Текст добавьте в макете — так он будет без ошибок.

Вертикальный креатив для сторис

Vertical lifestyle shot of a young woman holding a takeaway coffee cup on a city street at golden hour, shallow depth of field, warm tones, empty space at the top for a caption
aspect: 9:16

Для строгого вертикального формата берите версию Pro.

Визуализация интерьера

Scandinavian living room with a light oak floor, a soft grey sofa, a large window with morning light and indoor plants, photorealistic architectural visualization
aspect: 4:3

Иллюстрация к статье

Flat editorial illustration of a small team planning a product launch around a whiteboard, muted pastel palette, simple shapes, no text
aspect: 3:4

Концепт упаковки

Packaging concept for a premium herbal tea: matte dark green box with gold line-art leaves, studio lighting, three-quarter view, blank front panel for the logo
aspect: 1:1
Подключить Seedream API →

Кому подходит Seedream API

Отрасли, где этот тип генерации встраивается в процесс, а не остаётся экспериментом.

E-commerceКаталожные фото и lifestyle-сцены для карточек товаров — Seedream прямо из вашей админки.
Реклама и перформансКреативы под формат каждой площадки и десятки вариаций для A/B-тестов.
Медиа и блогиОбложки и иллюстрации к материалам в едином визуальном стиле.
Дизайн и агентстваКонцепты и мудборды для питчей до ручной доработки.
Интерьер и девелопментВизуализация отделки и атмосферы объекта до ремонта и продаж.
SaaS и приложенияГенерация картинок Seedream внутри вашего продукта — один ключ и общий баланс.
Подключить Seedream API →

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

Сколько стоит одна картинка Seedream API в рублях?

Seedream оплачивается за каждую готовую картинку: у версий Lite и Pro своя цена за изображение — она в таблице выше и в GET /v1/models, уже в рублях и с наценкой. Сумма списывается в момент запроса, а партия стоит ровно цену картинки, умноженную на их количество; калькулятор на странице посчитает итог заранее.

Как отправить запрос к Seedream API из Python или Node.js?

Обычным HTTP-запросом: POST /v1/images/generations с заголовком x-api-key и JSON из model, prompt и aspect — в ответе придёт data[0].url. Формат совместим с OpenAI Images, поэтому подойдёт и официальный SDK OpenAI с base_url zerocoder.com/api/v1. Готовые примеры Seedream для командной строки, Python и Node.js — в блоке «Первый запрос».

Чем Seedream Lite отличается от Seedream Pro?

Обе версии сделаны ByteDance и вызываются одинаково — меняется только поле model. Pro точнее следует сложным многосоставным промтам и лучше держит мелкие детали, а формат кадра у неё задаётся параметром aspect; Lite дешевле за картинку и подходит для черновиков и массовых вариаций. Точные id версий Seedream — в таблице и в GET /v1/models.

Какие форматы кадра и лимиты у Seedream API?

Соотношение сторон передаётся в aspect — 1:1, 16:9, 9:16, 4:3 или 3:4 — либо в size вида 1024x1024, 1792x1024, 1024x1792; формат учитывает версия Pro. Один запрос возвращает одну картинку Seedream, n больше единицы не поддерживается. Лимит ключа общий — 30 запросов в минуту; генерация Pro может идти несколько минут, так что ставьте клиенту запас по таймауту.

Списываются ли деньги, если Seedream не вернул картинку?

Нет: если запрос завершился ошибкой, сумма за картинку Seedream возвращается на API-баланс, а в тексте ошибки это прямо указано. Платите только за ответы с готовой ссылкой в data[0].url. Ссылка временная — сохраняйте файл в своё хранилище сразу, иначе повторный запрос станет новой платной генерацией.

Можно ли оплатить Seedream API по безналу от компании?

Да. Юрлицо запрашивает счёт в кабинете API и оплачивает его с расчётного счёта — деньги зачисляются на API-баланс, и Seedream работает тем же ключом, что и остальные модели. Физлица и ИП пополняют баланс картой российского банка; аккаунт BytePlus и зарубежная карта не нужны, закрывающие документы — по запросу.

Есть ли бесплатные генерации Seedream через API?

Нет, бесплатных картинок Seedream в API нет: кошелёк открывается минимальным первым пополнением, дальше каждая генерация списывается по прайсу. Чтобы не тратить лишнего на подбор промтов, отлаживайте формулировку на Lite и переходите на Pro, когда она устоялась, — формат запроса у версий одинаковый.

Как писать промты для Seedream, чтобы получить нужную композицию?

Seedream хорошо разбирает длинные описания, поэтому перечисляйте всё по порядку: объект, окружение, ракурс, свет, стиль и где оставить место под заголовок или логотип. Сам текст лучше добавлять в макете. Если кадр «плывёт», сократите промт до главного и возвращайте детали по одной — так видно, какая из них мешает.

Подключить Seedream API →

API нейросетей для ваших продуктов

Оплата в рублях, без VPN, один ключ ко всем моделям

Получить API-ключВсе модели API