请输入
菜单

音频转录(OpenAI)

将音频识别为文字,保留原始语言。

请求

项目 说明
方法 POST
路径 /v1/audio/transcriptions
网关地址 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 否 采样参数,支持范围以模型为准
language Body string 否 ISO-639-1 语言代码,例如 zh 或 en
timestamp_granularities[] Body string[] 否 时间戳粒度,例如 word 或 segment;需模型及返回格式支持
使用 -F 上传文件,让客户端自动生成 multipart boundary;不要手工设置 Content-Type: application/json。

调用示例

curl -X POST 'https://ailink.nativex.com/v1/audio/transcriptions' \
  -H 'Authorization: Bearer sk-xxxx' \
  -F 'file=@audio.mp3' \
  -F 'model=MODEL_ID' \
  -F 'response_format=json'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "text": "你好,欢迎使用 AiLink。"
}
字段或结果 说明
text 识别或翻译后的文本;非 JSON 格式会直接返回文本或字幕

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28