Skip to main content
POST
Text-to-Image: generate an image from a text prompt
Интерактивный Playground справа позволяет вызывать API напрямую. Установите Authorization в значение вашего API-ключа (формат: Bearer sk-xxx), введите prompt, выберите модель и размер и нажмите отправку.
Область применения: эта страница охватывает только чистый text-to-image (без поля 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-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-2511282K / 4K
  • seedream-4-0-2508281K / 2K / 4K
Неподдерживаемые размеры возвращают 400. Точные значения пикселей должны удовлетворять: total ∈ [1280×720, 4096×4096] и aspect ratio ∈ [1/16, 16].
Все API генерации изображений работают синхронно — нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицироваться. Установите для этой модели достаточно большой timeout; см. Основы API генерации изображений и лучшие практики.

Примеры кода

Python (OpenAI SDK)

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

cURL

Node.js (fetch)

JavaScript в браузере

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

Подробные ограничения параметров, допустимые значения и примеры доступны на панели Playground справа. Параметры редактирования / multi-image (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
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 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

Ответ

Image generated successfully

model
string
Пример:

"seedream-5-0-260128"

created
integer

Unix timestamp

Пример:

1768518000

data
object[]
usage
object