# 上传图片

`POST /v1/files`

上传本地图片并获得一个可公开访问的临时 URL，可用于图片展示或作为模型参考图。

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

## purpose 填写
图片引用场景建议填写 `vision`。

## 有效期与限流
图片默认保留 1 天。默认每个用户每 60 秒最多上传 10 张、每天最多成功上传 200 张，账号下多个 API Key 共用额度。服务同时最多处理 64 个上传；触发限制时响应会提供 `Retry-After`。

## 读取结果
上传成功后读取响应中的 `url`；`created` 和 `expires_at` 均为 Unix 毫秒时间戳。URL 在有效期内访问无需携带 API Key。

Tags: 文件