Video Remix

Submit a remix based on an existing Grok video task.

POST /v1/videos/video_abc123/remix

Available models

Headers

Name	Type	Required	Description
	string	Yes	Request authentication. Use a Bearer Token, for example: .
	string	Yes	Request content type. Must be set to .

Request parameters

Name	Type	Required	Description
	string	Yes	Source video task ID, matching the returned by Grok video generation or the query endpoint.

Request body

Name	Type	Required	Description
	string	Yes	Model name. See Available models above.
	string	Yes	Remix prompt describing how to rewrite or continue the original video.
	string	Yes	Resolution tier: or .
	string	Yes	Aspect ratio: ,, or .
	string	No	Parent task ID.

Request example

curl -X POST https://octopusx.ai/v1/videos/grok:48a67431-0708-46d1-9ab9-83cb84700153/remix \
  -H "Authorization: Bearer <token>" \
  -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
}

Response fields

Name	Type	Description
	string	New remix task ID.
	string	Task status. Common values include ,,.
	integer	Last status update time (Unix timestamp).

Related endpoints

• Grok video overview
• Video APIs overview
• Error codes