Skip to main content
POST
Image Editing / Multi-image Fusion / Batch Sequence
Один эндпоинт, несколько режимов: у Seedream нет отдельного эндпоинта /v1/images/edits. Редактирование, слияние нескольких изображений и пакетная последовательность выполняются через POST /v1/images/generations. Playground на этой странице обращается к тому же эндпоинту, что и Текст-в-изображение — единственное различие состоит в параметрах image и sequential_image_generation в теле запроса.
Режимы:
  • Редактирование одного изображенияimage: ["url"] + sequential_image_generation: "disabled"
  • Слияние нескольких изображенийimage: ["url1", "url2", ...] + disabled
  • Пакетная последовательностьsequential_image_generation: "auto" + sequential_image_generation_options.max_images: N
  • Изображение-в-последовательность — объединяет оба: массив image + auto + max_images
🖥️ Ограничение Browser 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? Скопируйте пример кода ниже и запустите его локально — код автоматически декодирует и сохранит изображение в файл.
⚠️ Ключевые отличия от редактирования OpenAI gpt-image-2
  • Нет загрузок multipart/form-data — сначала загрузите свои изображения в OSS или на публичный хост изображений, а затем передайте URL в массиве image
  • image — это массив URL, а не повторяющееся поле image[] (в отличие от формата multipart/form-data OpenAI)
  • Нет поля mask — Seedream не поддерживает inpainting по маске alpha-канала; все изображение переписывается по prompt
  • Жесткий лимит на общее количество: входные ссылки + выходные изображения ≤ 15
📎 Порядок нескольких изображений имеет значениеПорядок URL в массиве image становится тем, что в prompt обозначается как «изображение 1 / изображение 2 / изображение 3». Явно указывайте порядок:
Замените одежду на изображении 1 на наряд с изображения 2, сохранив освещение с изображения 3.
Лучше всего работают prompt на английском языке (модель в основном обучена на English), но китайский тоже поддерживается, если формулировка однозначна.

Примеры кода

О extra_body (важно — не думайте, что это дополнительный уровень вложенности)image, sequential_image_generation и watermark не являются стандартными параметрами images.generate() OpenAI SDK, поэтому в Python SDK вы должны поместить их внутрь extra_body, чтобы отправить их.Но extra_body — это всего лишь контейнер параметров SDK: его поля расплющиваются и объединяются на верхнем уровне тела запроса, на том же уровне, что и model и prompt. Фактический JSON, который уходит, идентичен примеру cURL ниже (image находится на верхнем уровне); в запросе нет реальной вложенности "extra_body": {...}.Если вы не используете OpenAI SDK и вместо этого собираете JSON напрямую (requests / fetch / и т. д.), не записывайте extra_body — просто поместите image и другие поля на тот же уровень, что и model.

Python (OpenAI SDK · редактирование одного изображения)

Python (OpenAI SDK · объединение нескольких изображений)

Python (OpenAI SDK · пакетная последовательность)

cURL (объединение нескольких изображений)

Node.js (fetch · пакетная последовательность)

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

Ограничения по количеству в режимах Multi-image и последовательности

Итеративная доработка: передавайте URL предыдущего результата как следующий вход с новой инструкцией по редактированию, чтобы последовательно уточнять результат. Каждый раунд тарифицируется по каждому изображению — следите за накопительной стоимостью.

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

⚠️ Длина массива data отражает фактическое количество вывода
  • sequential_image_generation: "disabled" → массив из одного элемента data
  • sequential_image_generation: "auto" + max_images: N → обычно N элементов (иногда меньше, если prompt возвращает меньше)
  • Тарификация производится по usage.generated_images, а не по max_images
Запросы на редактирование тарифицируются так же, как text-to-image, — по одному выходному изображению. Входные reference image не тарифицируются отдельно.

Авторизации

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
обязательно

Editing / fusion / sequence instruction. For multi-image scenarios, refer to images explicitly as 'image 1 / image 2'

Пример:

"Replace the clothing in image 1 with the outfit from image 2."

image
string<uri>[]

Reference image URL array. Up to 10 images (per official 4.5 docs). Note: input + output count ≤ 15

Maximum array length: 10
Пример:
sequential_image_generation
enum<string>
по умолчанию:disabled

Generation mode switch. disabled = single output (default); auto = batch sequence, paired with max_images

Доступные опции:
disabled,
auto
sequential_image_generation_options
object

Batch sequence options. Effective only when sequential_image_generation=auto

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

Output size. Preset tiers (vary by version):

  • 1K (4.0 only) / 2K (all) / 3K (5.0 only) / 4K (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,
b64_json
output_format
enum<string>
по умолчанию:jpeg

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

Доступные опции:
png,
jpeg
watermark
boolean
по умолчанию:false
stream
boolean
по умолчанию:false

Streaming output. Recommended for long prompts and multi-image sequence scenarios

Ответ

Edited image generated successfully

model
string
Пример:

"seedream-5-0-260128"

created
integer
Пример:

1768518000

data
object[]

Result array. disabled mode returns 1 element; auto mode typically returns max_images elements (may be fewer)

usage
object

Billed by generated_images actual count, NOT by max_images