Skip to main content
POST
cURL
This is the Grok Video API reference to video endpoint. Use refer_images for reference images or reference_audios for voice characters, combined with prompt to generate videos.
Warning: NSFW content is not allowed. A single or occasional moderation failure will not incur any charges. However, repeated moderation failures may result in charges.

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json

Reference to video request parameters

prompt
string
required

Prompt. Maximum length is 4096 characters for grok-imagine-video and grok-imagine-video-1.5; grok-imagine-video-1.5-fast supports longer prompts.

model
enum<string>
default:grok-imagine-video-1.5-fast

Model name.

  • grok-imagine-video-1.5-fast: duration 6-30s (6s and 10s are standard durations; 7s and 11s are not supported); supports multiple reference images (max 7); supports first/last frame control
  • grok-imagine-video: duration 1-15s, supports multiple reference images (single image up to 15s, multiple images max 10s), 720P only
  • grok-imagine-video-1.5: duration 1-15s, only single reference image and it is required
Available options:
grok-imagine-video-1.5-fast,
grok-imagine-video,
grok-imagine-video-1.5
Example:

"grok-imagine-video-1.5-fast"

aspect_ratio
enum<string>
default:16:9

Video aspect ratio

Available options:
2:3,
3:2,
1:1,
9:16,
16:9
video_length
string
default:10

Video duration in seconds. grok-imagine-video-1.5-fast range: 6 to 30 (6s and 10s are standard durations); grok-imagine-video range: 1 to 15 (single image up to 15s, multiple images max 10s); grok-imagine-video-1.5 range: 1 to 15.

resolution_name
enum<string>
default:720p

Output resolution. 480p and 720p are supported by all models; 1080p is only supported by grok-imagine-video-1.5.

Available options:
480p,
720p,
1080p
refer_images
string[]

Reference image URLs. grok-imagine-video-1.5-fast supports multiple images (max 7); grok-imagine-video supports multiple images (single image up to 15s, multiple images max 10s); grok-imagine-video-1.5 only supports a single image and it is required.
['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']

reference_audios
object[]

Array of voice characters, up to 3 entries. Example: [{"voice_id": "sirius"}]

Maximum array length: 3
Example:
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 endpoint [blocked] 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:
Last modified on September 9, 2026