Grok Video

Create Grok Video

Create asynchronous videos with text, first and last frames, keyframes or reference images using grok-imagine-video-1.5.

POST/v1/videos

Parameters

ParameterType / locationDescription
modelRequiredstringbody

Use grok-imagine-video-1.5; your key must have model access.

promptRequiredstringbody

Non-empty prompt required in every mode, including image inputs.

durationOptionalintegerbody

1–15 seconds; default 8.

secondsOptionalintegerbody

Compatibility alias for duration. Prefer duration; do not send conflicting values.

resolutionOptionalstringbody

480p (default), 720p or 1080p. Reference images, last frames and keyframes are limited to 720p.

aspect_ratioOptionalstringbody

1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 or 5:2.

generate_audioOptionalbooleanbody

false disables audio. Omission uses the upstream default.

imageOptionalobjectbody

First frame: {url: "https://..."}. Public HTTP(S) or complete image data URL; file_id is not supported.

last_frameOptionalobjectbody

Last frame: {url: "https://..."}; combine with image to lock both ends.

keyframesOptionalarraybody

1–4 items: {image: {url}, timestamp_s}. Times must be strictly between 0 and duration and in distinct 1/3-second slots.

reference_imagesOptionalarraybody

1–14 {url: "https://..."} objects. Visual guidance, not exact locked frames.

Request examples

cURL
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
}'

Response examples

JSON
{
  "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.