音频转写 API
参考 POST /v1/audio/transcriptions 的 multipart 字段、支持的转写模型、Token 价格、最低计费和错误响应。
端点
POST https://api.undersky.ai/v1/audio/transcriptions在 Authorization Header 中使用模型 API Key,并以 multipart/form-data 发送请求。
表单字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
file | 文件 | 是 | 带文件名的音频文件。 |
model | 字符串 | 否 | whisper-1、gpt-4o-mini-transcribe、gpt-4o-transcribe 或 gpt-4o-transcribe-diarize,默认 gpt-4o-mini-transcribe。 |
response_format | 字符串 | 否 | 配置供应商支持的响应格式。 |
language | 字符串 | 否 | ISO-639-1 语言提示。 |
prompt | 字符串 | 否 | 转写使用的词汇或上下文提示。 |
temperature | 数字 | 否 | 上游支持的采样温度。 |
其他 multipart 字段会转发给配置的转写供应商。
请求
curl -sS https://api.undersky.ai/v1/audio/transcriptions \
-H "Authorization: Bearer sk-your-api-key" \
-F "[email protected]" \
-F "model=gpt-4o-mini-transcribe" \
-F "language=zh" \
-F "response_format=json"模型和价格
| 模型 | 输入价格 | 输出价格 |
|---|---|---|
whisper-1 | 按请求计费 | 按请求计费 |
gpt-4o-mini-transcribe | 每百万 Token $1 | 每百万 Token $4 |
gpt-4o-transcribe | 每百万 Token $84 | 每百万 Token $140 |
gpt-4o-transcribe-diarize | 每百万 Token $84 | 每百万 Token $140 |
成功请求最低消耗 $0.10 credit。失败请求会释放预留额度。
响应
网关返回配置供应商的成功 JSON 或文本响应,并保留其 Content-Type。解析器应兼容所选模型和格式。
错误
| 状态 | Code | 说明 |
|---|---|---|
400 | invalid_multipart 或 unsupported_model | 表单、文件或模型无效。 |
401 | 认证错误 | API Key 缺失或无效。 |
402 | 计费错误 | 账户无法预留最低额度。 |
429 | 速率限制 | 使用有上限的指数退避重试。 |
502 | upstream_unreachable | 配置的供应商没有响应。 |