Skip to main content
POST
cURL
This is the core generation endpoint for the Grok Video API. For the complete endpoint directory, recommended workflow, and related capabilities, see the Grok Video API Overview.

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
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), supports multiple reference images (max 7)
  • 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']

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 June 18, 2026