Skip to main content
POST
Video Remix

Video Remix

OpenAI-format entry point. For unified video, use Video Remix (Unified Video) (POST /v1/video/remix, pass task_id in the Body). Based on an existing Grok video task, submit a remix task via POST /v1/videos/{video_id}/remix to generate variants with new prompts and aspect ratio parameters.
  • The path parameter video_id is the original video task ID.
  • The request body is JSON and must include model, prompt, size, and aspect_ratio.
  • After a successful submission, the new task id and status are returned. Please poll using Grok Task Query or Query Task for unified video, depending on which pipeline the original task belongs to.

Method and Path

Request Example

Response Example

Authentication

Path Parameters

string
required
Source video task ID, consistent with the id returned by Grok Video Generation or the query interface.

Body

string
required
Model name, for example grok-video-3.
string
required
Remix prompt describing how to rewrite or continue the original video content.
string
required
Resolution specification, pass 720P or 1080P.
string
required
Video aspect ratio, optional values: 2:3, 3:2, 1:1.
string
Parent task ID.

Response

string
New remix task ID.
string
Task status, common values include processing, completed, failed.
integer
Most recent status update time (Unix timestamp).