Sora2 使用角色客串

方法: POST路径: /v2/videos/generations

角色客串功能: 你可以把生成的或者上传你自己的视频，把任何角色对象提取出来，加入视频中作为“客串角色” 用户不仅能客串自己，还可以创建生活中的角色(如宠物、朋友)或纯想象的角色(如怪物、英雄、奇幻生物) 只需上传相机里的视频(如宠物鸭子视频)，或直接生成全新角色，甚至从日常物品(如饼干罐)衍生出有趣面孔。 任何东西都能变身客串，激发无限脑洞

PS: 这个角色指的是物品，不是人物，人物要走 face id 录入暂不支持上传 注意调用角色需要跟 prompt 有空格隔开 例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞 @xxxx1 在一个舞台上和 @yyyy1 牵手跳舞

请求参数

Header 参数

Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

prompt
string
必需
注意调用角色需要跟 prompt 有空格隔开
例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞
model
enum<string>
必需
枚举值:
sora-2
sora-2-pro
支持hd、15s
images
array
[string]
可选
图片列表，支持url、base64
aspect_ratio
enum<string>
输出比例
可选
枚举值:
16:9
横屏
9:16
竖屏
hd
boolean
可选
是否生成高清，默认false；高清会导致生成速度更慢; 仅 sora-2-pro 支持
duration
enum<string>
可选
视频时长；仅 sora-2-pro 支持25s
枚举值:
10
15
25
仅 sora-2-pro 支持25s
notify_hook
string
可选
watermark
boolean
可选
private
boolean
可选
是否隐藏视频，true-视频不会发布，同时视频无法进行 remix(二次编辑)， 默认为 false
character_url
string
可选
创建角色需要的视频链接，注意视频中一定不能出现真人，否则会失败
character_timestamps
string
可选
视频角色出现的秒数范围，格式
{start},{end}
, 注意 end-start 的范围 1～3秒
示例
{
"prompt"
:
"string"
,
"model"
:
"sora-2"
,
"images"
:
[
"string"
]
,
"aspect_ratio"
:
"16:9"
,
"hd"
:
true
,
"duration"
:
"10"
,
"notify_hook"
:
"string"
,
"watermark"
:
true
,
"private"
:
true
,
"character_url"
:
"string"
,
"character_timestamps"
:
"string"
}

请求示例代码

Shell

curl --location --request POST '/v2/videos/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "model": "sora-2",
    "images": [
        "string"
    ],
    "aspect_ratio": "16:9",
    "hd": true,
    "duration": "10",
    "notify_hook": "string",
    "watermark": true,
    "private": true,
    "character_url": "string",
    "character_timestamps": "string"
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

object

示例

{
    "task_id": "f0aa213c-c09e-4e19-a0e5-c698fe48acf1"
}