1. 视频(Videos)
大洋芋API
  • 接口(新)
    • 图片(Images)
      • 香蕉(异步)
      • gpt-image-2(异步)
      • image2(流式)
      • 任务查询
    • 视频(Videos)
      • sora创建
        POST
      • veo创建
        POST
      • 任务查询
        GET
  • 接口(作废)
    • sora2视频生成(作废)
      • sora2 去水印(作品地址)
      • sora2 去水印(草稿未发作品)
      • sora2 Chat(聊天格式兼容)
      • Sora2 文生视频(异步请求)
      • Sora2 图生视频直接传图(异步请求)
      • Sora2 图生视频URL传图(异步请求)
      • Sora2 任务进度(异步查询)
      • Sora2 查看视频内容
    • sora2 角色 Remix 故事板(作废)
      • sora2 文生视频
      • sora2 图生视频 URL
      • Sora2 图生视频
      • sora2 Remix 二创文生视频
      • Sora2 Remix 二创图生视频
      • Sora2 Remix 二创图生视频 删除首帧
      • sora2 故事板文生视频
      • Sora2 故事板图生视频
      • sora2 角色创建
      • sora2 角色创建 URL指定视频
      • sora2 指定任务剪辑
      • Sora2 任务进度/角色任务/查询
      • Sora2 预览任务视频
  1. 视频(Videos)

sora创建

开发中
POST
https://api.dyuapi.com/v1/videos

Sora视频生成接口文档(时长扩展版)#

接口地址#

POST /v1/videos

功能说明#

支持 Sora 2 时长扩展模型的文生视频和图生视频,时长直接体现在模型名中(12 秒 / 16 秒 / 20 秒),方向由 aspect_ratio 决定。

请求头#

参数名类型必填说明
Authorizationstring是Bearer YOUR_API_KEY
Content-Typestring推荐application/json或 multipart/form-data

请求参数#

文生视频#

参数名类型必填说明
modelstring是模型名称,详见下方模型列表(如 sora-2-12s)
promptstring是文本提示词
aspect_ratiostring是画面方向:16:9(横屏)或 9:16(竖屏)

图生视频#

图生视频支持两种方式提交参考图片:
方式一:使用图片 URL(推荐)
Content-Type: application/json
使用 image_url 参数传递可访问的图片 URL
参数名类型必填说明
modelstring是模型名称(如 sora-2-12s)
promptstring是文本提示词
image_urlstring是参考图片 URL(需要可以访问的图片地址)
aspect_ratiostring是画面方向:16:9(横屏)或 9:16(竖屏)
方式二:使用图片文件
Content-Type: multipart/form-data(必填)
使用 input_reference 字段上传图片文件
参数名类型必填说明
modelstring是模型名称(如 sora-2-12s)
promptstring是文本提示词
input_referenceFile是参考图片文件
aspect_ratiostring是画面方向:16:9(横屏)或 9:16(竖屏)
注意:image_url 和 input_reference 二选一,不能同时使用。

支持的模型#

模型名称时长说明
sora-2-12s12 秒Sora 2 (横竖屏由 aspect_ratio 决定)
与原 Sora 2 系列(sora-2-landscape-10s 等)的差异:
模型名不再包含方向后缀,方向必须通过 aspect_ratio 显式传入

请求示例#

文生视频#

图生视频#

方式一:使用图片 URL(推荐)
方式二:使用图片文件

响应参数#

参数名类型说明
idstring任务 ID
objectstring对象类型,固定值:video
modelstring使用的模型名称(可能为上游内部物理模型名,例如 sora-2-2,仅供参考;客户端应以提交时的 model 为准)
statusstring任务状态:queued(排队中)、in_progress / processing(处理中)、completed(已完成)、failed(失败)
progressnumber任务进度,0-100
created_atnumber创建时间戳(秒)
completed_atnumber完成时间戳(秒,仅 completed 状态返回)
video_urlstring完成后的视频地址(仅 completed 状态返回)

响应示例#

提交成功(排队中)#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-12s",
  "status": "queued",
  "progress": 0,
  "created_at": 1709876543
}

任务完成#

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-12s",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "video_url": "https://videos-us3.ss2.life/files/b/xxxxxx.mp4"
}

查询任务状态#

接口地址#

GET /v1/videos/{task_id}

请求示例#

响应参数#

与提交接口响应参数相同,完成后会包含 video_url。
CDN 重写:当上游返回域名为 nex-s.aijisu.cn 或 sora-2-2.openai.52pn.cn 时,
中间件(worker-aijisu.js / worker-w8x.js)会把视频 URL 中的 host 替换为
videos-us3.ss2.life(仅在 GET /v1/videos/{task_id} 上生效,且仅替换指定源 host)。

注意事项#

1.
方向必须显式传入 aspect_ratio:模型名不带方向后缀,缺省 aspect_ratio 时上游可能拒绝请求或采用未明确的默认值。
2.
图片二选一:image_url 与 input_reference 互斥;二者同时存在时行为未定义。
3.
图片 URL 要求:image_url 必须是可公开访问的图片地址,支持常见图片格式(jpg、png、webp 等)。
4.
异步处理:接口返回任务 ID 后,需要通过轮询 GET /v1/videos/{task_id} 查询任务进度和结果。

请求参数

Header 参数

Body 参数multipart/form-data必填

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.dyuapi.com/v1/videos' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'model="sora-2-12s"' \
--form 'prompt="小猫钓鱼"' \
--form 'aspect_ratio="9:16"' \
--form 'input_reference=@""'
响应示例响应示例
{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-landscape-10s",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600
}
上一页
任务查询
下一页
veo创建
Built with