音频翻译

POST https://api.apizt.com/v1/audio/translations 在线调试 →

音频翻译使用 whisper-1，输出为英文译文；请求需上传真实音频文件，不能把响应的 text 字段当成请求体。

▼ Authorization

在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token

示例： Authorization: Bearer ********************

请求参数

Header 参数

Authorizationstring必需

Bearer Token；从环境变量 tokenba_API_KEY 读取。

Content-Typestring可选

由客户端生成 multipart/form-data 的 boundary，不手工设置。

Body 参数multipart/form-data

filefile必需

本地音频文件；将环境变量 AUDIO_FILE 设置为文件路径。

modelstring必需

示例：whisper-1

response_formatstring可选

示例：json

请求示例代码

curl --fail-with-body --request POST 'https://api.apizt.com/v1/audio/translations' \
  --header "Authorization: Bearer ${tokenba_API_KEY}" \
  --form "file=@${AUDIO_FILE}" \
  --form 'model=whisper-1' \
  --form 'response_format=json'

async function main() {
  const headers = {
  "Authorization": "Bearer " + process.env.tokenba_API_KEY
};
  const fs = require("node:fs");
  const body = new FormData();
  body.append("file", new Blob([fs.readFileSync(process.env.AUDIO_FILE)]), "audio.wav");
  body.append("model", "whisper-1");
  body.append("response_format", "json");
  const response = await fetch("https://api.apizt.com/v1/audio/translations", { method: "POST", headers, body });
  if (!response.ok) throw new Error("HTTP " + response.status + ": " + await response.text());
  console.log(await response.text());
}
main().catch(console.error);

import os
import requests

headers = {"Authorization": "Bearer " + os.environ["tokenba_API_KEY"]}
payload = {'model': 'whisper-1', 'response_format': 'json'}
with open(os.environ["AUDIO_FILE"], "rb") as audio:
    response = requests.post('https://api.apizt.com/v1/audio/translations', headers=headers, data=payload, files={"file": audio}, timeout=120)
response.raise_for_status()
print(response.text)

返回响应

响应参数 🟢 200 OK · application/json

text string

必需

翻译后的英语文本内容。

示例

{
  "text": "Hello, my name is Wolfgang and I come from Germany. Where are you heading today?"
}