章鱼哥AI接口文档

文档

POSThttps://zexapi.com/v1/videos
鉴权 Authorization: Bearer YOUR_API_KEY

使用 API Key 进行 Bearer 鉴权。JSON 请求设置 Content-Type: application/json;Multipart 请求由客户端自动生成 boundary。

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

接口地址

POST /v1/videos

功能说明

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

请求头

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

请求参数

文生视频

参数名类型必填说明
modelstring是模型名称,详见下方模型列表(如 sora-2-12s)
promptstring是文本提示词
sizestring是画面尺寸,宽>高为横屏,高>宽为竖屏,如 1920x1080(横屏)、1080x1920(竖屏)

图生视频

图生视频支持两种方式提交参考图片:
方式一:使用图片 URL(推荐)
Content-Type: application/json
使用 images 参数传递可访问的图片 URL 数组
参数名类型必填说明
modelstring是模型名称(如 sora-2-12s)
promptstring是文本提示词
imagesarray是参考图片 URL 数组(需要可以访问的图片地址,取第一张)
sizestring是画面尺寸,宽>高为横屏,高>宽为竖屏,如 1920x1080(横屏)、1080x1920(竖屏)
方式二:使用图片文件
Content-Type: multipart/form-data(必填)
使用 input_reference 字段上传图片文件
参数名类型必填说明
modelstring是模型名称(如 sora-2-12s)
promptstring是文本提示词
input_referenceFile是参考图片文件
sizestring是画面尺寸,宽>高为横屏,高>宽为竖屏,如 1920x1080(横屏)、1080x1920(竖屏)
注意:images 和 input_reference 二选一,不能同时使用。

支持的模型

模型名称时长说明
sora-2-12s12 秒Sora 2 (横竖屏由 size 决定)

请求示例

文生视频

curl -X POST https://xxx.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-12s",
    "prompt": "做个广告",
    "size": "1920x1080"
  }'

图生视频

方式一:使用图片 URL(推荐)
curl -X POST https://xxx.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-12s",
    "prompt": "做个广告",
    "size": "1920x1080",
    "images": ["https://www.baidu.com/img/PCtm_d9c8750bed0b3c7d089fa7d55720d6cf.png"]
  }'
方式二:使用图片文件
curl -X POST https://xxx.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=sora-2-12s" \
  -F "prompt=让这张图片动起来" \
  -F "size=1080x1920" \
  -F "input_reference=@/path/to/image.jpg"

响应参数

参数名类型说明
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": "in_progress",
  "progress": 10,
  "created_at": 1709876543
}

提交成功(排队中)

{
  "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}

请求示例

curl -X GET https://xxx.com/v1/videos/task_xxxxxxxxxxxxx \
  -H "Authorization: Bearer YOUR_API_KEY"

响应参数

与提交接口响应参数相同,完成后会包含 video_url。

注意事项

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