自建图床 API 说明
图像 / 视频等接口常要求传入可公网访问的图片 URL。控制台与部分示例使用独立图床服务上传本地文件，再把返回的 URL 填入业务接口。
与业务网关的关系
| 项 | 说明 |
|---|---|
| 业务调用 | Chat / 图像 / 视频等走站点 Base URL + sk- API Key |
| 图床上传 | 不是 new--api 内的路由；默认指向外部 imageproxy |
| 文档中的接口页 | 见侧栏 系统管理 → 账号与令牌 中的「上传图片」（POST /api/upload） |
控制台默认上传地址：
https://imageproxy.api-relay.app/api/upload
（源码常量：IMAGEPROXY_UPLOAD_URL。）
请求示例
curl -X POST 'https://imageproxy.api-relay.app/api/upload' \
-H "Authorization: Bearer sk-YOUR_KEY" \
-F 'file=@./demo.png'
- Content-Type：
multipart/form-data - 表单字段名：
file - 鉴权：Bearer（以图床服务实际要求为准；控制台通常附带当前业务 Key）
成功后响应中会给出可访问的图片 URL（字段名以图床服务返回为准），将其填入例如图生视频、参考图等参数。
注意事项
- 勿把图床与令牌 CRUD 混用：
/api/token*走业务网关与用户会话 /access_token；图床是另一服务。 - URL 时效：部分图床返回临时地址，过期后上游拉取失败；重要素材请转存到自有存储。
- 大小与格式：过大或非图片 MIME 可能导致失败；按业务接口对参考图的限制压缩后再传。
- 隐私：上传即可能被公网拉取，勿上传含敏感信息的原图。
相关链接
- 接口文档：账号与令牌 · 上传图片（slug:
system，操作「上传图片」） - 令牌管理：同页「获取令牌列表 / 新增令牌」等