通用接口
文件上传
POST /api/v1/upload · 上传图片到 CokeAPI CDN,获取临时 URL 用于图生图 / 图生视频。
⚠️ 注意:文件上传走 用户端 API (
/api/v1/upload),需要用户登录态 Bearer Token,不是 API Key。如果你的服务端没有用户登录态,请直接传文件的公开 URL 到ref_image_url字段,跳过此接口。
何时需要
| 场景 | 需要本接口吗? |
|---|---|
图生图 (/v1/images/edits) image / mask 字段 | ❌ 不需要,直接 multipart 传文件 |
图生视频 (/v1/video/generations) ref_image_url 字段 | ✅ 需要,先上传拿到 URL,再传给视频接口 |
| 自家产品有用户上传需求,想复用 CokeAPI CDN | ✅ 需要 |
调用
curl https://www.cokeapi.com/api/v1/upload \
-H "Authorization: Bearer <用户 access_token>" \
-F file=@photo.png限制
| 项 | 限制 |
|---|---|
| 单文件大小 | 图片 ≤ 20 MB,视频参考素材 ≤ 200 MB |
| 支持格式 | png / jpg / jpeg / webp / mp4 / mov |
| URL 有效期 | 24 小时 (与生成结果一致) |
| 单用户日配额 | 100 个文件 |
响应
{
"code": 0,
"msg": "ok",
"data": {
"url": "https://cdn.cokeapi.com/upload/01HX....png",
"hash": "sha256:...",
"size": 1234567,
"mime": "image/png"
}
}安全提示
- 上传的图片对所有持有 URL 的人公开,不要上传敏感内容。
- 生产环境建议自家 OSS,本接口主要用于开发调试。
- URL 24 小时后失效,不要作为长期存储方案。