语音翻译
上传一段任意语言的音频,直接返回英文译文。接口兼容 OpenAI POST /v1/audio/translations。只想原语言转写,用 语音识别。
| 项 | 值 |
|---|---|
| 方法与路径 | POST /v1/audio/translations |
| 鉴权 | Authorization: Bearer YOUR_API_KEY |
| Content-Type | multipart/form-data |
快速示例
cURL
BASH
curl https://www.nextai-code.com/v1/audio/translations \
-H "Authorization: Bearer $NEXTAI_API_KEY" \
-F [email protected] \
-F model=YOUR_MODEL
Python(OpenAI SDK)
PYTHON
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["NEXTAI_API_KEY"], base_url="https://www.nextai-code.com/v1")
with open("chinese.mp3", "rb") as f:
result = client.audio.translations.create(model="YOUR_MODEL", file=f)
print(result.text)
Node.js(OpenAI SDK)
JAVASCRIPT
import fs from "node:fs";
import OpenAI from "openai";
const client = new OpenAI({ apiKey: process.env.NEXTAI_API_KEY, baseURL: "https://www.nextai-code.com/v1" });
const result = await client.audio.translations.create({
model: "YOUR_MODEL",
file: fs.createReadStream("chinese.mp3"),
});
console.log(result.text);
可用的语音识别模型以 模型列表(
GET /v1/models)为准。
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
file |
file | 是 | 音频文件,字段名必须是 file,缺失时返回 400(缺少上传文件)。支持的格式与大小上限取决于模型 |
model |
string | 是 | 模型名。缺失时返回 400(缺少 model 参数) |
prompt |
string | 否 | 引导文本(应为英文) |
response_format |
string | 否 | json、text、srt、verbose_json、vtt 等;默认 json,可选值取决于模型 |
temperature |
number | 否 | 采样温度 |
| 其他字段 | - | 否 | 其他表单字段会原样转发给模型服务商,是否生效取决于模型 |
响应
与 语音识别 相同,格式由 response_format 决定。json 格式:
JSON
{ "text": "Welcome to NextAI Code." }
计费
与 语音识别 一致:响应带 usage 时按其计费,否则按音频时长折算,每分钟计 1000 输入 Token。