Grok Video
Create Grok Video
Create asynchronous videos with text, first and last frames, keyframes or reference images using grok-imagine-video-1.5.
/v1/videosParameters
| Parameter | Type / location | Description |
|---|---|---|
modelRequired | stringbody | Use grok-imagine-video-1.5; your key must have model access. |
promptRequired | stringbody | Non-empty prompt required in every mode, including image inputs. |
durationOptional | integerbody | 1–15 seconds; default 8. |
secondsOptional | integerbody | Compatibility alias for duration. Prefer duration; do not send conflicting values. |
resolutionOptional | stringbody | 480p (default), 720p or 1080p. Reference images, last frames and keyframes are limited to 720p. |
aspect_ratioOptional | stringbody | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 or 5:2. |
generate_audioOptional | booleanbody | false disables audio. Omission uses the upstream default. |
imageOptional | objectbody | First frame: {url: "https://..."}. Public HTTP(S) or complete image data URL; file_id is not supported. |
last_frameOptional | objectbody | Last frame: {url: "https://..."}; combine with image to lock both ends. |
keyframesOptional | arraybody | 1–4 items: {image: {url}, timestamp_s}. Times must be strictly between 0 and duration and in distinct 1/3-second slots. |
reference_imagesOptional | arraybody | 1–14 {url: "https://..."} objects. Visual guidance, not exact locked frames. |
Request examples
curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat floats on a calm lake. Locked camera, soft daylight.",
"duration": 3,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": false
}'curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat floats on a calm lake. Locked camera, soft daylight.",
"duration": 3,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": false,
"image": {
"url": "https://example.com/start.jpg"
}
}'curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat floats on a calm lake. Locked camera, soft daylight.",
"duration": 3,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": false,
"last_frame": {
"url": "https://example.com/end.jpg"
}
}'curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat floats on a calm lake. Locked camera, soft daylight.",
"duration": 3,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": false,
"image": {
"url": "https://example.com/start.jpg"
},
"last_frame": {
"url": "https://example.com/end.jpg"
}
}'curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat floats on a calm lake. Locked camera, soft daylight.",
"duration": 3,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": false,
"image": {
"url": "https://example.com/start.jpg"
},
"keyframes": [
{
"image": {
"url": "https://example.com/middle.jpg"
},
"timestamp_s": 1
}
],
"last_frame": {
"url": "https://example.com/end.jpg"
}
}'curl --request POST \
--url 'https://api.juhenextvip.com/v1/videos' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "grok-imagine-video-1.5",
"prompt": "A paper boat floats on a calm lake. Locked camera, soft daylight.",
"duration": 3,
"resolution": "480p",
"aspect_ratio": "16:9",
"generate_audio": false,
"reference_images": [
{
"url": "https://example.com/character.jpg"
},
{
"url": "https://example.com/style.jpg"
}
]
}'Response examples
{
"id": "task_example",
"object": "video",
"model": "grok-imagine-video-1.5",
"status": "queued",
"progress": 0
}Usage notes
- Replace example.com image URLs with publicly accessible images. Examples are request templates.
- Save the returned id exactly and query its status. Do not submit another creation request to check progress.
- This channel supports Grok 1.5 generation, not video editing, extension, audio references, storage_options or custom output uploads.