Sora2 视频生成 API 如何对接？附可直接使用的开源前端项目

一、为什么要用 API + 开源前端？

真正的门槛，不是技术，而是"从 0 到能用"。

直接对接 Sora2 API，本质上只需要完成三件事：

1. 前端收集 prompt

2. 后端 POST 提交任务

3. 查询或回调获取结果

但对很多新手来说，前端 UI 和交互反而是最大障碍 。

因此，这里采用的是：

• Sora2 视频生成 API

• 配套开源 Uniapp 前端

组合方式，能够快速形成一个可用的完整应用形态。

二、Sora2 API 基本信息

• 接口地址

  https://api.yidevs.com/app/human/human/Tool/video_create

• 请求方式：POST

• 请求频率：无限制

• 计费方式：10 积分 / 次

• 生成时长：10 秒 / 15 秒 / 25 秒（已开放）

三、Header 参数说明

参数名	必填	说明
Authorization	是	控制台创建的 Token，格式 Bearer xxxx
Accept	否	application/json
Content-Type	否	application/json

四、请求参数详解

1. 参数总览

参数名	类型	必填	说明
prompt	string	是	视频生成提示词
image_url	string	否	融入视频的图片
aspectRatio	string	是	9:16 或 16:9
duration	string	是	10 / 15 / 25
avatars	string	否	虚拟角色配置
remix_id	string	否	官方视频 ID
notify_url	string	否	回调地址

---

2. prompt 使用说明

prompt 是决定视频质量的核心因素，建议直接描述完整画面和台词，例如：

大排档店的门口，一个美女老板，用中文说着自我介绍......

如果使用 avatars，可通过固定格式引用角色：

@avatar0 对着 @avatar1 大声怒吼

五、调用示例（PHP）

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yidevs.com/app/human/human/Tool/video_create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    "prompt" => "大排档店的门口，一个美女老板，用中文说着自我介绍：我是这家店的老板娘......",
    "aspectRatio" => "9:16",
    "duration" => "10"
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_TOKEN",
    "Content-Type: application/json"
  ],
]);

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

echo $response;

六、返回结果说明

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

字段	说明
task_id	视频生成任务 ID

任务提交成功后，可通过查询接口或回调地址获取最终视频。

七、关于 25 秒视频的说明（实测经验）

• 25 秒已开放，但稳定性略低

• 官方生成时间：约 25--30 分钟

• API 实测生成时间：约 35 分钟左右

• 如资源不足，可能自动降级为 15 秒

建议提前向用户说明，避免误解。

八、重要注意事项（必须告知用户）

1. 禁止上传真人图片

2. 禁止使用名人姓名

3. 多次使用同一违规图片，密钥可能被自动封禁

4. avatars 不支持真人角色

这一点在前端一定要明确提示。

九、配套开源前端说明（重点）

这套 Sora-2 Uniapp 前端具备以下特点：

• 一套代码，多端运行

• UI 已完整实现

• 支持文生视频、比例切换、作品管理

• 提示词优化、一键生成

• 会员体系、算力充值、卡密系统

• 视频无水印，支持 2K / 4K 提升

前端已解决 80% 的"能不能用"问题，

剩下的 20%，只是接口对接。

前端代码完全开源，可直接对接你的后端或 API。

开源代码地址：

https://gitee.com/yc_open/sora-uniapp

十、写在最后

这类方案并不追求复杂技术，而是：

• 接入简单

• 成本可控

• 能快速验证需求

对于想尝试 Sora2 视频生成能力，或希望低成本跑通完整流程的开发者来说，这是一种现实可行的选择。