Skip to main content
图像 / 视频等接口常要求传入可公网访问的图片 URL。控制台与部分示例使用独立图床服务上传本地文件,再把返回的 URL 填入业务接口。

与业务网关的关系

控制台默认上传地址:
(源码常量:IMAGEPROXY_UPLOAD_URL。)

请求示例

  • Content-Type:multipart/form-data
  • 表单字段名:file
  • 鉴权:Bearer(以图床服务实际要求为准;控制台通常附带当前业务 Key)
成功后响应中会给出可访问的图片 URL(字段名以图床服务返回为准),将其填入例如图生视频、参考图等参数。

注意事项

  1. 勿把图床与令牌 CRUD 混用:/api/token* 走业务网关与用户会话 / access_token;图床是另一服务。
  2. URL 时效:部分图床返回临时地址,过期后上游拉取失败;重要素材请转存到自有存储。
  3. 大小与格式:过大或非图片 MIME 可能导致失败;按业务接口对参考图的限制压缩后再传。
  4. 隐私:上传即可能被公网拉取,勿上传含敏感信息的原图。

相关链接

  • 接口文档:账号与令牌 · 上传图片(slug: system,操作「上传图片」)
  • 令牌管理:同页「获取令牌列表 / 新增令牌」等