curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video-1.5-preview",
  "prompt": "A neon-lit street at night, slow dolly forward through the rain",
  "duration": 6,
  "quality": "480p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "grok-imagine-video-1.5-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 26.66,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: grok-imagine-video-1.5-preview",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Grok

Grok Imagine 1.5 Video Preview

Grok Imagine 1.5 (grok-imagine-video-1.5-preview) supports text-to-video, image-to-video and reference-to-video under one model name
There is no mode parameter: the number of entries in image_urls selects the mode — 0 = text-to-video, 1 = image-to-video (used as the first frame), 2-7 = reference-to-video
Asynchronous processing mode, use the returned task ID to query
Generated video links are valid for 24 hours, please save them promptly

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-video-1.5-preview",
  "prompt": "A neon-lit street at night, slow dolly forward through the rain",
  "duration": 6,
  "quality": "480p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "grok-imagine-video-1.5-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 120
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 26.66,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: grok-imagine-video-1.5-preview",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:grok-imagine-video-1.5-preview

required

Model name

Available options:

grok-imagine-video-1.5-preview

Example:

"grok-imagine-video-1.5-preview"

prompt

string

required

Video description prompt (required, cannot be empty)

Length limit: Up to 4096 characters

Example:

"The person starts dancing"

image_urls

string<uri>[]

Input image URLs (optional). The number of images selects the generation mode.

Mode selection:

0 images (omit the field): text-to-video, no image charge
1 image: image-to-video, used as the first frame
2-7 images: reference-to-video, blended together

Requirements:

Up to 7 images; 8 or more are rejected
Image size: max 10MB each
Supported formats: JPEG, PNG, WebP

Maximum array length: 7

Example:

["https://example.com/image.jpg"]

duration

integer

default:6

Video duration (seconds), any integer between 1 and 15 seconds

Required range: 1 <= x <= 15

Example:

6

quality

enum<string>

default:480p

Video resolution, default is 480p

Description:

480p: Standard definition (default)
720p: High definition
1080p: Full HD

Reference-to-video (2-7 images) supports up to 720p. Sending 1080p together with 2 or more images is rejected. 1080p remains available for text-to-video and single-image image-to-video.

Available options:

480p,

720p,

1080p

Example:

"480p"

aspect_ratio

enum<string>

default:auto

Output aspect ratio, default is auto

Applies to: text-to-video (0 images) and reference-to-video (2-7 images). With a single input image the output follows that image's dimensions and this parameter is ignored.

Description:

auto: The model decides the framing, which can differ between runs; this is the default value
16:9: Landscape
9:16: Portrait
1:1: Square
3:2: Landscape, classic photo ratio
2:3: Portrait, classic photo ratio

Available options:

auto,

16:9,

9:16,

1:1,

3:2,

2:3

Example:

"16:9"

callback_url

string<uri>

HTTPS callback URL after task completion

Callback Timing:

Triggered when task is completed, failed, or cancelled
Sent after billing confirmation

Security Restrictions:

Only HTTPS protocol supported
Callback to internal IPs prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback Mechanism:

Timeout: 10 seconds
Max 3 retries on failure (after 1/2/4 seconds)
Response format matches task query API
2xx status code = success, others trigger retry

Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video task created successfully

created

integer

Task creation timestamp

Example:

1757169743

string

Task ID

Example:

"task-unified-1757169743-7cvnl5zw"

model

string

Actual model name used

Example:

"grok-imagine-video-1.5-preview"

object

enum<string>

Specific task type

Available options:

video.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Video task detailed information

Show child attributes

type

enum<string>

Task output type

Available options:

text,

image,

audio,

video

Example:

"video"

usage

object

Usage and billing information

Show child attributes

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Grok Imagine 1.5 Video Preview

Authorizations

Body

Response