Skip to main content
POST
/
api
/
open-api
/
v1
/
grok
/
videos
Create Grok 1.5 Video
curl --request POST \
  --url https://www.jimmyai.cn/api/open-api/v1/grok/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video-1.5",
  "prompt": "A beautiful butterfly flying among flowers, slow motion, hyper-detailed",
  "duration": 10,
  "ratio": "16:9",
  "image_urls": [
    "https://example.com/butterfly.jpg"
  ]
}
'
{
  "code": "20000",
  "msg": "ok",
  "data": {
    "task_id": "<string>",
    "status": "<string>",
    "model": "<string>",
    "created_at": 123
  }
}
After creation, the response returns a task_id. Use the Query Video Task endpoint to poll task status and read the final video URL from result.video_url.

​
Supported models

modelNotes
grok-imagine-video-1.5Grok 1.5 Video Model, supporting 10 or 15 seconds with custom aspect ratios. Requires exactly 1 reference image.
Aliases such as grok-1.5 and grok_1_5 normalize to grok-imagine-video-1.5.

​
Parameter Constraints

  • Reference Image: grok-imagine-video-1.5 must be used with a reference image. Upload exactly 1 image in the image_urls (or images) field.
  • Duration: Only supports 10 or 15 seconds (defaults to 10).
  • Aspect Ratio: Supports 16:9, 9:16, 1:1, 3:2, 2:3 (defaults to 16:9).

​
Example Request

curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/grok/videos' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Hot tea slowly poured into a beautiful teacup, rising steam, macro photography",
    "ratio": "16:9",
    "duration": 10,
    "image_urls": ["https://example.com/cup.jpg"]
  }'

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
model
enum<string>
required

Model name. grok-imagine-video-1.5, grok-1.5, and grok_1_5 normalize to grok-imagine-video-1.5.

Available options:
grok-imagine-video-1.5
​
prompt
string
required

Text prompt for video generation

​
image_urls
string[]
required

Reference image URL list. grok-imagine-video-1.5 requires exactly 1 reference image.

​
duration
enum<integer>
default:10

Video duration in seconds. Only supports 10 or 15 seconds. Defaults to 10.

Available options:
10,
15
​
ratio
enum<string>
default:16:9

Video aspect ratio (e.g., 16:9, 9:16). Takes precedence over orientation.

Available options:
16:9,
9:16,
1:1,
3:2,
2:3
​
orientation
enum<string>

Video orientation. Active only when ratio is empty: landscape maps to 16:9, portrait maps to 9:16.

Available options:
landscape,
portrait
​
images
string[]

Compatibility field for common OpenAPI image inputs; used when image_urls is empty. Requires exactly 1 image.

Response

200 - application/json

Task created successfully

​
code
string
Example:

"20000"

​
msg
string
Example:

"ok"

​
data
object