Skip to main content
POST

Авторизация

string
обязательно
Все конечные точки API требуют аутентификации Bearer TokenПолучите свой API Key:Перейдите на страницу управления API ключами, чтобы получить свой API KeyДобавьте его в заголовок запроса:
Модель одиночных изображений: seedream-5-0-pro создаёт только 1 изображение за запрос (кроме декомпозиции на слои). Следующие параметры отклоняются (HTTP 400, задача не создаётся, оплата не списывается):
  • n > 1
  • sequential_image_generation (групповая генерация не поддерживается)
  • stream (потоковая передача не поддерживается)
  • tools (веб-поиск не поддерживается)
  • более 10 элементов в image_urls

Интерактивное редактирование

Используйте координаты <point> / <bbox> в промпте или загрузите изображение с рукописными пометками, чтобы точно указать область редактирования.
  • Координаты точки: <point>x y</point> (задают одну точку; модель определяет область воздействия)
  • Координаты ограничивающей рамки: <bbox>x1 y1 x2 y2</bbox> (задают координаты левого верхнего и правого нижнего углов для точного управления размером области редактирования)

Декомпозиция на слои

Разделите одно изображение на базовое изображение и до 16 прозрачных PNG-слоёв с данными о позиции и порядке наложения.

Тело запроса

string
по умолчанию:"seedream-5-0-pro"
обязательно
Название модели генерации изображений
  • seedream-5-0-pro (рекомендуется)
  • Также принимается: seedream-5.0-pro
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображенияНеобязателен при layer_decomposition: true; если опущен, модель автоматически определит и разделит основные элементы изображения.Помимо китайского и английского, нативная генерация текста поддерживает русский, арабский, филиппинский, тайский, турецкий, корейский, малайский, испанский, португальский, индонезийский, французский, немецкий, вьетнамский и японский языки.
Совет: не более 600 английских слов; слишком длинное описание может привести к потере деталей.
string
по умолчанию:"1K"
Уровень разрешения (допускается нижний регистр). Это расширение API Mart, эквивалентное прямому указанию уровня в size.
  • 1K (по умолчанию)
  • 1.5K (та же цена, что у 1K, лучше качество — предпочтительно 1.5K, если нет причин иначе)
  • 2K
Неподдерживаемые уровни, например 3K / 4K, возвращают 400.Если одновременно заданы size в виде уровня и resolution, приоритет имеет size.
Когда sizeточное значение в пикселях (например 2048x1024), это поле игнорируется, размеры берутся только из size.
string
по умолчанию:"auto"
Ключевое слово уровня, соотношение сторон, auto или точные размеры в пикселях.

Формат ①: уровень разрешения (рекомендуется)

Уровень можно указать непосредственно в size или через поле расширения API Mart resolution:
Эти форматы эквивалентны. Если задан только уровень, опишите желаемую компоновку в промпте (например, “вертикальный плакат” или “горизонтальная обложка”) и позвольте модели выбрать соотношение сторон.

Формат ②: уровень + соотношение сторон

Используется с resolution. Поддерживаемые соотношения:
  • 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 2:1, 1:2, 21:9
  • Также принимается разделитель x в стиле 16x9
  • 2x1 эквивалентно 2:1, а 1x21:2. Символ x должен быть строчным; пробелы не допускаются.
  • auto (по умолчанию): применяется только уровень разрешения; итоговое соотношение выбирается по prompt / референсам
Соотношения вне списка (например 9:21) возвращают 400 — без тихого отката к 1:1.Уровень × соотношение → пиксели вывода:

Формат ③: точные пиксели

Когда sizewidthxheight, пиксели используются как есть, resolution не применяется. Принимаются 2048X1024 / 2048×1024.
Ограничения применяются к произведению ширины и высоты, а не к каждой стороне отдельно. Пример: 512×512 слишком мало (400); 2048×1024 допустимо.
string
по умолчанию:"opaque"
Режим фона выходного изображения:
  • opaque: непрозрачный фон (по умолчанию)
  • transparent: прозрачный фон
transparent доступен только для запросов image-to-image с ровно одним входным изображением, уже содержащим альфа-канал; также требуется output_format: "png".
boolean
по умолчанию:"false"
Указывает, нужно ли разложить изображение на слои. При включении модель возвращает одно базовое изображение и до 16 PNG-слоёв с альфа-каналами.Требуется ровно одно изображение PNG или JPEG. Оно должно содержать от [262144, 36000000] пикселей и иметь размер не более 30 МБ. size принимает только 1K, 1.5K, 2K или auto; по умолчанию — auto. output_format управляет только форматом базового изображения; слои всегда возвращаются в PNG.
object
по умолчанию:"{\"mode\":\"standard\"}"
Режим оптимизации промпта:
  • standard: стандартный режим с лучшим качеством (по умолчанию)
Также принимается плоская форма "optimize_prompt_options.mode": "standard".
integer
по умолчанию:"1"
Число создаваемых изображений. Поддерживается только 1; для групповой генерации используйте seedream-5-0-lite.
array
Список URL референсных изображений для image-to-image с одним / несколькими референсами, до 10Два формата:1. Публичный URL
  • http:// или https://
  • Пример: https://example.com/image.jpg
2. Base64 (Data URI)
  • Формат: data:image/<format>;base64,<data><format> должен быть в нижнем регистре
  • Пример: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Ограничения на одно изображение:
  • Форматы: jpeg / png / webp / bmp / tiff / gif / heic / heif
  • Соотношение сторон (w/h): [1/16, 16]
  • Каждая сторона > 14 px
  • Размер ≤ 30 MB
  • Всего пикселей ≤ 6000×6000 (36,000,000)
Тарификация: первое референсное изображение бесплатно; каждое дополнительное — фиксированная доплата.
string
по умолчанию:"jpeg"
Формат выходного изображения
  • jpeg (по умолчанию)
  • png
Совместимость: response_format эквивалентен output_format; прочие значения обрабатываются как jpeg.
boolean
по умолчанию:"false"
Добавлять ли водяной знак “AI generated” в правом нижнем углу
  • true: добавить водяной знак
  • false: без водяного знака (по умолчанию)

Примеры запросов

Text-to-image (уровень + соотношение)

Text-to-image (точные пиксели)

Несколько референсов

Рекомендуется: 1.5K та же цена, лучше качество

Декомпозиция на слои

Также можно использовать координаты <bbox>, нормализованные к 0–1000, чтобы точно указать извлекаемые элементы:

Интерактивное редактирование

Опишите рукописные пометки на изображении естественным языком:
Или точно укажите позиции через <point> / <bbox>:

Редактирование альфа-канала

Полный пример: отправка задачи и получение изображения

Скрипт ниже показывает полный цикл: отправку асинхронной задачи, опрос её статуса, обработку ошибок и чтение итогового URL изображения. Перед запуском замените YOUR_API_KEY.
Python
При успехе endpoint запроса задачи возвращает:
Возвращаемые изображения зеркалируются в хранилище под управлением платформы. Всё равно своевременно скачайте и сохраните их в своей системе; не считайте URL результата постоянным хранилищем.

Полные сценарии cURL

Композиция из нескольких изображений (до 10 референсов)

Точные пиксели, оптимизация промпта и водяной знак

Декомпозиция и отдельное редактирование прозрачного слоя

Сначала разложите исходное изображение:
Затем получите URL прозрачного слоя и отредактируйте его отдельно:

Ответ декомпозиции на слои и реконструкция

Массивы url, sizes, output_formats и layers соответствуют друг другу по индексу; индекс 0 всегда обозначает базовое изображение:
Накладывайте слои в порядке возрастания z_index. Для реконструкции на базовом выходном изображении по абсолютным координатам:
Для реконструкции на любом холсте W × H используйте нормализованные координаты:
Декомпозиция на слои оплачивается за каждое изображение. При отправке задачи предавторизуется до 17 изображений. После завершения каждому выходу назначается уровень по фактическому числу пикселей и он оплачивается отдельно; излишек предавторизации возвращается автоматически. Баланс должен покрывать предавторизацию 17 изображений, а size: "auto" предавторизуется на уровне 2K.

Примечания по тарификации

Выход тарифицируется по фактическому числу пикселей (~2.61M = 2,601,124):
  • 1.5K стоит столько же, сколько 1K ($0.045).
  • При точных пикселях в size учитывается фактическая площадь; resolution не влияет (например size: "2048x2048" → $0.09).
  • Первое референс-изображение бесплатно; каждое следующее — с надбавкой.
  • При сбое задачи — полный автоматический возврат.

Предавторизация и расчёт декомпозиции на слои

Поскольку при отправке задачи конечное число и размеры слоёв неизвестны, предавторизация использует консервативные правила по параметрам запроса:
  • Точные пиксели: уровень по запрошенной площади в пикселях.
  • 1K / 1.5K: предавторизация на уровне 1K.
  • 2K: предавторизация на уровне 2K.
  • auto: может выводить до 2K, поэтому предавторизуется на уровне 2K.
После завершения базовое изображение и каждый фактический слой отдельно классифицируются и суммируются по реальной площади в пикселях. Излишек предавторизации возвращается автоматически. Слои обычно намного меньше базового изображения, поэтому даже задача, предавторизованная на уровне 2K, может полностью рассчитаться на уровне 1K.
Пример: вход 1080×1080 разлагается на 10 изображений. Задача предавторизуется как 17 изображений × уровень 2K. Если все 10 итоговых изображений содержат не более 2,61 млн пикселей, расчёт идёт как 10 изображений × уровень 1K, а остаток средств возвращается автоматически.

Типичные ошибки

⏱️ Более медленная генерация: около 90 с для 1K и 160 с для 2K (приоритет качества). Опрашивайте статус задачи каждые 5–10 секунд и установите тайм-аут клиента на 5 минут. Своевременно сохраняйте созданные результаты.

Ответ

integer
Код состояния ответа
array
Массив данных ответа