文件 API
托管组织的文件：上传、列出、查看、下载和删除。使用 OpenAI SDK，将 baseURL 改为 /file/v1；文件对象额外包含 mime_type 和 downloadable。
（待译）
File stores uploads for conversations and knowledge bases, with metadata, downloads and deletion. Concepts and behavior follow OpenAI Files (multipart uploads, purposes and file IDs), so OpenAI Files experience applies. Differences: uploads are limited to 104857600 bytes; only user_data, assistants and vision purposes are accepted, and conversation images require user_data; praxis[expires_in_seconds] allows expiry up to 90 days, while expires_after allows up to 30 days. Start with praxis.file.files.create to upload bytes and obtain a reusable file ID.
基础地址
接入
加载中…单文件上限 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 官方文档为准。