Sora2 VVIP 動画生成
Generate high-quality videos using the sora-2-vvip model
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.com を https://toapis.cn に置き換えてください。
sora-2-vvipvideo generation model- Supports text-to-video, image-to-video, and character reference
- Async task management, query results by task ID
Important Change: For better performance and cost control, we no longer support passing base64 image data directly in image_urls. Please use the Upload 画像API first to upload images and get URLs, then call this endpoint.
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-2-vvipVideo generation model name
Supported model: sora-2-vvip - VVIP version with fixed duration tiers
Example: "sora-2-vvip"
promptstringボディ必須Text description for video generation
💡 @Character Reference Feature:
You can use @username format in the prompt to reference previously created characters and include them in the generated video.
- The character's
usernamecan be obtained via the Query Character API - Supports referencing multiple characters at once
Example: "A cat and a dog driving a car together @duksvfkf.cruisingki @zdqwahgj.baronbarki"
durationintegerボディVideo duration in seconds
Supports only 4, 8, or 12 seconds
Example: 4
aspect_ratiostringボディVideo aspect ratio
Supported formats:
16:9(Landscape)9:16(Portrait)
image_urlsstring[]ボディArray of reference image URLs for image-to-video generation
⚠️ URL format only (base64 no longer supported)
- Publicly accessible image URL (http:// or https://)
- You can use the Upload 画像API to upload local images and get URLs
thumbnailbooleanボディWhether to generate a video thumbnail
true- Generate a video thumbnail for preview and display
If you don't need a thumbnail, you can omit this parameter
metadata.nintegerボディデフォルト: 1Number of different variants to generate
Range: 1-4
Default: 1
metadata.watermarkbooleanボディデフォルト: falseWhether to add a watermark to the generated video
false- No watermarktrue- Add Sora official watermark to the video
Default: false
metadata.privatebooleanボディデフォルト: falseWhether to enable privacy mode
true- Video will not be published and cannot be remixed (re-edited)false- Video can be published and remixed
Default: false
metadata.stylestringボディVideo style
Supported values:
thanksgiving- Thanksgiving stylecomic- Comic stylenews- News styleselfie- Selfie stylenostalgic- Nostalgic/Retro styleanime- Anime style
Example: "anime"
metadata.storyboardbooleanボディWhether to use storyboard for finer control over video generation details
true- Enable storyboard featurefalse- Do not use storyboard
Example: true
metadata.character_urlstringボディReference video URL for character extraction
Used to reuse characters from a reference video in the generated video
Example: "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4"
⚠️ Note: When using this parameter, the generated video duration will be reduced by 1 second
metadata.character_timestampsstringボディCharacter appearance timestamps
Specifies the time range in the reference video where the character appears, only supports 2-second segments
Format: "start_second,end_second"
Example: "1,3" means the character from second 1 to second 3 in the reference video
⚠️ Note: When using this parameter, the generated video duration will be reduced by 1 second
metadata.character_createbooleanボディデフォルト: falseAutomatically create a character from the generated video after completion
true- Automatically create characterfalse- Do not create character
Default: false
metadata.character_from_taskstringボディCreate a character from an already generated task ID
Reference a previously generated video task ID to extract characters from that video
Example: "video_01K8SGYNNNVBQTXNR4MM964S7K"
レスポンス
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/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "sora-2-vvip",
"prompt": "A golden retriever running on grass, sunny day",
"duration": 4,
"aspect_ratio": "16:9"
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "sora-2-vvip",
"prompt": "Make this dog come alive, running on grass",
"image_urls": ["https://example.com/dog.jpg"],
"duration": 4,
"aspect_ratio": "16:9"
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "sora-2-vvip",
"prompt": "A cute cartoon elephant",
"aspect_ratio": "16:9",
"duration": 4,
"metadata": {
"style": "anime",
"watermark": false
}
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "sora-2-vvip",
"prompt": "A small frog dancing on a bright stage",
"duration": 4,
"aspect_ratio": "16:9"
}'curl --request POST \
--url https://toapis.com/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "sora-2-vvip",
"prompt": "A cat and a dog driving a car together @duksvfkf.cruisingki @zdqwahgj.baronbarki",
"duration": 4,
"aspect_ratio": "16:9"
}'import requests
response = requests.post(
"https://toapis.com/v1/videos/generations",
headers={
"Authorization": "Bearer your-ToAPIs-key",
"Content-Type": "application/json"
},
json={
"model": "sora-2-vvip",
"prompt": "A golden retriever running on grass, sunny day",
"duration": 4,
"aspect_ratio": "16:9",
"metadata": {
"style": "anime",
"watermark": False,
"n": 2
}
}
)
task = response.json()
print(f"Task ID: {task['id']}")
print(f"Status: {task['status']}")const response = await fetch('https://toapis.com/v1/videos/generations', {
method: 'POST',
headers: {
'Authorization': 'Bearer your-ToAPIs-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'sora-2-vvip',
prompt: 'A golden retriever running on grass, sunny day',
duration: 4,
aspect_ratio: '16:9',
metadata: {
style: 'anime',
watermark: false,
n: 2
}
})
});
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-vvip",
"status": "queued",
"progress": 0,
"created_at": 1768380224,
"metadata": {
"size": "720x720"
}
}