Skip to main content
POST
cURL
This is the Grok Video API first frame to video endpoint. Specify the first frame of the video using first_frame. Only supported by grok-imagine-video-1.5-fast.
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

First frame to video request parameters

prompt
string
required

Prompt. Supports longer text input.

first_frame
string
required

First frame image URL. Only supported by grok-imagine-video-1.5-fast. Used to strictly specify the first frame of the video.

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

Model name. Only grok-imagine-video-1.5-fast is supported: 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.

Available options:
grok-imagine-video-1.5-fast
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. Range: 6 to 30, where 6s and 10s are standard durations.

resolution_name
enum<string>
default:720p

Output resolution. Available options: 480p, 720p.

Available options:
480p,
720p,
1080p
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