Skip to main content
POST
/
generation
/
xai
/
grok-imagine-video
Grok Imagine Video
curl --request POST \
  --url https://open.skills.video/api/v1/generation/xai/grok-imagine-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "feature": "<string>",
  "prompt": "<string>",
  "video_url": "<string>"
}
'
{
  "id": "gen_123",
  "status": "IN_QUEUE",
  "input": {
    "prompt": "a cat walking through neon rain",
    "duration": 5,
    "aspect_ratio": "16:9",
    "n": 1
  },
  "usage": {
    "total": 20,
    "subscription": 20,
    "permanent": 0
  }
}
Unified Grok Imagine workflow for text/image generation, video extension, and video editing.

Authorizations

Authorization
string
header
required

API Key for API endpoints

Body

feature
string
required

Workflow type: text/image-to-video, extend-video, or edit-video.

Allowed value: "text-image"
prompt
string
required

Prompt text for generation, continuation, or editing.

image_url
string<uri>

Optional image URL used in text-image mode.

video_url
string<uri>

Source video URL for extend-video and edit-video modes.

duration
integer
default:6

Output duration in seconds.

Required range: 1 <= x <= 15
resolution
enum<string>
default:720p

Output resolution. text-image supports 480p/720p; edit-video also supports auto.

Available options:
720p,
480p
aspect_ratio
enum<string>
default:16:9

Aspect ratio for text-image generation.

Available options:
16:9,
9:16,
1:1,
3:4,
4:3,
2:3,
3:2
n
integer
default:1
Required range: 1 <= x <= 4
{key}
any

Response

Generation submission accepted

id
string
required

Generation id.

status
enum<string>
required

Queue status

Available options:
IN_QUEUE,
IN_PROGRESS,
COMPLETED,
FAILED,
CANCELED
input
Text/Image · object
required

Normalized input payload for the generation task.

usage
object
required

Credit usage breakdown for the request

code
string

Machine-readable generation error code. Present when status is FAILED.

message
string

Sanitized human-readable failure message. Present when status is FAILED.