Sora2 Video Remix
Edit and modify generated videos
中国本土のユーザー向け: 中国本土のユーザーは 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_KEYBody
modelstringボディ必須デフォルト: sora-2Video remix model name
Supported models:
sora-2- Standard versionsora-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 secondssora-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 mode1:1- Square
Example: "16:9"
レスポンス
idstringUnique task identifier for status queries
objectstringObject type, always generation.task
modelstringモデル name used
statusstringTask status
queued- Queued for processingin_progress- Processingcompleted- Successfully completedfailed- Failed
progressintegerTask progress percentage (0-100)
created_atintegerTask creation timestamp (Unix timestamp)
metadataobjectTask 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"
}
}