Перейти к основному содержанию
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": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

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

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": "z-image-turbo",
    "prompt": "Ink painting style landscape scenery"
  }'

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

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

МодельОписаниеИзображений за запросЦена
z-image-turboЛёгкая и быстрая генерация изображений, поддерживает китайский и английскийФиксировано 1 изображениеФиксированная цена

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

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

​
Тело запроса

​
model
string
обязательно
Название модели
  • z-image-turbo — лёгкая и быстрая генерация изображений, поддерживает китайский и английский
​
prompt
string
обязательно
Текстовое описание для генерации изображения, до 800 символов
​
size
string
по умолчанию:"1:1"
Соотношение сторон изображенияПоддерживаемые соотношения сторон:
  • 1:1 — квадрат (по умолчанию)
  • 4:3 — горизонтальный 4:3
  • 3:4 — вертикальный 3:4
  • 16:9 — горизонтальный широкоформатный
  • 9:16 — вертикальный
  • 3:2 — горизонтальный 3:2
  • 2:3 — вертикальный 2:3
​
resolution
string
по умолчанию:"1K"
Уровень разрешения
  • 1K — стандартное разрешение (по умолчанию)
  • 2K — высокое разрешение
​
prompt_extend
boolean
по умолчанию:"false"
Интеллектуальная переработка промптаПри включении ИИ автоматически оптимизирует промпт для получения лучших результатов, при этом стоимость увеличится.
  • false — отключено (по умолчанию)
  • true — включено

​
Справочная таблица разрешений

Размер вывода определяется комбинацией size (соотношение) + resolution (уровень разрешения).
СоотношениеУровень 1KУровень 2K
1:11024×10242048×2048
4:31152×8642048×1536
3:4864×11521536×2048
16:91280×7202048×1152
9:16720×12801152×2048
3:21248×8322048×1360
2:3832×12481360×2048

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

Базовый text-to-image (минимальный запрос) 
{
  "model": "z-image-turbo",
  "prompt": "Ink painting style landscape scenery"
}
Указание соотношения и разрешения 
{
  "model": "z-image-turbo",
  "prompt": "Minimalist style cafe interior design",
  "size": "16:9",
  "resolution": "2K"
}
Включение интеллектуальной переработки промпта 
{
  "model": "z-image-turbo",
  "prompt": "A cat",
  "prompt_extend": true
}

​
Ответ

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

​
Примечания

  1. Асинхронная обработка: после отправки возвращается task_id. Опрашивайте /v1/tasks/{task_id} для получения результатов
  2. Хранение изображений: сгенерированные изображения зеркалируются на CDN платформы и действительны длительное время
  3. Правила тарификации: тарификация за каждое успешно сгенерированное изображение, неудачные не оплачиваются
  4. Фиксированное количество: Z-Image-Turbo генерирует ровно 1 изображение за запрос, параметр n не поддерживается