创建客串角色 Character

创建角色，后续可用于 @ 调用

如果没有视频地址，可以先调用v1/upload接口进行上传
创建可被 @ 调用的角色，后续使用时注意在角色标识与 prompt 之间留一个空格。例如：@qtpttnsu.buttonboar 在一个舞台上和 @8d4222e54.celestepaw 牵手跳 jazz 舞，舞台射灯移动照射，使用全景镜头摇镜头照射，Sony FX9 相机拍摄 35mm，电影质感。

参数说明：url、from_task 二选一，必须至少设置一个。

接口说明 — 角色客串功能：你可以把自己生成的或上传的视频里的任意物体提取出来，作为“客串角色”加入到视频中。用户不仅能客串自身场景，也可以创建生活中的对象（如宠物、朋友）或完全虚构的角色（如怪兽、英雄、奇幻生物）。只要上传手机或相机里的视频（例如宠物鸭子的视频），或者直接生成全新角色，甚至能把日常物品（比如饼干罐）演化出有趣的面貌。任何东西都能变成客串角色，激发无限创意。

注意：这里依旧不支持上传真人视频，图像，指的是物品类对象，非真人面部；；目前可以使用真人->线稿->sora2视频->获取角色的方式使用（仿）真人出镜（后面专门写一篇（仿）真人出镜教程）；若是人物面部需要走 face id 录入，目前不支持上传。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "id": "ch_691ee0e4ed6c8191b7ea959e2d328e34",
    "permalink": "https://sora.chatgpt.com/profile/iitgsstkb.skywardspo",
    "profile_picture_url": "https://filesystem.site/cdn/20251120/0ee666bef7268d7380cbd902255648.jpg",
    "username": "iitgsstkb.skywardspo"
}

请求参数

请求示例代码

返回响应