创建文件

POST 
/v1/files

一步上传一张图片、一段视频或一段音频（MP3、WAV、M4A 或 AAC）：以 multipart/form-data POST 文件内容（字段为 file）。服务端按文件内容判断真实类型（而不是声明的 content-type），检查各类型的大小上限，保存文件，并返回保存后的文件——之后可以用它的 id 把图片或视频附在消息里，或把其中任何一种作为生成的输入。文件会在它的 expires_at 过期，除非在此之前被发送在消息里或被生成使用。

请求

响应

201

成功响应

401

鉴权失败：凭证缺失、格式错误、已过期或已作废。

• invalid_token — 访问令牌无效。
• project_disabled — 此项目未启用。
• token_expired — 访问令牌已过期。
• user_disabled — 此用户未启用。

413

请求体超过了允许的上限。

• file_too_large — 文件超过了允许的最大大小。
• payload_too_large — 请求体太大。

422

请求中的某个值未通过校验；details 数组会列出每个出错的字段。

• unsupported_media_type — 不支持该媒体类型。
• validation_failed — 请求内容未通过校验。

429

要么是请求太多（Retry-After 响应头会说明何时重试），要么是计费账户的积分已用完（不带 Retry-After——加上积分才能继续）；用 code 字段区分这两种情况。

• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。