Skip to main content
POST
/
v1
/
videos
/
{video_id}
/
remix
cURL
VIDEO_ID="<video_id>"

curl "https://api.cometapi.com/v1/videos/$VIDEO_ID/remix" \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Make it sunset with golden light"
  }'
{
  "id": "<string>",
  "object": "<string>",
  "model": "<string>",
  "status": "<string>",
  "progress": 123,
  "created_at": 123,
  "size": "<string>",
  "seconds": "<string>",
  "remixed_from_video_id": "<string>"
}
Use this endpoint to create a variation of a completed Sora video without starting from scratch. Remix works well when you keep the change narrow and explicit.

​
Good remix prompts

  • Ask for one clear change instead of rewriting the whole scene
  • Keep references to lighting, palette, camera motion, or mood specific
  • Start from a completed source video, not an in-progress job

​
Remix flow

1

Finish the base render first

Create a source video with Create Video and wait until it completes.
2

Submit the remix request

Pass the completed video_id with a prompt that describes one focused change.
3

Poll and download the remix

Treat the remix response as a new async job, poll it with Retrieve Video, then download it with Retrieve Video Content.

​
How it maps to OpenAI

This follows OpenAI’s documented remix pattern. CometAPI keeps the same concept, but you stay on the CometAPI base URL and auth model for the whole workflow.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your CometAPI key.

Path Parameters

​
video_id
string
required

Completed source video id.

Body

application/json
​
prompt
string
required

Describe the change you want to make to the existing video.

Example:

"Shift the color palette to teal, sand, and rust, with a warm backlight."

Response

200 - application/json

Remix job accepted.

​
id
string
required
​
object
string
required
​
model
string
required
​
status
string
required
​
progress
integer
required
​
created_at
integer
required
​
size
string
required
​
seconds
string
required
​
remixed_from_video_id
string
required