Перейти к основному содержанию
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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.ttapi.io/llms.txt

Use this file to discover all available pages before exploring further.

Начните с этой страницы, если вам нужен основной 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 [blocked]. If not set, you need to call the fetch interface [blocked] 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