角色创建-异步 (sora)

POST

/v1/videos

创建角色，后续可用于 @ 调用，注意调用角色需要跟 prompt 有空格隔开
例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞
@xxxx1 在一个舞台上和 @yyyy1 牵手跳舞

角色创建接口提供了一个使用真人角色的解决方案：先将角色创建为虚拟角色，然后在提示词中通过 @id 引用该角色即可。

请求参数

Header 参数

Body 参数application/json

示例

{
   "model": "sora-2-character",
   "prompt": "创建角色",
   "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
   "timestamps": "1,3"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.wenwen-ai.com/v1/videos' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
   "model": "sora-2-character",
   "prompt": "创建角色",
   "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
   "timestamps": "1,3"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "id": "char_8c6651a6-74ba-49c4-9a03-a56b687fa9c0",
    "object": "character",
    "model": "sora-2-character",
    "status": "in_progress",
    "progress": 0,
    "created_at": 1769151527539
}

修改于 2026-01-23 07:12:54

分镜模式-异步 (sora)

文生视频-同步 (veo)