跳轉到主要內容
POST
/
v1
/
videos
/
generations
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": "一隻金毛犬在草地上奔跑，陽光明媚",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

{
  "id": "video_01K8SGYNNNVBQTXNR4MM964S7K",
  "object": "generation.task",
  "model": "sora-2-vvip",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {
    "size": "720x720"
  }
}
  • sora-2-vvip 視頻生成模型
  • 支持文本到視頻、圖生視頻、角色引用
  • 異步任務管理，通過任務 ID 查詢結果
重要變更：爲了更好的性能和成本控制，我們不再支持在 image_urls 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片，獲取 URL 後再調用本接口。

​
Authorizations

​
Authorization
string
必填
所有接口均需要使用 Bearer Token 進行認證獲取 API Key：訪問 API Key 管理頁面 獲取您的 API Key使用時在請求頭中添加：
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
string
預設值:"sora-2-vvip"
必填
視頻生成模型名稱支持的模型：sora-2-vvip - VVIP版，僅支持固定時長檔位示例："sora-2-vvip"
​
prompt
string
必填
視頻生成的文本描述💡 @角色引用功能：您可以在提示詞中使用 @username 格式引用之前創建的角色，將其包含在生成的視頻中。
  • 角色的 username 可通過 查詢角色 API 獲取
  • 支持同時引用多個角色
示例："一隻貓和一隻狗一起開車 @duksvfkf.cruisingki @zdqwahgj.baronbarki"
​
duration
integer
視頻時長（秒）僅支持 4、8 或 12 秒示例：4
​
aspect_ratio
string
視頻寬高比支持的格式：
  • 16:9 (橫屏)
  • 9:16 (豎屏)
​
image_urls
string[]
用於圖生視頻的參考圖像 URL 數組⚠️ 僅支持 URL 格式（不再支持 base64）
  • 公開可訪問的圖像 URL（http:// 或 https://）
  • 可使用 上傳圖片接口 上傳本地圖片獲取 URL
​
thumbnail
boolean
是否生成視頻縮略圖
  • true - 生成視頻縮略圖用於預覽和展示
如果不需要縮略圖，可以省略此參數
​
metadata.n
integer
預設值:"1"
生成不同變體的數量取值範圍：1-4默認值：1
​
metadata.watermark
boolean
預設值:"false"
是否爲生成的視頻添加水印
  • false - 無水印
  • true - 爲視頻添加 Sora 官方水印
默認值：false
​
metadata.private
boolean
預設值:"false"
是否啓用隱私模式
  • true - 視頻不會被髮布，且無法被 remix（重新編輯）
  • false - 視頻可以被髮布和 remix
默認值：false
​
metadata.style
string
視頻風格支持的值：
  • thanksgiving - 感恩節風格
  • comic - 漫畫風格
  • news - 新聞風格
  • selfie - 自拍風格
  • nostalgic - 懷舊/復古風格
  • anime - 動漫風格
示例："anime"
​
metadata.storyboard
boolean
是否使用故事板功能，更精細地控制視頻生成細節
  • true - 啓用故事板功能
  • false - 不使用故事板
示例：true
​
metadata.character_url
string
用於角色提取的參考視頻 URL用於在生成的視頻中重用參考視頻中的角色示例："https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4"⚠️ 注意： 使用此參數時，生成的視頻時長會減少 1 秒
​
metadata.character_timestamps
string
角色出現的時間戳指定參考視頻中角色出現的時間範圍，僅支持 2 秒片段格式："起始秒,結束秒"示例："1,3" 表示參考視頻中第 1 秒到第 3 秒的角色⚠️ 注意： 使用此參數時，生成的視頻時長會減少 1 秒
​
metadata.character_create
boolean
預設值:"false"
創建視頻完成後，自動根據生成的視頻創建角色
  • true - 自動創建角色
  • false - 不創建角色
默認值：false
​
metadata.character_from_task
string
根據已經生成的任務 ID 來創建角色可以引用之前生成的視頻任務 ID，從該視頻中提取角色示例："video_01K8SGYNNNVBQTXNR4MM964S7K"

​
Response

​
id
string
任務唯一標識符，用於查詢任務狀態
​
object
string
對象類型，固定爲 generation.task
​
model
string
使用的模型名稱
​
status
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
​
progress
integer
任務進度百分比（0-100）
​
created_at
integer
任務創建時間戳（Unix 時間戳）
​
metadata
object
任務元數據
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": "一隻金毛犬在草地上奔跑，陽光明媚",
    "duration": 4,
    "aspect_ratio": "16:9"
  }'

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