Skip to main content
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": [
    "2:3",
    "3:2",
    "1:1",
    "9:16",
    "16:9"
  ],
  "video_length": "10",
  "resolution_name": "720p",
  "refer_image": "<string>",
  "hook_url": "https://example.com/callback"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
prompt
string
required

Prompt

​
aspect_ratio
string
default:16:9

Video aspect ratio

Example:
["2:3", "3:2", "1:1", "9:16", "16:9"]
​
video_length
string
default:10

Video duration with range from 10 to 30 seconds

​
resolution_name
integer
default:720p

Output resolution, currently only supports 720p

​
refer_image
string

Reference image URL
Note: Reference image aspect ratio should match video aspect ratio

​
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

Example:

"https://example.com/callback"

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{ "job_id": "job_id" }
Last modified on March 13, 2026