语音转文字（STT）

API 配置

保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。

Base: api.xrtoken.net

将音频文件转录为文字。请求使用 multipart/form-data 格式，必须包含 file 和 model 字段。计费方式：按音频时长（秒）计费，系统根据文件大小估算时长，结算时以实际转录时长为准。

Authorization

BearerAuth

AuthorizationBearer <token>

API 密钥认证（OpenAI 格式）。在 Authorization 请求头中传入：

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

model*string

语音识别模型 ID，可通过 GET /v1/models 过滤 type: stt 获取

file*file

音频文件，支持 mp3、mp4、mpeg、mpga、m4a、wav、webm 格式

Formatbinary

language?string

音频语言（ISO-639-1 代码），指定后可提升识别准确率

prompt?string

提示词，可提供上下文以提升识别准确率

response_format?string

响应格式

Default"json"

Value in"json" | "text" | "srt" | "verbose_json" | "vtt"

curl -X post "https://api.xrtoken.net/v1/audio/transcriptions" \  -F model="openai/whisper-1" \  -F file="string"

{
  "text": "你好，欢迎使用 XRToken。",
  "duration": 0.1
}

{
  "error": "model field is required",
  "type": "invalid_request_error"
}

{
  "error": "invalid or missing API key",
  "type": "auth_error"
}

{
  "error": "insufficient balance -- please top up or upgrade your plan",
  "type": "billing_error"
}

{
  "error": "rate limit exceeded",
  "type": "rate_limit_error"
}

{
  "error": "upstream provider error",
  "type": "server_error"
}