Skip to main content
GET
/
grok
/
v1
/
videos
/
{request_id}
cURL
curl --request GET \
  --url https://api.ttapi.io/grok/v1/videos/{request_id} \
  --header 'TT-API-KEY: <api-key>'
{
  "status": "done",
  "video": {
    "url": "https://cdn.ttapi.io/video/xxx.mp4",
    "duration": 10,
    "respect_moderation": true
  },
  "model": "grok-imagine-video",
  "usage": {
    "cost_in_usd_tocks": 123
  },
  "progress": 100
}

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Path Parameters

​
request_id
string
required

Request ID returned from the video generation request

Response

Request successful

​
status
string

Video generation status: done-completed, processing-in progress, failed-failed

Example:

"done"

​
video
object

Video information

​
model
string

Model name used

Example:

"grok-imagine-video"

​
usage
object

Usage information

​
progress
number

Current task progress percentage (0-100), only valid when status is not done

Example:

100

Last modified on June 4, 2026