跳转到主要内容
以 multipart 表单上传批处理输入文件,保存返回的 id,再按这个 ID 读回文件的元数据和字节。示例中的 client 按安装中的方式创建。

上传文件

TypeScript 和 Python 使用 SDK 方法上传,发送的是 POST /v1/batches/files。其他 SDK 无法发送 multipart,因此用标准 HTTP 客户端把表单提交到 POST /v1/files。

上传选项

这些选项适用于 TypeScript 和 Python 的上传方法。在直接发送的 multipart 请求中,把 purpose 和 file 作为表单字段发送。

读回文件

把 file_123 替换为上传返回的 ID。 在 Python 中,你也可以通过 client.files 调用这些操作:create(params) 像 upload_file 一样上传,list() 列出文件,retrieve(id) 读取元数据,content(id) 读取字节。Rust 没有文件方法。
文件端点处于 Beta 阶段,需要已启用的批处理提供商。

保存文件 ID:你无法列出文件

请保存每个上传文件的 id。列表方法调用 GET /v1/files,它会返回 400,代码为 not_supported,原因为 file_list_not_supported_with_shared_gateway_key。完整的契约见 Files API 参考。

响应

上传方法和元数据方法返回的 FileObject:
最后修改于 2026年11月5日