建立 xAI 影片
使用 CometAPI POST /grok/v1/videos/generations，根據輸入圖片與 prompt 建立 Grok 圖生影片任務，然後透過 request_id 輪詢結果。
request_id，因此請將其視為非同步工作流程的第一步。
從小型請求開始
- 使用
model: grok-imagine-video-1.5 - 將
image.url設為公開可存取的 JPEG、PNG 或 WebP URL - 對於第一次請求，請將
duration保持為1，並將resolution保持為720p - 讓
prompt保持明確，讓動畫方向清楚 - 如果你傳送 base64，請將文件與 OpenAPI 範例格式保留為
data:image/png;base64,<BASE64_IMAGE_DATA>
Duration 和 resolution
任務流程
建立任務
request_id。輪詢完成狀態
done。保存輸出
video.url 複製到你自己的儲存空間中。授權
Bearer token authentication. Use your CometAPI key.
主體
Prompt describing how the source image should animate. CometAPI requires this field for this route.
"Animate the still image with a slow camera move and natural motion."
Output aspect ratio. Combine with resolution to choose the target frame; for example 480p with 1:1 targets 480x480, 720p with 16:9 targets 1280x720, and 720p with 9:16 targets 720x1280. This endpoint does not expose an exact size field.
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. Use an integer from 1 through 15. If omitted, CometAPI treats the request as an 8-second generation for billing and default handling.
Source image for image-to-video. Use a public JPEG, PNG, or WebP URL, or a data URI such as data:image/png;base64,<BASE64_IMAGE_DATA>.
xAI video model id. The default example uses Grok Imagine 1.5 for image-to-video.
"grok-imagine-video-1.5"
Output resolution. Use 720p for a small image-to-video test, or 1080p when you need a higher resolution tier.
480p, 720p, 1080p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
回應
Request accepted.
Deferred request id used for polling.