# 上传图片

`POST /v1/files`

上传图片到独立图片存储，并直接返回上游生成的公开图片 URL。KaienAPI 不保存图片文件、`file_id` 或文件元信息。

## 请求格式
使用 `multipart/form-data`，必须包含 `file` 和 `purpose`。当前仅支持 JPG、PNG、GIF、WebP，默认单文件不超过 10 MB。

## purpose 填写
为兼容现有调用格式，`purpose` 仍为必填字段，图片引用场景建议填写 `vision`；KaienAPI 不会保存该字段。

## 读取结果
上传成功后读取响应中的 `url`。该地址由上游图片存储直接提供，访问时无需携带 Kaien API Key，可直接用于图片展示或作为模型参考图 URL。接口不再提供文件列表、文件信息查询、内容下载或删除能力。

Tags: 文件