Skip to main content
POST
  • sora-2-vvip 視頻生成模型
  • 支持文本到視頻、圖生視頻、角色引用
  • 異步任務管理,通過任務 ID 查詢結果
重要變更:爲了更好的性能和成本控制,我們不再支持在 image_urls 中直接傳入 base64 圖片數據。請先使用 上傳圖片接口 上傳圖片,獲取 URL 後再調用本接口。

Authorizations

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

Body

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

Response

string
任務唯一標識符,用於查詢任務狀態
string
對象類型,固定爲 generation.task
string
使用的模型名稱
string
任務狀態
  • queued - 排隊等待處理
  • in_progress - 處理中
  • completed - 成功完成
  • failed - 失敗
integer
任務進度百分比(0-100)
integer
任務創建時間戳(Unix 時間戳)
object
任務元數據