Generate Video-Official

curl --request POST \ --url https://api.ttapi.io/grok/v1/videos/generations \ --header 'Content-Type: application/json' \ --header 'TT-API-KEY: <api-key>' \ --data ' { "prompt": "<string>", "model": "grok-imagine-video-1.5-preview", "duration": 8, "image": { "url": "<string>" }, "reference_images": [ { "url": "<string>" } ] } '

Authorizations

TT-API-KEY

string

header

required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json

prompt

string

required

Video generation prompt. Required for grok-imagine-video text-to-video; optional for grok-imagine-video-1.5-preview.

model

enum<string>

default:grok-imagine-video-1.5-preview

Model name to use.

Available options:

grok-imagine-video,

grok-imagine-video-1.5-preview

Example:

"grok-imagine-video-1.5-preview"

aspect_ratio

enum<string>

Video aspect ratio.

Available options:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

duration

integer

default:8

Video duration in seconds. Range: [1, 15]. Default: 8. Accepts both number (8) and string ("8") formats.

Required range: 1 <= x <= 15

image

object

Image object used for image-to-video generation. Required for grok-imagine-video-1.5-preview (I2V only); optional for grok-imagine-video (T2V when omitted, I2V when provided).

Show child attributes

reference_images

object[]

Array of reference images used for reference-to-video (R2V). These images serve as style/content references for video generation.

Show child attributes

resolution

enum<string>

Video resolution.

Available options:

480p,

720p

Response

Request successful

request_id

string

required

Request ID

Example:

"41eb9a5f-cbd4-9f21-8d59-79005f1e61b7"