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