Перейти к основному содержанию
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

​
Поддерживаемые модели

МодельОписаниеРежимыImage-to-ImageМакс. изображенийБиллинг
gpt-image-1-officialСтабильность в приоритете, подходит для общей генерации изображенийText-to-Image / Image-to-ImageПоддерживается4Size × Quality
gpt-image-1.5-officialНовая версия, подходит для более качественной и сложной обработкиText-to-Image / Image-to-ImageПоддерживается4Size × Quality

​
Авторизация

​
Authorization
string
обязательно
Все запросы к API требуют аутентификации Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить ваш API-ключДобавьте следующее в заголовки запроса:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
обязательно
Название модели
  • gpt-image-1-official — Стабильность в приоритете, подходит для общей генерации изображений
  • gpt-image-1.5-official — Новая версия, подходит для более качественной и сложной обработки
​
prompt
string
обязательно
Текстовое описание для генерации изображения, поддерживает как китайский, так и английский
​
size
string
по умолчанию:"1:1"
Соотношение сторонПоддерживаемые соотношения:
  • 1:1 — Квадрат (по умолчанию)
  • 3:2 — Горизонтальное
  • 2:3 — Вертикальное
​
n
integer
по умолчанию:"1"
Количество генерируемых изображенийДиапазон: 1–4
  • Значения ≤ 0 будут интерпретироваться как 1
  • Значения > 4 будут интерпретироваться как 4
Внимание: Должно быть обычным числом (например, 1), без кавычек, иначе возникнет ошибка
​
quality
string
по умолчанию:"auto"
Качество изображения
  • auto — Автоматический выбор качества (по умолчанию)
  • low — Быстрее, экономичнее
  • medium — Баланс между качеством и стоимостью
  • high — Более высокое качество, более высокая стоимость
​
background
string
по умолчанию:"auto"
Режим фона
  • auto — Автоматический фон (по умолчанию)
  • opaque — Непрозрачный фон
  • transparent — Прозрачный фон, рекомендуется с выходным форматом png
background: transparent нельзя использовать одновременно с output_format: jpeg
​
moderation
string
по умолчанию:"auto"
Уровень модерации
  • auto — Уровень модерации по умолчанию
  • low — Более мягкая модерация
​
output_format
string
по умолчанию:"png"
Выходной формат
  • png — Формат по умолчанию, подходит для прозрачных фонов
  • jpeg — Меньший размер файла, подходит для обычного вывода изображений
background: transparent нельзя использовать одновременно с output_format: jpeg
​
output_compression
integer
Уровень сжатия вывода, диапазон 0–100
  • Рекомендуется только для jpeg
  • Не рекомендуется для png
​
image_urls
array
Массив URL эталонных изображений, при наличии включает режим image-to-imageЛимит: До 15 эталонных изображений
​
mask_url
string
URL маски для inpainting
  • Должен использоваться вместе с image_urls
  • Будет отправлен через официальный API редактирования
  1. Перед загрузкой маски убедитесь, что у изображения включён альфа-канал.
  2. Размер маски должен совпадать с размером первого эталонного изображения.

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

Соотношения сторон используются внешне; система автоматически сопоставляет их с официальными размерами внутри.
СоотношениеФактический размерОписание
1:11024x1024Квадрат
2:31024x1536Вертикальное
3:21536x1024Горизонтальное

​
Примеры использования

Text-to-Image (минимальный) 
{
  "model": "gpt-image-1-official",
  "prompt": "An ancient castle under a starry sky"
}
Text-to-Image (полный набор параметров) 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Image-to-Image (одна ссылка) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Convert the reference image to illustration style, preserving the main outline",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
Image-to-Image (объединение нескольких ссылок) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Merge two reference images into an illustration poster, preserving the main outlines",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Несколько изображений (n > 1) 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

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

​
Примечания

  1. Асинхронная обработка: После отправки возвращается task_id. Опрашивайте /v1/tasks/{task_id}, чтобы получить результаты
  2. Выбор модели: используйте gpt-image-1-official для общей генерации изображений; используйте gpt-image-1.5-official для высококачественного редактирования и сложных задач image-to-image
  3. Требования к URL изображений: для image-to-image используйте публично доступные и стабильные URL
  4. Биллинг: оплата за каждое успешно сгенерированное изображение; за неудачные не взимается