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:

  • grok-imagine-1.0
  • grok-imagine-2.0

Серия Grok Image:

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

Поддерживается только моделями grok-imagine-1.0 и grok-imagine-2.0; для grok-imagine-2.0 допускается только true. Другие модели не поддерживают этот параметр.

quality
enum<string>

Качество изображения. Поддерживается только моделью grok-imagine-image-2.0.

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

Разрешение вывода. Серия Grok Image (grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0) поддерживает 1k и 2k.

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