> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apisale.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Grok Imagine Video v1.5 — Image To Video
> xAI Grok Imagine Video 1.5 — native audio, 480p/720p, up to 15s; T2V / I2V / Ref (fal). Optimized for image to video via apisale.
## Overview
xAI Grok Imagine Video 1.5 — native audio, 480p/720p, up to 15s; T2V / I2V / Ref (fal). Optimized for image to video via apisale.
**Docs** = API contract + Try it (snapshot). **[Explore](https://apisale.ai/explore)** = browser playground. **[Model page](https://apisale.ai/models/xai/grok-imagine-video/v1.5/image-to-video)** = product examples.
## Endpoint
```http theme={null}
POST https://api.apisale.ai/v1/run/xai/grok-imagine-video/v1.5/image-to-video
```
| | |
| -------------- | -------------------------------------------- |
| **Model slug** | `xai/grok-imagine-video/v1.5/image-to-video` |
| **Category** | Image to Video (`image-to-video`) |
| **Lab** | Xai |
| **Tier** | v1.5 |
| **Mode** | async |
## Pricing
**From \$0.056/sec**
apisale price is **30%** below the vendor's official list price.
| Tier | Unit | Official price | apisale price |
| ------------------------------------ | ------ | -------------- | ------------- |
| 2007de1f-d0af-4554-9223-93dd68e16e62 | second | \$0.080 | \$0.056 |
| 720p | second | \$0.140 | \$0.098 |
| 1080p | second | \$0.250 | \$0.175 |
**Official price** = vendor list price. **apisale price** = what you pay through apisale.
## Request
```json theme={null}
{
"input": {
"prompt": "Gentle cinematic camera push-in with subtle parallax, natural motion, preserve subject identity, smooth 24fps look",
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_url": "https://assets.apisale.ai/temp/2026/07/17/8a8c9839-8d93-4707-9f2c-402be2cbcc82.png"
}
}
```
### Parameters
Fields marked \* are required. Use `Authorization: Key YOUR_API_KEY` for REST.
Optional random seed for reproducibility.
Text prompt for video generation. Maximum 4000 characters.
Default: `6` Range: 1 – 15
Input image URL.
Default: `720p` Values: `480p`, `720p`, `1080p`
Default: `16:9` Values: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`
Optional HTTPS webhook when the run reaches a terminal state.
Block until completion (same Run response shape).
```json expandable theme={null}
{
"params": {
"seed": {
"type": "int",
"description": "Optional random seed for reproducibility."
},
"prompt": {
"type": "string",
"required": true,
"max_length": 4000,
"description": "Text prompt for video generation. Maximum 4000 characters."
},
"duration": {
"max": 15,
"min": 1,
"type": "int",
"default": 6
},
"image_url": {
"type": "media",
"required": true,
"description": "Input image URL."
},
"resolution": {
"type": "enum",
"values": [
"480p",
"720p",
"1080p"
],
"default": "720p"
},
"aspect_ratio": {
"type": "enum",
"values": [
"16:9",
"9:16",
"1:1",
"4:3",
"3:4"
],
"default": "16:9"
}
}
}
```
## Submit response
Returns a **Run** with `run_id`. Poll with [GET /v1/runs/\{run\_id}](/model-apis/poll-runs) or use **Try it** above.
Unique run ID — save for polling and webhooks.
`queued` (async) or terminal state for sync runs.
Result when `status` is `succeeded` — see **Output schema** below.
### Example (async submit)
```json theme={null}
{
"run_id": "run_550e8400-e29b-41d4-a716-446655440000",
"endpoint": "xai/grok-imagine-video/v1.5/image-to-video",
"model": "image-to-video",
"capability": "video",
"mode": "image-to-video",
"status": "queued",
"output": null,
"error": null,
"billing": null,
"created_at": "2026-06-27T12:00:00.000Z",
"started_at": null,
"completed_at": null,
"elapsed_ms": null
}
```
Full lifecycle: [Runs lifecycle](/model-apis/runs-lifecycle).
## Output
When `status` is `succeeded`, `output` follows this schema:
```json expandable theme={null}
{
"type": "object",
"example": {
"videos": [
{
"url": "https://cdn.example.com/tasks/0.mp4"
}
]
},
"required": [
"videos"
],
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
}
}
}
}
},
"description": "Succeeded task output: single video URL."
}
```
## Example
```bash theme={null}
curl -X POST "https://api.apisale.ai/v1/run/xai/grok-imagine-video/v1.5/image-to-video" \
-H "Authorization: Key YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "Gentle cinematic camera push-in with subtle parallax, natural motion, preserve subject identity, smooth 24fps look",
"duration": 4,
"resolution": "720p",
"aspect_ratio": "16:9",
"image_url": "https://assets.apisale.ai/temp/2026/07/17/8a8c9839-8d93-4707-9f2c-402be2cbcc82.png"
}
}'
```
## Related
* [Runs lifecycle](/model-apis/runs-lifecycle)
* [Video API overview](/api/video)
* [Account API](/get-started/account-and-monitoring)
## OpenAPI
````yaml openapi-catalog.json POST /v1/run/xai/grok-imagine-video/v1.5/image-to-video
openapi: 3.0.3
info:
title: apisale Model Catalog
version: '2026-09-01T09:47:50.773Z'
description: Per-model OpenAPI operations for Mintlify Try playground.
servers:
- url: https://api.apisale.ai
security: []
paths:
/v1/run/xai/grok-imagine-video/v1.5/image-to-video:
post:
tags:
- Model catalog
- video
- Xai
summary: Create Grok Imagine Video v1.5 — Image To Video
description: >-
xAI Grok Imagine Video 1.5 — native audio, 480p/720p, up to 15s; T2V /
I2V / Ref (fal). Optimized for image to video via apisale.
operationId: submit-xai-grok-imagine-video-v1-5-image-to-video
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- input
properties:
input:
type: object
properties:
seed:
description: Optional random seed for reproducibility.
type: number
prompt:
description: >-
Text prompt for video generation. Maximum 4000
characters.
type: string
duration:
type: number
minimum: 1
maximum: 15
default: 6
image_url:
description: Input image URL.
type: string
format: uri
resolution:
type: string
enum:
- 480p
- 720p
- 1080p
default: 720p
aspect_ratio:
type: string
enum:
- '16:9'
- '9:16'
- '1:1'
- '4:3'
- '3:4'
default: '16:9'
required:
- prompt
- image_url
example:
prompt: >-
Gentle cinematic camera push-in with subtle parallax,
natural motion, preserve subject identity, smooth 24fps
look
duration: 4
resolution: 720p
aspect_ratio: '16:9'
image_url: >-
https://assets.apisale.ai/temp/2026/07/17/8a8c9839-8d93-4707-9f2c-402be2cbcc82.png
webhook_url:
type: string
format: uri
sync:
type: boolean
default: false
example:
input:
prompt: >-
Gentle cinematic camera push-in with subtle parallax, natural
motion, preserve subject identity, smooth 24fps look
duration: 4
resolution: 720p
aspect_ratio: '16:9'
image_url: >-
https://assets.apisale.ai/temp/2026/07/17/8a8c9839-8d93-4707-9f2c-402be2cbcc82.png
responses:
'201':
description: Run accepted
content:
application/json:
schema:
$ref: '#/components/schemas/RunObject'
security:
- ApiKeyAuth: []
components:
schemas:
RunObject:
type: object
required:
- run_id
- endpoint
- model
- capability
- mode
- status
- created_at
properties:
run_id:
type: string
description: Unique run identifier
endpoint:
type: string
description: Model slug
model:
type: string
capability:
type: string
mode:
type: string
status:
type: string
enum:
- queued
- processing
- succeeded
- failed
- timeout
- cancelled
output:
type: object
nullable: true
error:
type: object
nullable: true
properties:
type:
type: string
description: Machine-readable error code
code:
type: number
description: HTTP status
message:
type: string
billing:
type: object
nullable: true
properties:
amount:
type: string
currency:
type: string
enum:
- usd
created_at:
type: string
format: date-time
started_at:
type: string
format: date-time
nullable: true
completed_at:
type: string
format: date-time
nullable: true
elapsed_ms:
type: number
nullable: true
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
description: Key sk-... (native REST) or Bearer sk-... (vendor SDKs)
````