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

Генерация изображений по текстовому запросу.

POST/v1/images/generations

Генерация изображений по текстовому запросу.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Используйте API Key платформы в формате Authorization: Bearer your-api-key.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

model*string

ID модели платформы.

prompt*string

Запрос на генерацию или редактирование; длина считается в символах Unicode без начальных и конечных пробелов; строка не может состоять только из пробелов.

Длина1 <= length <= 32000

n?integer

Количество создаваемых изображений.

Диапазон1 <= value <= 10

По умолчанию1

size?string

auto или WIDTHxHEIGHT, по умолчанию auto. Заданная площадь: 655,360–20,000,000 пикселей; соотношение сторон: 1:3–3:1. При заданных размерах не передавайте aspect_ratio и area.

По умолчанию"auto"

aspect_ratio?string

По умолчанию auto; определяется улучшенным запросом, а при редактировании также референсами. Допустимо X:Y, где X и Y — целые числа 1–300, соотношение 1:3–3:1. Только если size не задан или равен auto.

area?string

Уровень площади, по умолчанию 4K. Только если size не задан или равен auto; фактические размеры в data[].size.

Допустимые значения

"1K"
"2K"
"4K"

output_format?string

Формат изображения. jpg и jpeg равнозначны; в ответе используется jpeg.

По умолчанию"jpeg"

Допустимые значения

"jpeg"
"jpg"
"png"
"webp"

response_format?string

Ссылки url действуют 24 часа; b64_json возвращает Base64 без потоковой передачи. Общая выходная площадь Base64 ограничена 20,000,000 пикселей для PNG и 80,000,000 для JPEG/WebP по всем изображениям.

По умолчанию"url"

Допустимые значения

"url"
"b64_json"

output_compression?integer

Качество сжатия JPEG/WebP; чем выше значение, тем больше файл. Для PNG игнорируется.

Диапазон0 <= value <= 100

По умолчанию95

stream?boolean

Возвращать результаты по изображениям через SSE; поддерживается только response_format со значением url.

По умолчаниюfalse

aigc_watermark?boolean

Добавлять видимый водяной знак AIGC; не влияет на скрытый идентификатор в метаданных файла.

По умолчаниюfalse

disable_prompt_enhanced?boolean

Отключить улучшение запроса. Тогда действуют лишь примерно первые 4,096 Token; необходимо задать конкретный size или фиксированный aspect_ratio.

По умолчаниюfalse

Тело ответа

`application/json`

type*string

created?integer

Метка времени Unix события.

model?string

ID фактически использованной модели.

image_index*integer

Индекс изображения, начиная с 0.

Диапазон0 <= value

url*string

Временная ссылка на созданное изображение.

size?string

Фактические WIDTHxHEIGHT изображения.

output_format?string

Фактический формат вывода.

Допустимые значения

"jpeg"
"png"
"webp"

revised_prompt?string

Запрос, использованный для этого изображения.

curl -X POST "https://example.com/v1/images/generations" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "prompt": "Создай фотографию зелёной настольной лампы на деревянном столе на фоне светлой стены с мягким естественным освещением.",
    "size": "2048x2048",
    "n": 1,
    "response_format": "url"
  }'

{
  "created": 1794355200,
  "data": [
    {
      "url": "https://example.com/lamp-result.jpg",
      "size": "2048x2048",
      "revised_prompt": "Зелёная настольная лампа стоит на деревянном столе перед светлой стеной; мягкий естественный свет освещает абажур и столешницу."
    }
  ],
  "output_format": "jpeg",
  "request_id": "REQUEST_ID"
}

Рекомендуемый тайм-аут клиента — не менее 600 секунд. После тайм-аута или разрыва соединения генерация может продолжиться; повторная отправка создаёт новый запрос.

API генерации изображений MiniMaxПараметры запроса и структура ответа.

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

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

402application/json

422application/json

429application/json

События потокового ответа

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`