Skip to main content
POST
  • Grok Video generation model
  • Select grok-video-1.0 model via the model parameter
  • Supports text-to-video and image-to-video
  • 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 이미지 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-video-1.0"
필수
Video generation model nameSupported models:
  • grok-video-1.0 - Grok video generation model
Example: "grok-video-1.0"
string
필수
Text description for video generation
integer
기본값:"8"
Video duration in secondsSupported range: 115 seconds
string
기본값:"720p"
Video resolutionSupported values: 480p, 720p
string
Video aspect ratioSupported formats:
  • 16:9 (landscape)
  • 9:16 (portrait)
  • 3:2 (landscape)
  • 2:3 (portrait)
  • 1:1 (square)
string
Optional main image URL. Only public http:// or https:// URLs are supported.
string[]
Array of reference image URLs for image-to-video generation⚠️ Only URL format is supported (base64 is no longer supported)
  • Publicly accessible image URLs (http:// or https://)
  • Up to 8 images total across image and reference_images
  • Use the Upload 이미지 API to upload local images and get URLs

응답

string
Unique task identifier for querying task status
string
Object type, always generation.task
string
모델 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