POST
https://octopusx.ai
/
v1
/
videos
/
{video_id}
/
remix
Video Remix
curl --request POST \
  --url https://octopusx.ai/v1/videos/{video_id}/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "size": "<string>",
  "aspect_ratio": "<string>",
  "parent_post_id": "<string>"
}
'
{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

​
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

POST /v1/videos/{video_id}/remix

​
Request Example

curl -X POST https://octopusx.ai/v1/videos/grok:48a67431-0708-46d1-9ab9-83cb84700153/remix \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "play with another white cat",
    "aspect_ratio": "3:2",
    "size": "1080P",
    "parent_post_id": "5afc6f67-23fe-4a74-a073-727ff662f870"
  }'

​
Response Example

{
  "id": "grok:48a67431-0708-46d1-9ab9-83cb84700153",
  "status": "processing",
  "status_update_time": 1762685256
}

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Path Parameters

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

​
Body

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

​
Response

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