Create Grok Imagine Video 1.5

POST

videos

curl --request POST \
  --url https://sigrunai.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "omni-10s",
  "prompt": "A golden retriever running across a sunny meadow, cinematic tracking shot",
  "aspect_ratio": "16:9"
}
'

{
  "code": 20000,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "cost": 123,
    "error_message": "<string>",
    "result": {
      "image_url": "<string>",
      "video_url": "<string>"
    }
  }
}

Create async Grok Imagine Video 1.5 jobs via the shared POST /v1/videos endpoint. Set model to one of the values below. On success you get a task_id; poll with Query video task and read result.video_url when completed.

Models

`model`	Capabilities	Duration	Resolution
`grok-imagine-video-1.5`	Text-to-video; first / first-last frames; up to 7 reference images	4–15 s	720p
`grok-imagine-video-1.5-fast`	Text-to-video; single first frame (up to 15s); multi-ref (max 10 s)	4–15 s (multi-ref ≤10s)	720p
`grok-imagine-video-1.5-lite`	Text-to-video; single first frame; no multi-ref or last frame	4–15 s	720p

Billing is per_task (flat per job; duration only controls clip length, not the multiplier). See the model catalog and the create response cost for live prices.

Modes

Mode	How to send
Text-to-video	Omit images, or pass an empty array
First / first-last frames	Send `first_image` (and optional `last_image`) with `first_last_frame: true`; or put first/last URLs in `images` with `first_last_frame: true`
Reference mode	Send `images` / `reference_images` without `first_last_frame` (or `false`)

Frames and reference images are mutually exclusive. Lite has no multi-ref or last frame; Fast has no last frame.

Request fields

Field	Type	Required	Description
`model`	string	yes	See table above
`prompt`	string	yes	Generation prompt, 1–5000 characters
`duration` / `seconds`	int \| string	yes	4–15; string form allowed (e.g. `"9"`)
`aspect_ratio` / `ratio`	string	no	`16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `21:9`; default `16:9`
`resolution`	string	no	Default `720p`
`images` / `reference_images`	string[]	no	Reference image URLs; Standard / Fast up to 7
`first_image`	string	conditional	First-frame URL
`last_image`	string	no	Last-frame URL (Standard only; requires first frame)
`first_last_frame`	boolean	no	`true` for first / first-last frame mode

Media URLs must be public https:// direct links.

Examples

Text-to-video

curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "A cinematic ad for a futuristic tech product",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 9
  }'

Standard first-last frames

curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Smooth, continuous transition between the two shots",
    "aspect_ratio": "21:9",
    "resolution": "720p",
    "duration": 9,
    "first_image": "https://example.com/first.webp",
    "last_image": "https://example.com/last.webp",
    "first_last_frame": true
  }'

Fast multi-reference

curl -X POST 'https://sigrunai.com/v1/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "grok-imagine-video-1.5-fast",
    "prompt": "Combine product and scene references into an ad",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 10,
    "images": [
      "https://example.com/product.png",
      "https://example.com/scene.png"
    ]
  }'

Success response example:

{
  "code": 20000,
  "msg": "submitted",
  "data": {
    "task_id": "vid_xxxxxxxx",
    "status": "queued",
    "progress": 0,
    "model": "grok-imagine-video-1.5",
    "cost": 0,
    "result": {}
  }
}

Polling

curl -X GET 'https://sigrunai.com/v1/videos/vid_xxxxxxxx' \
  -H 'Authorization: Bearer sk_xxx'

See Query video task for status fields. When completed, read data.result.video_url and download promptly.

Authorizations

Authorization

string

header

required

控制台创建的 API Key，格式：Bearer sk_xxx

Body

application/json

model

string

required

omni-10s, veo3.1-fast, veo3.1-lite, veo3.1-lite-hd, grok-imagine-video-1.5 (and fast/lite), minimax-h3, minimax-h3-max, kling-4.0 / kling-4.0-720p / kling-4.0-1080p, seedance2.0-md, sd2-480p-ac, sd2-720p-ac, seedance2.5-30s, or sd2.5-720p-ac

Example:

"omni-10s"

prompt

string

required

duration

omni-10s: fixed 10; seedance2.0-md: 5/10/15; sd2-*-ac: 4–15; seedance2.5-30s: fixed 30; sd2.5-720p-ac: 4–30

seconds

Alias of duration

aspect_ratio

string

ratio

string

Alias of aspect_ratio

orientation

string

portrait/landscape may imply aspect ratio

size

string

resolution

string

omni-10s is fixed at 720p

first_image

string<uri>

First-frame URL for omni-10s frame mode

last_image

string<uri>

Last-frame URL for omni-10s; use with first_image

images

string<uri>[]

reference_images

string<uri>[]

videos

string<uri>[]

reference_videos

string<uri>[]

reference_video_durations

integer[]

Required with reference videos for kling-4.0; same length as videos; seconds 1–30. Billable seconds = output duration + sum of these values.

Required range: 1 <= x <= 30

reference_audio_durations

integer[]

Required with reference audios for kling-4.0; same length as audios; seconds 5–30 (validation only, not billed).

Required range: 5 <= x <= 30

audios

string<uri>[]

reference_audios

string<uri>[]

Response

200 - application/json

Submitted

code

integer

Example:

20000

msg

string

data

object

Show child attributes

Last modified on October 19, 2026

⌘I

curl --request POST \
  --url https://sigrunai.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "omni-10s",
  "prompt": "A golden retriever running across a sunny meadow, cinematic tracking shot",
  "aspect_ratio": "16:9"
}
'

{
  "code": 20000,
  "msg": "<string>",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "progress": 123,
    "model": "<string>",
    "created_at": 123,
    "completed_at": 123,
    "cost": 123,
    "error_message": "<string>",
    "result": {
      "image_url": "<string>",
      "video_url": "<string>"
    }
  }
}

Gemini Omni

Veo 3.1

Grok Imagine Video

MiniMax H3

Kling 4.0

Seedance 2.0

Seedance 2.5

Create Grok Imagine Video 1.5

Models

Modes

Request fields

Examples

Text-to-video

Standard first-last frames

Fast multi-reference

Polling

Authorizations

Body

Response

​Models

​Modes

​Request fields

​Examples

​Text-to-video

​Standard first-last frames

​Fast multi-reference

​Polling

Authorizations

Body

Response

Models

Modes

Request fields

Examples

Text-to-video

Standard first-last frames

Fast multi-reference

Polling