文件
文件 API
托管组织的文件：上传、列出、查看、下载和删除。使用 OpenAI SDK，将 baseURL 改为 /file/v1；文件对象额外包含 mime_type 和 downloadable。
基础地址
加载中…
接入
加载中…单文件上限 100 MB（104857600 字节），上传与下载全程流式。不提供 Uploads 分片。文件按内容识别类型；支持格式见上传端点。组织之间的文件互不可见。
端点
| 方法 | 路径 | 说明 | 支持 |
|---|---|---|---|
| POST | /v1/files | 上传文件 | ◐ 部分支持 |
| GET | /v1/files | 列出文件 | ● 支持 |
| GET | /v1/files/{file_id} | 查看文件 | ● 支持 |
| GET | /v1/files/{file_id}/content | 下载文件 | ● 支持 |
| DELETE | /v1/files/{file_id} | 删除文件 | ● 支持 |
与官方的差异
- 沿用 OpenAI 的文件和分页形状，增加 mime_type、downloadable，以及 before 查询游标。仅自有面支持请求体 praxis.expires_in_seconds（3600–7776000 秒），不可与 expires_after 同时使用；multipart 编码为 praxis[expires_in_seconds]。
- 上传文件：支持 PDF、DOCX / XLSX / PPTX、PNG / JPEG / GIF / WebP、MP3 / WAV / FLAC / OGG / M4A、MP4 / WebM，以及 UTF-8 JSON / NDJSON / CSV / Markdown / 纯文本。purpose 支持 user_data / assistants / vision。上限 104857600 字节；空文件、类型不支持、用途不支持、超限均返回 400。不提供 Uploads 分片。可用 expires_after[anchor] 与 expires_after[seconds] 或 praxis[expires_in_seconds] 设置有效期，两组互斥。
参数与字段的权威定义以 OpenAI 官方文档为准。