转写音频

POST 
/v1/audio/transcriptions

把一段短音频转写成文字。以 multipart 表单数据发送音频（file，audio/* 类型，最大 25 MB）；language 为可选提示。需要项目的计费账户有可用余额。

请求

响应

200

成功响应

401

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

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

403

调用方已通过鉴权，但无权执行此操作。

• permission_denied — 你没有权限执行此操作。

413

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

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

422

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

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

429

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

• insufficient_credits — 计费账户的积分不足。
• rate_limited — 请求太频繁，请放慢速度。

500

服务端发生了意外错误。

• internal — 发生了意外错误。

502

处理请求时，上游服务返回了错误。

• upstream_error — 转写失败，请重试。

503

服务暂时不可用；请稍等片刻后重试。

• service_unavailable — 转写暂时不可用。