Videos

Create a video remix

POST /openai/v1/videos/{video_id}/remix

Creates a video remix from the supplied request.

Path parameters

video_id string required

The identifier of the completed video to remix.

Request Body

The multipart request body.

Content-Type: multipart/form-data

prompt OpenAI.CreateVideoRemixBody required

Updated text prompt that directs the remix generation.

Responses

The request has succeeded.

Body

Content-Type: application/json

id string required

Unique identifier for the video job.

object enum required

The object type, which is always video.

video

model string | enum required

Any of the following:

string

enum

sora-2sora-2-prosora-2-2025-10-06sora-2-pro-2025-10-06sora-2-2025-12-08

status enum required

queuedin_progresscompletedfailed

progress integer required

created_at integer required

Unix timestamp (seconds) for when the job was created.

completed_at integer | null required

Unix timestamp (seconds) for when the job completed, if finished.

expires_at integer | null required

Unix timestamp (seconds) for when the downloadable assets expire, if set.

prompt string | null required

size enum required

720x12801280x7201024x17921792x1024

seconds string required

Duration of the generated clip in seconds. For extensions, this is the stitched total duration.

remixed_from_video_id string | null required

error OpenAI.Error-2 | null required

An error that occurred while generating the response.

code string required

A machine-readable error code that was returned.

type string | null

param string | null

message string required

A human-readable description of the error that was returned.

headers object

The Retry-After and Retry-After-Ms headers returned with the original error, if any.

[key: string] string

misalignment OpenAI.MisalignmentErrorDetailsResource

review_target string | null

error_type string | enum

Any of the following:

string

enum

potentially_unintended_data_transferpotentially_unintended_data_accesspotentially_unintended_destructive_activityother

detailed_explanation string

The public explanation for this block.

steer OpenAI._MisalignmentSteer

message string required

The public continuation instruction.

Request

curl -X POST https://api.openai.com/v1/videos/video_123/remix \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Extend the scene with the cat taking a bow to the cheering audience"
  }'

import OpenAI from 'openai';

const client = new OpenAI();

const video = await client.videos.remix('video_123', { prompt: 'Extend the scene with the cat taking a bow to the cheering audience' });

console.log(video.id);

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
video = client.videos.remix(
    video_id="video_123",
    prompt="x",
)
print(video.id)

package main

import (
    "context"
    "fmt"

    "github.com/openai/openai-go"
    "github.com/openai/openai-go/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("My API Key"),
    )
    video, err := client.Videos.Remix(
        context.TODO(),
        "video_123",
        openai.VideoRemixParams{
            Prompt: "x",
        },
    )
    if err != nil {
        panic(err.Error())
    }
    fmt.Printf("%+v
", video.ID)
}

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

video = openai.videos.remix("video_123", prompt: "x")

puts(video)

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.videos.Video;
import com.openai.models.videos.VideoRemixParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        VideoRemixParams params = VideoRemixParams.builder()
            .videoId("video_123")
            .prompt("x")
            .build();
        Video video = client.videos().remix(params);
    }
}

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env['OPENAI_API_KEY'], // This is the default and can be omitted
});

const video = await client.videos.remix('video_123', { prompt: 'x' });

console.log(video.id);

Response

{
  "id": "video_456",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1712698600,
  "size": "720x1280",
  "seconds": "8",
  "remixed_from_video_id": "video_123"
}