创建角色 Character

开发中

POST

https://maas.haoee.com/sora/v1/characters

创建角色，后续可用于 @ 调用，注意调用角色需要跟 prompt 有空格隔开
例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞
参数 url、 from_task 二选一，必须设置一个
接口说明
角色客串功能:
你可以把生成的或者上传你自己的视频，把任何角色对象提取出来，加入视频中作为“客串角色”
用户不仅能客串自己，还可以创建生活中的角色(如宠物、朋友)或纯想象的角色(如怪物、英雄、奇幻生物)
只需上传相机里的视频(如宠物鸭子视频)，或直接生成全新角色，甚至从日常物品(如饼干罐)衍生出有趣面孔。
任何东西都能变身客串，激发无限脑洞
PS: 这个角色指的是物品，不是人物，人物要走 face id 录入暂不支持上传

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json

示例

{
    "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3",
    "from_task": "video_637efe22-3b6a-47ad-ab02-ee01a686a0bd"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://maas.haoee.com/sora/v1/characters' \
--header 'ModelName;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3",
    "from_task": "video_637efe22-3b6a-47ad-ab02-ee01a686a0bd"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "id": "string",
    "username": "string",
    "permalink": "string",
    "profile_picture_url": "string"
}

sora2故事板视频

sora2 使用角色客串