Skip to main content
POST

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

Авторизация

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

Тело запроса

string
обязательно
Название модели
  • z-image-turbo — лёгкая и быстрая генерация изображений, поддерживает китайский и английский
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображения, до 800 символов
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
string
по умолчанию:"1K"
Уровень разрешения
  • 1K — стандартное разрешение (по умолчанию)
  • 2K — высокое разрешение
boolean
по умолчанию:"false"
Интеллектуальная переработка промптаПри включении ИИ автоматически оптимизирует промпт для получения лучших результатов, при этом стоимость увеличится.
  • false — отключено (по умолчанию)
  • true — включено

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

Размер вывода определяется комбинацией size (соотношение) + resolution (уровень разрешения).

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

Базовый text-to-image (минимальный запрос)
Указание соотношения и разрешения
Включение интеллектуальной переработки промпта

Ответ

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

Примечания

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