Skip to main content
POST
/
v1
/
videos
/
{video_id}
/
remix
Create a Sora remix job
curl --request POST \
  --url https://api.cometapi.com/v1/videos/{video_id}/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Shift the color palette to teal, sand, and rust, with a warm backlight."
}
'
{
  "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 best 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