Перейти к основному содержанию
POST
Text-to-Image: generate an image from a text prompt
Интерактивный Playground справа позволяет вызывать API напрямую. Укажите в заголовке Authorization ваш API-ключ (формат: Bearer sk-xxx), введите prompt, выберите модель и размер и нажмите кнопку отправки.
Область применения: на этой странице рассматривается исключительно генерация изображений по тексту (без поля image). Для редактирования на основе референсных изображений, объединения нескольких изображений или пакетной генерации последовательностей см. раздел Редактирование изображений — используется тот же эндпоинт, отличаются только параметры.
🖥️ Ограничение Playground в браузере (только для режима b64_json)В режиме по умолчанию response_format: "url" Playground работает корректно (ответ представляет собой лишь временную ссылку BytePlus TOS). Если переключиться на response_format: "b64_json", ответ будет содержать строку base64 размером в несколько мегабайт, и Playground в браузере может отобразить 请求时发生错误: unable to complete request — на самом деле запрос завершился успешно; браузер просто не может отрендерить настолько длинную строку base64.Рекомендуемый рабочий процесс:
  • Хотите просто просмотреть изображение? Оставьте режим по умолчанию url — Playground напрямую возвращает ссылку (не забудьте скачать её в собственное хранилище в течение 24 часов).
  • Нужен b64_json? Скопируйте приведенный ниже пример кода и запустите его локально — код автоматически декодирует изображение и сохранит его в файл.
⚠️ Доступные разрешения зависят от версии
  • seedream-5-0-flash-260915 — пресеты 1K / 1.5K / 2K, а также точные значения WxH от 0.92M до 4.62M пикселей суммарно, соотношение сторон до 16:1 (пресетов 3K/4K нет; при использовании пресетов модель сама выбирает соотношение сторон; sequential_image_generation / stream не принимаются — их передача возвращает 400; ~15–20 с на изображение, $0.018 за запрос)
  • seedream-5-0-pro-260628 — пресеты 1K / 2K, а также точные значения WxH до 4.19M пикселей суммарно (при соотношении 16:9 длинная сторона достигает 2720×1530, проверено; пресетов 3K/4K нет; sequential_image_generation / stream не принимаются — их передача возвращает 400; ~2 мин на изображение)
  • seedream-5-0-260128 — только 2K / 3K (без 4K)
  • seedream-4-5-251128 — 2K / 4K
  • seedream-4-0-250828 — 1K / 2K / 4K
При неподдерживаемых размерах возвращается ошибка 400. Точные значения пикселей должны удовлетворять условию: общее число пикселей ∈ [1280×720, 4096×4096] и соотношение сторон ∈ [1/16, 16].
Все API для работы с изображениями синхронны — здесь нет task ID для опроса статуса, и если клиент разорвёт соединение, результат будет потерян, при этом тарификация за запрос всё равно будет списана. Установите для этой модели достаточно большой таймаут; см. Основы работы с API изображений и лучшие практики.

Примеры кода

Python (OpenAI SDK)

Python (сырые запросы)

cURL

Node.js (fetch)

JavaScript в браузере

Справочник параметров

Подробные ограничения параметров, допустимые значения и примеры доступны на панели Playground справа. Параметры редактирования / генерации нескольких изображений (image, sequential_image_generation и т. д.) описаны на странице Редактирование изображений.

Формат ответа

⚠️ Оговорки по полям ответа
  • Когда response_format=url, data[].url — это временный подписанный BytePlus TOS URL (обычно действителен 24 часа). Для production сразу загрузите его в свое хранилище.
  • Когда response_format=b64_json, data[].b64_json — это обычная base64-строка, без префикса data:image/...;base64,. Декодируйте ее (base64.b64decode) для вывода в файл или самостоятельно добавьте префикс для отображения в браузере.
  • data[].size отражает фактический размер результата, который может немного отличаться от запрошенного size после нормализации соотношения сторон моделью.
usage.generated_images отражает количество изображений, учитываемых в тарификации. Seedream тарифицируется за каждое изображение; output_tokens / total_tokens — это метрики наблюдаемости, и они не влияют на тарификацию.

Авторизации

Authorization
string
header
обязательно

API Key obtained from APIYI Console

Тело

application/json
model
enum<string>
по умолчанию:seedream-5-0-260128
обязательно

Model ID

Доступные опции:
seedream-5-0-260128,
seedream-5-0-lite-260128,
seedream-4-5-251128,
seedream-4-0-250828,
seedream-5-0-pro-260628,
seedream-5-0-flash-260915
prompt
string
обязательно

Prompt, supports both English and Chinese. Describe scene, style, and lighting in detail for better results.

Пример:

"A serene Japanese garden with cherry blossoms, koi pond, traditional bridge, golden hour, ultra detailed"

size
string
по умолчанию:2K

Output size. Preset tiers (vary by version):

  • 1K (~1024×1024) — 4.0 / 5.0-pro / 5.0-flash
  • 1.5K (~1536×1536) — 5.0-flash only
  • 2K (~2048×2048) — 5.0 / 4.5 / 4.0
  • 3K (~3072×3072) — 5.0 only
  • 4K (~4096×4096) — 4.5 / 4.0

Or exact pixel size WxH, total pixels ∈ [1280×720, 4096×4096], aspect ratio ∈ [1/16, 16]

Пример:

"2K"

response_format
enum<string>
по умолчанию:url

url returns a temp signed link (24h validity); b64_json returns plain base64 (no data: prefix)

Доступные опции:
url,
b64_json
output_format
enum<string>
по умолчанию:jpeg

Output format. 5.0 supports png/jpeg; 4.5/4.0 only jpeg

Доступные опции:
png,
jpeg
seed
integer

Random seed. Note: officially supported only by seedream-3-0-t2i; ignored by the current 4.x / 5.x models

Пример:

42

watermark
boolean
по умолчанию:false

Whether to include the BytePlus watermark. Set to false for commercial use

stream
boolean
по умолчанию:false

Enable streaming output. Useful for long prompts and high-resolution generation. Not accepted by 5.0-pro / 5.0-flash (returns 400)

Ответ

Image generated successfully

model
string
Пример:

"seedream-5-0-260128"

created
integer

Unix timestamp

Пример:

1768518000

data
object[]
usage
object