Get API Key Get API
Docs

Grok Imagine 1.5 Video Generation

- Async processing mode, returns task ID for subsequent queries

  • High-quality AI video generation, supports text-to-video and image-to-video
  • Flexible aspect ratio and quality options for different creative needs
Info

Model name: Use grok-imagine-1.5-video-ext for this endpoint.

Request example

# Set model to "grok-imagine-1.5-video-ext"
curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-1.5-video-ext",
    "prompt": "A dog running on the beach, sunny weather, slow motion",
    "size": "16:9",
    "duration": 6,
    "resolution": "720p"
  }'

Response example

{
  "code": 200,
  "data": [
    {
      "task_id": "task_01JNXXXXXXXXXXXXXXXXXX",
      "status": "submitted"
    }
  ]
}

Authorizations

Authorization string

All APIs require Bearer Token authentication

Get API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Request Parameters

model string

Video generation model name

Supported models:

  • grok-imagine-1.5-video-ext - Grok Video Generation

Example: "grok-imagine-1.5-video-ext"

Note



Use grok-imagine-1.5-video-ext consistently in new requests.

nsfw_check boolean

Whether to run content moderation before submitting the video task.

  • true: use omni-moderation-latest to review prompts and input images
  • false or omitted: do not send a moderation request, adding no moderation cost or latency (default)
prompt string

Video content description, supports multiple languages

size string

Video size

Options:

  • 16:9 - Landscape (default)
  • 9:16 - Portrait
  • 1:1 - Square
  • 3:2 - Landscape
  • 2:3 - Portrait
duration integer

Video duration (seconds)

Range: 6-15 (minimum 6 seconds, maximum 15 seconds)

⚠️ Note: Must be a plain number (e.g. 6), do not add quotes, otherwise an error will occur

resolution string

Video quality

Options:

  • 480p - Standard definition (default)
  • 720p - High definition
image_urls string[]

List of reference image URLs

Limits:

  • Maximum 7 images
  • Must be publicly accessible URLs
  • Base64 format is not supported

Tip

After uploading a reference image, the aspect ratio will automatically match the reference image's aspect ratio.

Response

code integer

Response status code

data object[]
Response data array
task_id string

Unique task identifier

status string

Task status

  * submitted - Submitted
Note

Query Task Result

Video generation is an async task. After submission, a task_id will be returned. Use the Get Task Status endpoint to query generation progress and results.

Use Cases

Case 1: Text-to-Video

{
  "model": "grok-imagine-1.5-video-ext",
  "prompt": "A dog running on the beach, sunny weather, slow motion",
  "size": "16:9",
  "duration": 6
}

Case 2: Image-to-Video

{
  "model": "grok-imagine-1.5-video-ext",
  "prompt": "Bring the scene to life with natural dynamic effects",
  "image_urls": ["https://example.com/start.png"],
  "size": "16:9",
  "duration": 10,
  "resolution": "720p"
}

This documentation is built and hosted on Mintlify, a developer documentation platform.