POST
Создать изображение

Authorizations

Authorization
string
header
required

API-ключ в качестве токена носителя в заголовке авторизации

Body

application/json

Ввод запроса на создание изображения

model
string
required

Используемая модель генерации изображения

Example:

"bytedance-seed/seedream-4.5"

prompt
string
required

Текстовое описание желаемого изображения

Minimum string length: 1
Example:

"a red panda astronaut floating in space, studio lighting"

aspect_ratio
enum<string>

Нормализованное соотношение сторон сгенерированного изображения. Провайдеры ограничиваются поддерживаемым им подмножеством.

Available options:
1:1,
1:2,
1:4,
1:8,
2:1,
2:3,
3:2,
3:4,
4:1,
4:3,
4:5,
5:4,
8:1,
9:16,
16:9,
9:19.5,
19.5:9,
9:20,
20:9,
9:21,
21:9,
auto
Example:

"16:9"

background
enum<string>

Фоновая обработка. Для «прозрачного» требуется выходной_формат, поддерживающий альфа-канал (png или webp).

Available options:
auto,
transparent,
opaque
Example:

"auto"

input_references
object[]

Ссылки на изображения для управления созданием изображений в виде URL-адресов данных base64 или URL-адресов HTTP(S).

Maximum array length: 16
n
integer

Количество изображений для создания (1-10). Поставщики, поддерживающие создание только одного изображения, отклоняют n > 1.

Example:

1

output_compression
integer

Уровень сжатия (0–100) для вывода в формате webp/jpeg. Игнорируется для PNG и провайдерами без ручки сжатия.

Example:

100

output_format
enum<string>

Кодирование байтов возвращаемого изображения. Большинство моделей поддерживают растровые форматы (png, jpeg, webp). SVG поддерживается моделями векторизации (например, Quiver) — разметка SVG имеет кодировку UTF-8 base64 в b64_json.

Available options:
png,
jpeg,
webp,
svg
Example:

"png"

provider
object

Настройки маршрутизации провайдера и конфигурация транзитной передачи для конкретного провайдера.

Example:
quality
enum<string>

Качество рендеринга. Провайдеры, не имеющие ручки качества, игнорируют это.

Available options:
auto,
low,
medium,
high
Example:

"high"

resolution
enum<string>

Нормализованный уровень разрешения сгенерированного изображения. Конкретные размеры пикселей определяются для каждого поставщика.

Available options:
512,
1K,
2K,
4K
Example:

"2K"

seed
integer

Если указано, генерация будет производиться детерминированно, так что повторяющиеся запросы с одним и тем же начальным числом и параметрами должны возвращать один и тот же результат. Детерминизм не гарантируется для всех поставщиков.

size
string

Необязательно. Удобное сокращение для выходных размеров — передайте уровень («2K», «4K») или явные пиксели («2048x2048»), и мы нормализуем его до правильных размеров для выбранного поставщика. Размер уровня эквивалентен настройке разрешения и сочетается с соотношением сторон. Явный размер пикселя имеет решающее значение: несовпадение «разрешения» или «aspect_ratio» рядом с ним отклоняется с помощью 400.

Example:

"2K"

stream
boolean

Если true, частичные изображения передаются в потоковом режиме как события SSE по мере их появления. Поддерживается только провайдерами с собственной потоковой передачей (в настоящее время OpenAI). Непотоковые поставщики игнорируют этот флаг и возвращают буферизованный ответ.

Response

Ответ на создание изображения

Ответ на создание изображения

created
integer
required

Временная метка Unix (в секундах), когда было создано изображение.

Example:

1748372400

data
object[]
required

Сгенерированные изображения

usage
object

Токен и стоимость использования запроса на создание изображения, если доступно

Example: