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. Первое изображение — редактируемая картинка, и оно задает размер результата по умолчанию.

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

Соотношение сторон результата. При auto референс использует точные пропорции первого изображения; без референса соотношение выбирается по промпту, иначе 16:9. Поле игнорируется, если заданы и width, и height.

Доступные опции:
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>

Ступень разрешения: 768sq, 1k, 1.5k, 2k или 4k. Для генерации по тексту без этого поля используется 1k. С референсом и без поля берется собственный размер первого изображения, а если задан aspect_ratio — ближайшая ступень. Поле игнорируется, если заданы и width, и height.

Доступные опции:
768sq,
1k,
1.5k,
2k,
4k
width
integer

Ширина результата в пикселях, от 64 до 6256. Передается вместе с height и перекрывает aspect_ratio и resolution. Произведение ширины и высоты не больше 16822272 пикселей.

Требуемый диапазон: 64 <= x <= 6256
height
integer

Высота результата в пикселях, от 64 до 6256. Передается вместе с width. Произведение ширины и высоты не больше 16822272 пикселей.

Требуемый диапазон: 64 <= x <= 6256
seed
integer

Seed для повторения результата. Если опущен, выбирается случайно. Диапазон: от 0 до 4294967295.

Требуемый диапазон: 0 <= x <= 4294967295
safety_tolerance
integer
по умолчанию:2

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

Требуемый диапазон: 0 <= x <= 7
output_format
enum<string>
по умолчанию:jpeg

Формат выходного изображения.

Доступные опции:
jpeg,
png
steps
integer
по умолчанию:16

Число шагов шумоподавления. По умолчанию 16. Диапазон: от 1 до 16.

Требуемый диапазон: 1 <= x <= 16
webhook_url
string

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

Ответ

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

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

"SUCCESS"

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

"success"

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