GRGlobalRouter Docs
Console

Audio / POST

Create transcription

上传音频文件并create转写结果。

Endpoints

Mobile only shows the endpoint list. View parameter details and examples on desktop.

MethodEndpointDescription
POST/v1/audio/speechcreate文本转语音结果，并直接returns二进制音频流。
POST/v1/audio/voices通过一段参考音频create可复用的自定义音色。
POST/v1/audio/transcriptions上传音频文件并create转写结果。
POST/v1/audio/transcriptions

用于 OpenAI 风格音频转写。请求使用 multipart/form-data，并必须通过 provider 指定providers。

Back to Audio endpoint list

Request parameters

FieldTypeRequiredDescription
filefileYes待转写音频，支持 WAV、MP3、M4A，最大 25 MiB。
modelstringYes转写models ID，例如 qwen3-asr-flash-filetrans。
providerstringYes指定providers ID；调用千问models时填写 ali。
languagestringNo音频语言提示，例如 zh 或 en。
response_formatstringNoreturns格式：json（默认）或 verbose_json。
temperaturenumberNoSampling temperature.

Response fields

FieldTypeRequiredDescription
textstringYesTranscribed text.
durationnumberNoAudio duration.
usageobjectNoUsage and billing information.

Errors

401UNAUTHORIZED

Missing or invalid Authorization Bearer token.

403FORBIDDEN

The current API key is not allowed to call this scope or model.

429RATE_LIMITED

请求过快或异步任务队列已满，请降低并发或稍后重试。

Notes

  • 当前 qwen3-asr-flash-filetrans 仅支持 json 和 verbose_json；不支持 prompt。
  • file 使用 multipart/form-data 上传，不能传 file_url 或 Base64 文本。