UnderSky 文档

音频转写 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说明
400invalid_multipart 或 unsupported_model表单、文件或模型无效。
401认证错误API Key 缺失或无效。
402计费错误账户无法预留最低额度。
429速率限制使用有上限的指数退避重试。
502upstream_unreachable配置的供应商没有响应。

阅读转写指南了解完整流程,阅读媒体 API 总览了解相关端点。

目录