Sora2 短剧视频创作中如何保持人物一致性？角色创建接口教程

一、使用背景

在基于 Sora 进行多次视频生成时，如果每次都独立生成，人物外观可能会存在差异。

为减少这一问题，可以先从已有视频、图片或 Sora 任务中提取角色信息，生成可复用的角色标识，在后续创作中基于该角色继续使用。

本文记录一次角色创建接口的实际接入过程，仅作为接口使用说明。

二、接口信息说明

接口地址

POST https://api.yidevs.com/app/human/human/Tool/video_character
请求方式：POST
请求频率：无限制
返回格式：JSON
支持回调：是（notify_url）

参数名	必填	说明
Authorization	是	控制台生成的 Token
Accept	否	application/json
Content-Type	否	application/json

四、请求参数说明

参数名	必填	描述
input_type	是	输入资源类型
input_source	是	资源地址或任务 ID
timestamps	是	人脸时间范围
notify_url	是	接收回调的地址

input_type 取值说明

10：视频地址
20：图片地址
30：Sora 任务 ID

当使用图片或任务 ID 时，timestamps 固定为 0,3。

五、接口调用示例（PHP）

复制代码

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yidevs.com/app/human/human/Tool/video_character",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
      "input_type"   => 30,
      "input_source"=> "5d4187eeef447b421180c820",
      "timestamps"  => "0,3",
      "notify_url"  => "https://fau.com/"
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer xxxx",
    "Accept: application/json",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);

echo $response;

六、返回结果示例

复制代码

{
    "code": 200,
    "msg": "success",
    "data": {
        "task_id": "c04cc83dfc36a5865d"
    }
}

task_id：角色创建任务标识，用于后续关联使用

七、角色创建后的使用说明

角色创建完成后，会生成对应的任务 ID。

在后续基于 Sora 进行视频生成时，可结合该角色继续创作，从而在多次生成中保持人物形象相对稳定。

该过程通常为异步处理，需结合回调或结果查询使用。

八、使用注意事项

输入资源需保证人脸清晰
timestamps 建议覆盖完整人脸出现时间
notify_url 需能正常接收 POST 请求
角色创建完成后再进行后续内容生成