Skip to main content
POST
cURL
Это основной эндпоинт генерации в API изображений Grok

Авторизации

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

Перейдите в консоль TTAPI, чтобы получить API-ключ.

Тело

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

Промпт

model
enum<string>
по умолчанию:grok-imagine-1.0

Модель генерации изображений.

Доступные опции:
grok-imagine-1.0,
grok-imagine-image,
grok-imagine-image-quality
enable_pro
boolean
по умолчанию:true

По умолчанию true — режим качества, false — режим скорости

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

Соотношение сторон изображения. grok-imagine-1.0 поддерживает: 1:1 (социальные сети, аватары, миниатюры), 16:9 (ландшафтные изображения, обложки, фоны рабочего стола), 9:16 (портретный режим телефона, обложки коротких видео, Stories), 3:2 (ландшафтная фотография), 2:3 (портретная фотография, постеры). grok-imagine-image и grok-imagine-image-quality дополнительно поддерживают: 4:3 (презентации, традиционный ландшафт), 3:4 (портреты, вертикальный дизайн), 2:1 (горизонтальные баннеры, заголовки), 1:2 (вертикальные баннеры, длинные изображения), 19.5:9 (горизонтальные экраны смартфонов), 9:19.5 (вертикальные обои смартфонов), 20:9 (горизонтальные ультраширокие экраны), 9:20 (вертикальные ультраширокие экраны), auto (модель автоматически выбирает соотношение на основе запроса).

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

Разрешение вывода. 1k — стандартное (все модели); 2k — повышенное (только grok-imagine-image и grok-imagine-image-quality).

Доступные опции:
1k,
2k
n
integer
по умолчанию:1

Количество сгенерированных изображений (1–4)

hook_url
string

Обратный вызов URL. Уведомления будут отправляться на этот адрес, когда задача выполнена или не выполнена, а структура данных уведомления соответствует структуре получение результата [blocked]. Если этот параметр не установлен, вам необходимо запросить интерфейс получение результата [blocked] для запроса результата.

Пример:

"https://example.com/callback"

Ответ

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

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

"SUCCESS"

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

"success"

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