ToAPIsToAPIs
Sora2

Sora2 Video Remix

Edit and modify generated videos

POST
/v1/videos/{video_id}/remix

中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。

  • Sora2 video remix feature
  • Remix and edit existing generated videos
  • Supports secondary creation based on existing videos
  • Asynchronous processing mode, returns task ID for subsequent queries

Path パラメータ

video_idstringパス必須

Original video task ID

This is the task ID returned from a previous video generation request

Authorizations

Authorizationstringヘッダー必須

All endpoints require Bearer Token authentication

Get your API Key from the API Key Management Page

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

modelstringボディ必須デフォルト: sora-2

Video remix model name

Supported models:

  • sora-2 - Standard version
  • sora-2-pro - Professional version, supports longer duration

Example: "sora-2" or "sora-2-pro"

promptstringボディ必須

Remix instruction description

durationintegerボディ

Video duration in seconds

  • sora-2: Supports 10 or 15 seconds
  • sora-2-pro: Supports 15 seconds (HD) or 25 seconds

Example: 15

aspect_ratiostringボディ

Video aspect ratio

Supported ratios:

  • 16:9 - Standard widescreen (recommended)
  • 9:16 - Portrait mode
  • 1:1 - Square

Example: "16:9"

レスポンス

idstring

Unique task identifier for status queries

objectstring

Object type, always generation.task

modelstring

モデル name used

statusstring

Task status

  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
progressinteger

Task progress percentage (0-100)

created_atinteger

Task creation timestamp (Unix timestamp)

metadataobject

Task metadata

リクエスト例

curl --request POST \
  --url https://toapis.com/v1/videos/task_01K8SGYNNNVBQTXNR4MM964S7K/remix \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "sora-2",
    "prompt": "Add a puppy playing in the scene",
    "duration": 15,
    "aspect_ratio": "16:9"
  }'
import requests

video_id = "task_01K8SGYNNNVBQTXNR4MM964S7K"

response = requests.post(
    f"https://toapis.com/v1/videos/{video_id}/remix",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json"
    },
    json={
        "model": "sora-2",
        "prompt": "Add a puppy playing in the scene",
        "duration": 15,
        "aspect_ratio": "16:9"
    }
)

task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")
const videoId = 'task_01K8SGYNNNVBQTXNR4MM964S7K';

const response = await fetch(`https://toapis.com/v1/videos/${videoId}/remix`, {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-ToAPIs-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'sora-2',
    prompt: 'Add a puppy playing in the scene',
    duration: 15,
    aspect_ratio: '16:9'
  })
});

const task = await response.json();
console.log(`Task ID: ${task.id}`);
console.log(`Status: ${task.status}`);

レスポンス例

{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "size": "720x720"
  }
}