第3章 文件上传接口

上传文件 POST /files 上传图像文件，后续可在聊天补全请求中通过 file_id 引用该文件。 支持的格式：JPEG、PNG、GIF 和 WebP。系统会根据文件内容识别格式。详细信息请参阅 Files API 指南。 请求​ multipart/form-dataBody必需file二进制必需要上传的图像文件。支持格式：JPEG、PNG、GIF 和 WebP。文件大小上限：64 MiB。purpose字符串必需可能值：[user_data]上传文件的预期用途，必须为 user_data。expires_after[anchor]字符串可能值：[created_at]过期时间的锚点。若提供则必须为 created_at，且需与 expires_after[seconds] 配合使用。expires_after[seconds]整数可能值：>= 3600 且 <= 2592000文件的生命周期（秒），范围在 3600（1 小时）到 2592000（30 天）之间。需与 expires_after[anchor] 配合使用。若需永久保留文件，请省略这两个 expires_after 字段。 响应​200成功，返回上传的文件对象。application/jsonSchema示例（来自模式）示例模式id字符串必需文件标识符，格式为 file-api-...，可在聊天补全请求中引用。object字符串必需可能值：[file]对象类型，始终为 file。bytes整数必需文件大小（字节）。created_at整数必需文件创建时的 Unix 时间戳（秒）。filename字符串必需文件名称。purpose字符串必需可能值：[user_data]文件的预期用途。expires_at整数文件过期的 Unix 时间戳（秒）。仅在上传时设置了过期时间时存在。{ "id": "string", "object": "file", "bytes": 0, "created_at": 0, "filename": "string", "purpose": "user_data", "expires_at": 0 } { "id": "file-api-0a1b2c3d4e5f60718293a4b5c6d7e8f9", "object": "file", "bytes": 102400, "created_at": 1700000000, "filename": "image.jpg", "purpose": "user_data" } 加载中...