接口 / Storage
Files API
POST
/v1/files文档和图片可以先上传一次，再在 Responses API 中通过 file_id 引用。Files API 尽量保持 OpenAI-compatible，同时明确 Lazu 的保留期和 purpose 规则。
File endpoints
| Method | Path | 用途 |
|---|---|---|
| POST | /v1/files | 上传 |
| GET | /v1/files | 列表 |
| GET | /v1/files/:id | 元数据 |
| GET | /v1/files/:id/content | 下载内容 |
| DELETE | /v1/files/:id | 删除 |
所有 endpoint 都使用 Authorization: Bearer $LAZU_API_KEY。
上传请求
purposestringrequired
user_datavision声明文件用途。
filemultipart filerequired
上传的文件字节。
支持的 purpose
user_data
最大 512 MB。用于 PDF、文本和结构化数据，通过 Responses 的
input_file 传入。
vision
最大 20 MB。允许 image/png、image/jpeg、
image/gif、image/webp。
OpenAI 的 batch、fine-tune 和
assistants purpose 暂不支持。无论 purpose
如何，都会拒绝可执行文件扩展名。
上传响应
idstringFile ID，例如 file-lazu-01KSBV4MC6THZ9TCZEM38KPYRX。
objectstring始终为 file。
bytesinteger上传字节数。
filenamestring原始文件名。
purposestring存储的 purpose。
statusstring通常为 processed。
成功上传时 Lazu 返回 201 Created。如果客户端只接受 200，需要把
201 也视作成功。
在 Responses 中引用
Lazu 只会在 Responses 中解引用 file_id。
Chat completions 不会自动拉取文件内容。
对于 purpose=vision 的图片文件，请使用 input_image
而不是 input_file。
限制
| 限制 | 值 |
|---|---|
单个 purpose=user_data 文件 | 512 MB |
单个 purpose=vision 文件 | 20 MB |
| 单次 Responses 调用解引用总大小 | 64 MB |
错误
missing_required_parameter400缺少 purpose 或文件字节。
purpose_not_supported400不支持的 purpose，例如 batch 或 fine-tune。
file_too_large413单文件或解引用总大小超过限制。
file_not_found404文件不存在，或不属于当前 API Key。