oiovideo API 文档
外接开发者按下面接口连通。
认证
Authorization: Bearer YOUR_API_KEY
上传素材
用站点 Key 换预签名,直传对象存储,拿公网 HTTPS。
文本
POST /v1/chat/completions
图像
POST /v1/images/generations。GPT、nano-banana 与 Gemini 图像。
视频
POST /v1/videos,再查询下载。
视频超分
POST /v1/videos(model=video-upscale),源视频提质。
十分钟跑通
01
拿 Key
控制台 → 令牌 → 新建令牌,Key 只显示一次。
02
传素材
换预签名后 PUT 直传,拿到公网 HTTPS。
03
提交任务
文本/图像同步返回;视频先拿 id 再轮询下载。
接口
| 能力 | 方法 | 路径 |
|---|---|---|
| 文本 | POST | /v1/chat/completions |
| 图像 | POST | /v1/images/generations |
| 视频提交 | POST | /v1/videos |
| 视频查询 | GET | /v1/videos/{id} |
| 视频下载 | GET | /v1/videos/{id}/content |
| 上传素材 | POST | /api/media/presign |
约定
- Base URL:
https://api.oiovideo.com - 业务接口:
Authorization: Bearer YOUR_API_KEY - 素材上传需要本站 Key:先换预签名地址,再直传对象存储
- 参考图、参考视频先走图床再写公网 HTTPS(也可用你自己的公网图床)。本站只接收公网 URL:随请求文件、Data URI 一律
413 - 参考音频:必须是公网 HTTPS;≤10MB 可走本站预签名上传,超过 10MB 或需长期有效请用自己的直链(本站临时素材 1 小时过期)
- 图像同步返回;视频异步:提交 → 查询 → 下载
- 成片下载:
GET /v1/videos/{id}/content(带 Key,302 到对象存储直链)。查询 JSON 没有下载地址;不要打/signed_url - 图像接口固定返回
data[].url(对象存储公网直链,无需 Key,约 24 小时内有效,请及时保存);请求b64_json会被400拒绝