Skip to main content
POST
cURL

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json
prompt
string
обязательно

Свободный промпт с описанием изображения. Без images создается новое изображение по промпту. С референсами укажите, что изменить, и называйте их по порядку: изображение 1, изображение 2. В конец промпта можно добавить рамки по сетке от 0 до 1000 в формате [top, left, bottom, right].

images

Необязательные референсы. Без них это генерация по тексту. С ними промпт редактирует деталь, меняет стиль или собирает референсы. Каждый элемент — http(s) URL или base64, всего от 1 до 10. Каждое изображение не меньше 256×256.

aspect_ratio
enum<string>
по умолчанию:auto

Соотношение сторон результата. При auto приоритет у соотношения, названного в промпте; иначе сохраняются пропорции первого референса. Без референсов решает промпт, а если соотношение все еще неясно — 1:1. Для генерации по тексту лучше задать соотношение явно.

Доступные опции:
auto,
21:9,
2:1,
16:9,
3:2,
7:5,
4:3,
5:4,
1:1,
4:5,
3:4,
5:7,
2:3,
9:16,
1:2,
9:21
resolution
enum<string>
по умолчанию:1k

Ступень разрешения по близкой площади в пикселях. Точные ширина и высота зависят от соотношения сторон.

Доступные опции:
768sq,
1k,
1.5k,
2k,
4k
safety_tolerance
integer
по умолчанию:2

Допуск модерации от 0 до 7, где 0 — самый строгий. По умолчанию 2. Маршрут и организация задают допустимый максимум и потолок для каждой категории.

Требуемый диапазон: 0 <= x <= 7
grounding
boolean
по умолчанию:true

При true (по умолчанию) промпт может сверяться с поиском в вебе и по изображениям. При false поиск выключен, генерация обычно быстрее и использует только промпт.

webhook_url
string

Адрес асинхронного колбэка. Первичный ответ возвращает jobId. Итоговый результат можно получить по этому адресу или через запрос результата Flux.

Ответ

Запрос выполнен успешно

status
string
обязательно
Пример:

"SUCCESS"

message
string
обязательно
Пример:

"success"

data
object
обязательно
Пример:
Последнее изменение 16 октября 2026 г.