Перейти к основному содержанию
POST
/
grok
/
generations
cURL
curl --request POST \
  --url https://api.ttapi.io/grok/generations \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "prompt": "<string>",
  "aspect_ratio": "16:9",
  "video_length": "10",
  "resolution_name": "720p",
  "refer_images": [
    "<string>"
  ],
  "hook_url": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}
Начните с этой страницы, если вам нужен основной endpoint генерации в Grok video API. Полный список endpoints, рекомендации по workflow и связанные ссылки см. в обзоре Grok video API.

Авторизации

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

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

Тело

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

Промпт

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

Соотношение сторон видео

Доступные опции:
2:3,
3:2,
1:1,
9:16,
16:9
video_length
string
по умолчанию:10

Длительность видео в диапазоне от 10 до 30 секунд

resolution_name
string
по умолчанию:720p

Разрешение вывода, сейчас поддерживается только 720p

refer_images
string[]

Reference image URL['https://cdn.ttapi.io/other/2026-03-13/a86ca2c7-6333-4840-b337-395a5d02a182.png','https://cdn.ttapi.io/other/2026-03-13/64a858ed-6095-45ce-92d5-b515c9864703.png']

hook_url
string

Callback URL address. When the task completes or fails, notifications will be sent to this address. The notification data structure is consistent with the fetch structure. If not set, you need to call the fetch interface to query the result

Пример:

"https://example.com/callback"

Ответ

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

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

"SUCCESS"

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

"success"

data
object
обязательно
Пример:
{ "job_id": "job_id" }
Last modified on March 26, 2026