将输入语音翻译为英文文本。
请求
| 项目 | 说明 |
|---|---|
| 方法 | POST |
| 路径 | /v1/audio/translations |
| 网关地址 | https://ailink.nativex.com |
| 认证 | Authorization: Bearer sk-xxxx,替换为你的 API Key |
| 请求格式 | multipart/form-data |
示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。
参数说明
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
file |
Body | file | 是 | 本地音频文件 |
model |
Body | string | 是 | 支持当前操作的语音模型 |
prompt |
Body | string | 否 | 用于辅助识别的上下文 |
response_format |
Body | string | 否 | 传统接口支持 json、text、srt、verbose_json、vtt,具体以模型为准 |
temperature |
Body | number | 否 | 采样参数,支持范围以模型为准 |
使用 -F 上传文件,让客户端自动生成 multipart boundary;不要手工设置 Content-Type: application/json。
调用示例
curl -X POST 'https://ailink.nativex.com/v1/audio/translations' \
-H 'Authorization: Bearer sk-xxxx' \
-F 'file=@audio.mp3' \
-F 'model=MODEL_ID' \
-F 'response_format=json'
响应
以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。
{
"text": "Hello, welcome to AiLink."
}
| 字段或结果 | 说明 |
|---|---|
| text | 识别或翻译后的文本;非 JSON 格式会直接返回文本或字幕 |
错误处理
非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。