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-edit

Модель редактирования изображений.

Доступные опции:
grok-imagine-1.0-edit,
grok-imagine-image,
grok-imagine-image-quality
refer_images
string[]

Список референсных изображений. В настоящее время поддерживается только одно изображение

Пример:
aspect_ratio
enum<string>

Соотношение сторон вывода; если не указано, определяется моделью. grok-imagine-1.0-edit поддерживает: 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
по умолчанию:2

Количество генерируемых изображений. Диапазон: от 1 до 4

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

Адрес обратного вызова. Уведомление отправляется при завершении или ошибке задачи. Структура уведомления совпадает со структурой получение результата [blocked]. Если параметр не указан, результат нужно получать через API получения результата [blocked]

Пример:

"https://example.com/callback"

Ответ

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

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

"SUCCESS"

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

"success"

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