3.Create Character(通过url创建角色)

POST

/v1/videos

根据视频url和指定片段，创建角色。
后续可用于 @ 调用，注意调用角色需要跟 prompt 有空格隔开
例如：@{角色1Username} 在一个舞台上和 @{角色2Username} 牵手跳舞

请求参数

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 '/v1/videos' \
--header 'Authorization: {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "model": "sora-2-character",
    "prompt": "创建角色",
    "url": "https://filesystem.site/cdn/20251030/javYrU4etHVFDqg8by7mViTWHlMOZy.mp4",
    "timestamps": "1,3"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功示例异常示例

{
    "id": "char_2f7a568b-4541-41b6-b491-35e8c17a493d",
    "object": "character",
    "model": "sora-2-character",
    "status": "queued",
    "progress": 0,
    "username": null,
    "avatar_url": null,
    "video_url": null,
    "created_at": 1766681833,
    "completed_at": null,
    "expires_at": null,
    "size": null,
    "seconds": null,
    "remixed_from_video_id": null,
    "error": null
}

修改于 2026-01-10 10:43:49

2.Create Video(通过url创建视频)

4.Create Character(通过任务创建角色--可创建真人角色)