Whisper：音频翻译为英文

通过 /v1/audio/translations 上传录音并返回英文译文。

API Key multipart/form-data

功能与适用场景

将支持的输入语言音频转成英文文本。此接口的目标语言固定为英文，不能设置任意 target_lang。

支持模型与组合

使用 whisper-1。gpt-4o-transcribe 是转写模型，不应作为 translations 示例模型。

第一步：设置鉴权

使用青云TOP API 的 API Key：Authorization: Bearer YOUR_API_KEY。替换占位符，保留 Bearer 后的空格。无需厂商 API Key。

第二步：调用模型

POST https://top.qingyuntop.ai/v1/audio/translations

请求为 multipart/form-data。由客户端自动生成 boundary，不手写 Content-Type。

Request

请求

/v1/audio/translations

Body

必填

Bodyobject

filestring必填

必填，multipart 文件字节。使用本地 audio.mp3，不能只传文件名或 JSON 路径。厂商音频上传限25 MB；长文件请先切分。

示例file://C:\Users\Administrator\Desktop\test.m4a

modelstring必填

必填，表单，仅使用 whisper-1，将输入语言翻译为英文。gpt-4o-transcribe 不能用于该动作。

示例gpt-4o-transcribe

promptstring

选填，表单文本，帮助识别术语；不是对转写内容发指令。

示例

response_formatstring

选填，默认 json，可用 json / text / srt / verbose_json / vtt；示例采用 json。若改为字幕或纯文本，响应不要调用 JSON 解析。

示例

temperaturenumber

选填字段；是否可用取决于当前模型和协议。

示例

请求示例multipart/form-data

set -euo pipefail
curl --fail-with-body --connect-timeout 30 --max-time 600 "https://top.qingyuntop.ai/v1/audio/translations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --form-string 'model=whisper-1' \
  --form-string 'response_format=json' \
  -F 'file=@audio.mp3' \
  --output response.json

Response

返回响应 `200`

HTTP 响应

响应 200object

textstring必填

常见错误与参考

如果需要中文等其他目标语言，先转写，再将文字交给聊天模型翻译。

401：检查本站 API Key 和 Bearer 格式；403：确认此 Key 可用该模型；429：遵循 Retry-After 退避。超时或 5xx 时保留请求标识和脱敏错误，避免盲目重发；其他通用排查见聊天接入总览。

OpenAI 公共 API 规范。原语言转写。