ToAPIsToAPIs
Sora2

Sora2 VVIP 動画生成

Generate high-quality videos using the sora-2-vvip model

POST
/v1/videos/generations

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

  • sora-2-vvip video 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_KEY

Body

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

Video 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 username can 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ボディデフォルト: 1

Number of different variants to generate

Range: 1-4

Default: 1

metadata.watermarkbooleanボディデフォルト: false

Whether to add a watermark to the generated video

  • false - No watermark
  • true - Add Sora official watermark to the video

Default: false

metadata.privatebooleanボディデフォルト: false

Whether 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 style
  • comic - Comic style
  • news - News style
  • selfie - Selfie style
  • nostalgic - Nostalgic/Retro style
  • anime - Anime style

Example: "anime"

metadata.storyboardbooleanボディ

Whether to use storyboard for finer control over video generation details

  • true - Enable storyboard feature
  • false - 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ボディデフォルト: false

Automatically create a character from the generated video after completion

  • true - Automatically create character
  • false - 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"

レスポンス

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/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"
  }
}