Skip to main content
POST
중국 본토 사용자 안내: 중국 본토 사용자는 https://toapis.cn 를 API 엔드포인트(Base URL)로 사용해 주세요. 본 문서의 예시에서 https://toapis.com 을 https://toapis.cn 로 바꿔 주세요.
  • Official-channel Grok Imagine Video 1.5 generation model
  • Select grok-imagine-video-1.5-official model via the model parameter
  • First-frame image-to-video only — exactly one input image is required
  • Up to 1080p output
  • Async task management, query results via task ID
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in reference_images. Please use the Upload Image API to upload images first, then call this API with the returned URL.

Authorizations

string
필수
All API requests require Bearer Token authenticationGet API Key: Visit the API Key Management Page to obtain your API KeyAdd to request headers:

Body

string
기본값:"grok-imagine-video-1.5-official"
필수
Video generation model nameSupported models:
  • grok-imagine-video-1.5-official - Official-channel Grok Imagine Video 1.5 model
Example: "grok-imagine-video-1.5-official"
string
필수
Text description for video generation
string
필수
First-frame image URL. Required — this model only supports image-to-video with exactly one input image. Only public http:// or https:// URLs are supported.
integer
기본값:"8"
Video duration in secondsSupported range: 1–15 seconds
string
기본값:"720p"
Video resolutionSupported values: 480p, 720p, 1080p
string
Video aspect ratioSupported formats:
  • 16:9 (landscape)
  • 9:16 (portrait)
  • 4:3 (landscape)
  • 3:4 (portrait)
  • 3:2 (landscape)
  • 2:3 (portrait)
  • 1:1 (square)
string[]
Array of additional reference image URLs⚠️ Only URL format is supported (base64 is no longer supported)
  • Publicly accessible image URLs (http:// or https://)
  • Up to 7 images total across image and reference_images
  • Use the Upload Image API to upload local images and get URLs
Pricing note: Output is billed per second by resolution tier. Each input image is billed per image — since this model requires exactly one first-frame image, every task includes one input-image charge. Video extension is not supported on this model.

Response

string
Unique task identifier for querying task status
string
Object type, always generation.task
string
Model name used
string
Task status
  • queued - Waiting to be processed
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task creation timestamp (Unix timestamp)
integer
Task progress, usually 0 after submission
object
Task metadata