视频超分

POST /v1/videos 统一接口，model 传 video-upscale。提交成功只返回 id，再查询，completed 后下载。

Base URLhttps://api.oiovideo.com鉴权Authorization: Bearer YOUR_API_KEY轮询间隔建议 ≥ 4 秒成片时效转存 24 小时，请尽快下载

超分与其它视频模型共用同一个接口（POST /v1/videos），无需另开通道；差异只在参数：输入是一条待超分的视频，不读提示词，不支持参考图 / 参考音频。

提交

POST /v1/videos

curl -X POST https://api.oiovideo.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "video-upscale",
    "video_urls": [
      "https://mdn.github.io/shared-assets/videos/flower.mp4"
    ],
    "seconds": 5,
    "resolution": "1080p"
  }'

成功响应

{
  "id": "TASK_ID",
  "object": "video",
  "model": "video-upscale",
  "status": "queued",
  "progress": 0,
  "created_at": 1764347090
}

参数

字段	类型	必填	说明
`model`	string	是	固定 `video-upscale`
`video_urls`	string[]	是	输入视频：公网 HTTPS 直链，恰好 1 条（先上传素材）。别名 `videos` / `video` / `video_url` / `input_video`
`seconds`	number/string	是	输入视频实际秒数（整数 1–3600）；也认 `duration` / `n_seconds` / `metadata.seconds`
`resolution`	string	否	720p（默认）/ 1080p / 2k / 4k；请用小写形式（`4k`、`1080p`；大写 `4K` 会被平台校验拒绝）；只接受有现价的档
`priority`	number	否	队列优先级：`0` 标准（默认）、`1` 优先（单价更高）；也可写 `metadata.priority`。优先档未开放时自动按标准档处理，不拒单
`prompt`	string	否	超分不读取，可不传

规则与计费

输入视频必须公网 http(s) 直链；内网地址、localhost、Data URI 一律拒绝
seconds 必须等于输入视频真实秒数：服务端会探测源视频时长，偏差超过 1 秒直接拒单，不扣费
计费：输入视频时长 × 分辨率单价（以定价页 / 广场展示为准）
priority：1 为优先队列（单价更高，是否开放见广场），未开放时自动按标准档处理、不拒单；0 或缺省即标准档
未定价的分辨率（如 480p）会在转发前被拒绝（model_price_error），不扣费、不占上游配额

查询与下载见任务查询与下载；各模型计费口径见视频生成 · 计费单位与队列优先级。

完整链路示例（上传素材 → 提交超分 → 轮询 → 下载）

# 1) 换预签名（本地 input.mp4）
curl -X POST https://api.oiovideo.com/api/media/presign \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "input.mp4", "size": 5242880}'

# 2) 用返回的 upload_url 直传（headers 原样带上）
curl -X PUT "<upload_url>" -H "Content-Type: video/mp4" --data-binary @input.mp4
# → 公网地址 https://img.oiovideo.com/refs/20260924/your-upload.mp4

# 3) 提交超分任务（seconds 必须等于输入视频真实秒数，示例 5 秒）
curl -X POST https://api.oiovideo.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "video-upscale", "video_urls": ["https://img.oiovideo.com/refs/20260924/your-upload.mp4"],
       "seconds": 5, "resolution": "1080p"}'
# → {"id": "TASK_ID", "status": "queued"}

# 4) 轮询（间隔建议 4 秒以上）
curl https://api.oiovideo.com/v1/videos/TASK_ID -H "Authorization: Bearer YOUR_API_KEY"

# 5) 下载（首选，带 Key；-L 跟随跳转）
curl -L https://api.oiovideo.com/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_API_KEY" -o upscaled.mp4