API 参考
音频转写与语音生成
按音频模型能力上传转写文件或生成语音,区分 JSON 与二进制返回。
前提
在模型目录确认音频模型支持的接口、输入格式和计价单位。转写模型与语音生成模型通常不同。按 API 概览准备密钥,以下命令使用 Bash。
音频转写
将 sample.wav 替换为实际文件,选择支持转写的模型。curl 会生成 multipart 请求头。
curl --fail-with-body 'https://gateway.irouter.io/v1/audio/transcriptions' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-F 'model=<model-id>' \
-F 'file=@sample.wav' \
-F 'response_format=json'选择 JSON 返回格式时读取文本字段;其他输出格式应使用相应解析方式。上传前检查文件大小、音频格式和目标模型限制。
语音生成
将 <voice-id> 替换为该模型支持的音色,选择支持语音生成的模型。下面请求 MP3 文件。
curl --fail-with-body 'https://gateway.irouter.io/v1/audio/speech' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","input":"Welcome to iRouter.","voice":"<voice-id>","response_format":"mp3"}' \
--output speech.mp3先检查 HTTP 状态再使用输出文件;失败时不要把错误 JSON 当音频播放。音色、速度、格式和文本长度须按该模型能力设置,不能套用其他模型的音色名称。
使用与费用
转写和语音生成的计费单位可能不同,按模型页与用量记录核对。只上传业务必需且有权使用的音频;将生成文件保存到你控制的存储,并按应用的数据规则管理。