> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socialvision.tisyk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 自建图床 API 说明

> 使用帮助：自建图床 API 说明

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

## 与业务网关的关系

| 项 | 说明 |
| - | - |
| 业务调用 | Chat / 图像 / 视频等走站点 Base URL + `sk-` API Key |
| 图床上传 | **不是** `new--api` 内的路由；默认指向外部 imageproxy |
| 文档中的接口页 | 见侧栏 **系统管理 → 账号与令牌** 中的「上传图片」（`POST /api/upload`） |

控制台默认上传地址：

```text theme={null}
https://imageproxy.zhongzhuan.chat/api/upload
```

（源码常量：`IMAGEPROXY_UPLOAD_URL`。）

## 请求示例

```bash theme={null}
curl -X POST 'https://imageproxy.zhongzhuan.chat/api/upload' \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -F 'file=@./demo.png'
```

* Content-Type：`multipart/form-data`
* 表单字段名：`file`
* 鉴权：Bearer（以图床服务实际要求为准；控制台通常附带当前业务 Key）

成功后响应中会给出可访问的图片 URL（字段名以图床服务返回为准），将其填入例如图生视频、参考图等参数。

## 注意事项

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

## 相关链接

* 接口文档：[账号与令牌 · 上传图片](/reference/system)（slug: `system`，操作「上传图片」）
* 令牌管理：同页「获取令牌列表 / 新增令牌」等


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.