Skip to main content
POST
/
v1
/
videos
/
{video_id}
/
remix
curl --request POST \
  --url https://toapis.com/v1/videos/video_01K8SGYNNNVBQTXNR4MM964S7K/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-official",
    "prompt": "Shift the color palette to teal, sand, and rust, with a warm backlight"
  }'

{
  "id": "video_68ff7cef76cc8190b7eab9395e936d9e",
  "object": "video",
  "model": "sora-2-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1761574127,
  "remixed_from_video_id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "seconds": "8",
  "size": "1280x720"
}
The remix feature allows you to modify specific aspects of an existing video while preserving its core elements. By referencing the previous video ID from a successfully completed generation, and supplying an updated prompt, the system maintains the original video’s framework, scene transitions, and visual layout while implementing your requested changes.
For optimal results, limit your modifications to one clearly articulated adjustment. Narrow, precise edits retain greater fidelity to the source material and minimize the likelihood of generating visual defects.

​
Authorizations

​
Authorization
string
required
All endpoints require Bearer Token authenticationGet your API Key from the API Key Management PageAdd to request header:
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
video_id
string
required
The ID of a previously completed video to remixExample: "video_01K8SGYNNNVBQTXNR4MM964S7K"

​
Body

​
model
string
required
Video generation model nameMust use sora-2-official for Azure Sora 2 remixExample: "sora-2-official"
​
prompt
string
required
Updated text description for the remixed videoDescribe the specific changes you want to make to the original video. Be precise and focused on one clear modification.Example: "Shift the color palette to teal, sand, and rust, with a warm backlight"

​
Response

​
id
string
Unique task identifier for the remixed video
​
object
string
Object type, always video
​
model
string
Model name used
​
status
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
​
progress
integer
Task progress percentage (0-100)
​
created_at
integer
Task creation timestamp (Unix timestamp)
​
remixed_from_video_id
string
The original video ID that was remixed
​
seconds
string
Video duration in seconds
​
size
string
Video resolution (e.g., “1280x720”)
curl --request POST \
  --url https://toapis.com/v1/videos/video_01K8SGYNNNVBQTXNR4MM964S7K/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2-official",
    "prompt": "Shift the color palette to teal, sand, and rust, with a warm backlight"
  }'

{
  "id": "video_68ff7cef76cc8190b7eab9395e936d9e",
  "object": "video",
  "model": "sora-2-official",
  "status": "queued",
  "progress": 0,
  "created_at": 1761574127,
  "remixed_from_video_id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "seconds": "8",
  "size": "1280x720"
}