OpenRouter把语音转录塞进同一个API:一份key搞定聊天和转写,Whisper与按token计价STT一并接入

霞舞

霞舞

2026-07-22

815人浏览

原创

做语音转录的开发者,过去常被一种割裂感困扰:聊天走 openrouter,转写却得另起炉灶——要么自建 whisper 服务,要么接入第三方语音识别 sdk。7月22日,openrouter 填平了这道缝隙——正式上线 post /api/v1/audio/transcriptions 端点。用户只需使用与 chat completions 完全一致的 bearer 密钥,将 base64 编码的音频数据发过去,即可返回包含转录文本与用量信息的 json。从此,对话与转写,共用同一张“入场券”。

这份便捷的本质在于复用。你无需引入新 SDK,也不必额外部署独立服务——转录能力与聊天请求共享同一平台基础设施,由多家模型提供商共同承载,系统自动完成跨供应商负载均衡,而非被锁定在单一服务商上。对已将 OpenRouter 作为主力通道的团队而言,这套集成意味着少维护一条链路、少管理一套密钥。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenRouter把语音转录塞进同一个API:一份key搞定聊天和转写,Whisper与按token计价STT一并接入

模型层面,OpenRouter 提供两条路径:一类是类似 openai/whisper-1 的 Whisper 系列模型,按音频时长(秒)计费;另一类则是更新的语音转文本(STT)模型,按 token 计费。需注意的是,STT 类模型 ID 不会出现在默认 /api/v1/models 列表中,因其属于需主动筛选的输出模态——通过添加查询参数 ?output_modalities=transcription,即可精准拉出这批模型及其当前定价。若想提前试用,OpenRouter Playground 支持直接在浏览器中上传音频文件进行实时转录。

调用方式极简,一次请求即闭环。将音频文件 base64 编码后,连同指定模型与格式一并 POST 发送,响应中直接提取 textusage 字段即可。data 字段接收原始 base64 字节流,不接受 data URI 格式(如 data:audio/mp3;base64,...),请勿添加前缀;format 字段为必填项,用于告知上游模型如何解码字节流。如果你已有适配 OpenAI /v1/audio/transcriptions 的客户端,仅需将 base URL 替换为 https://openrouter.ai/api/v1,即可零修改迁移。该端点同样兼容 OpenAI 风格的 multipart/form-data 上传方式,支持单次提交音频文件与模型标识,最大体积限制为 25MB。

字段规范方面,modelinput_audio.datainput_audio.format 为必填项;支持格式包括 wavmp3flacm4aoggwebmaaclanguage 接收 ISO-639-1 语言代码,留空则由模型自动识别;temperature 控制采样随机性,取值范围为 0–1;response_format 默认为 json,设为 verbose_json 可额外获取任务元信息、检测语言、音频时长及分段时间戳;若同时启用 timestamp_granularities=word,还可获得词级时间戳——但该功能仅在兼容 OpenAI 协议的提供商(如 OpenAI、Groq、Together)上生效,其余厂商将直接返回 400 错误。provider 块用于透传各厂商私有参数,例如 Groq 可通过 provider.options.groq.prompt 注入预期词汇,辅助模型准确识别专业术语,避免误读。

超级椰子 Super Coco
超级椰子 Super Coco

专为Mac用户打造的AI语音输入工具。你动嘴,椰子干活。

下载

响应体为标准 JSON:text 字段承载转录结果,usage 对象则提供精确计量的用量明细,让费用结算不再依赖估算。某文档示例中,一段 9.2 秒音频生成 113 个 token(含 83 输入 + 30 输出),标注成本为 0.000508 美元——该数值仅为示意,并非实际报价,真实费用取决于所选模型与音频长度。响应头中还附带 X-Generation-Id,便于追踪或调试具体某次请求。

路由逻辑沿用聊天接口的统一机制。当某转录模型由多家提供商托管时,OpenRouter 会依据实时价格自动调度请求,实现跨厂商负载均衡,规避供应商绑定风险。不过目前转录端点暂未开放细粒度路由控制,聊天接口中常见的 orderonlyallow_fallbacksdata_collectionsort 等参数在此均不生效;provider 块仅用于传递厂商专属配置。OpenRouter 明确承诺不对供应商定价加价,目录价即实付价;“零补全保险”机制确保失败转写不产生费用;若你已拥有自有供应商协议,BYOK(Bring Your Own Key)功能允许使用自有密钥直连,仅支付平台服务费、免除模型按量调用成本;且在按量付费模式下,每月前 100 万次请求的平台费全额豁免。

真正投入开发前,以下四点约束必须纳入架构考量:其一,60 秒上游超时限制——该时限针对处理耗时,而非音频本身时长;体积过大或未压缩的录音易触发超时,长音频建议分段转写后再拼接文本;其二,不支持音频 URL 地址,端点仅接受 base64 JSON 或 ≤25MB 的 OpenAI 风格 multipart 文件;其三,不支持 SRT/VTT 字幕格式输出,设置 srtvtttext 将直接拒收并返回 400;时间戳仅可通过 verbose_json 获取,字幕文件需自行基于时间戳合成;其四,格式兼容性因提供商而异:wav 是覆盖最广的安全默认选项,而 mp3 等压缩格式可生成更小、更快的传输负载。一段持续数小时的游戏通宵录音,单次调用显然无法覆盖,必须切片处理。

最后,明确转录能力的适用场景。若仅需将音频转化为纯文本,使用 /audio/transcriptions;若希望模型基于音频内容执行推理任务(如客服通话情感分析、语音问答、或将音频与其他模态共同嵌入提示词),则应选用 /chat/completions 中的 input_audio 内容类型;文本转语音则为第三个独立端点。OpenRouter 的划分极为清晰:要结构化转录稿,走转录端点获取 JSON 文本+用量;要具备音频理解能力的模型,走聊天补全获取完整对话式响应。当一枚密钥同时打通对话与语音,语音能力在应用中的落地门槛,悄然又被削低了一截。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Qt Creator按钮响应设置方法
Qt Creator按钮响应设置方法

信号槽是 Qt 开发的核心机制。本专题整理 Qt Creator 中按钮点击、菜单触发、输入变化、窗口事件、自定义信号、自动连接槽函数和手动 connect 写法,帮助用户理解界面控件如何和 C++ 代码联动。

2026.08.05

0

10

Qt Creator新建项目使用教程
Qt Creator新建项目使用教程

本专题整理 Qt Creator 新建项目、打开已有工程、项目模板选择、目录结构、源文件管理、构建目录、运行配置和项目迁移方法,重点解决新手不知道选 qmake 还是 CMake、项目打不开、文件不参与编译等常见问题。

2026.08.05

0

10

maven常用插件使用大全
maven常用插件使用大全

PHP中文网精心整理Maven主流插件用法合集,涵盖编译、测试、打包等常用插件使用大全。从基础配置到进阶实战,详细解析各插件功能与适用场景,助你轻松掌握Maven自动化构建,解决Java项目开发痛点,是开发者必备的实用指南。

2026.08.05

0

31

PyCharm快速入门指南
PyCharm快速入门指南

本专题汇总了PyCharm快速入门的全套指南与教程,涵盖从官网下载安装、创建第一个Python项目、配置虚拟环境,到代码编辑、运行调试等基础操作,并整理了版本控制(Git)集成、常用高效快捷键及实用插件等进阶技巧,助你快速上手这款高效的Python IDE。

2026.08.05

2

17

PyCharm运行程序教程大全
PyCharm运行程序教程大全

本专题汇总了PyCharm运行程序的多种方式与详细操作步骤,涵盖通过主菜单Run、点击工具栏绿色三角图标、使用快捷键Shift+F10(或Ctrl+Shift+F10)等基本运行方法,以及配置运行/调试参数、设置PYTHONPATH环境变量、管理多脚本运行与交互式Python控制台调试等进阶技巧,助您全面掌握在PyCharm中高效运行与管理Python程序的方法。

2026.08.05

0

14

Maven零基础入门教程
Maven零基础入门教程

本合集由PHP中文网精心整理,提供Maven零基础入门到完整使用的保姆级教程。内容涵盖环境安装、核心配置、仓库管理及项目构建等核心知识点。通过详细步骤解析与代码示例,助你快速掌握Maven的依赖管理与自动化构建,轻松解决Java项目中的各种痛点,是新手入门与进阶的必备指南。

2026.08.05

2

18

Maven安装及配置教程
Maven安装及配置教程

本合集由PHP中文网精心整理,提供Maven安装配置与环境配置详情指南。内容涵盖Maven下载、解压安装、环境变量配置、阿里云镜像加速及本地仓库修改等全流程。教程通俗易懂,帮助开发者轻松解决依赖管理难题,快速掌握Maven核心构建技能,是Java开发者的必备实战指南。

2026.08.05

2

24

Selenium WebDriver元素定位与页面操作教程
Selenium WebDriver元素定位与页面操作教程

本专题整理Selenium WebDriver元素定位、XPath、CSS Selector、等待机制、窗口切换、Frame处理、Alert弹窗、Cookie操作和文件上传等核心用法。

2026.08.05

8

26

Selenium Grid分布式测试与并行执行教程
Selenium Grid分布式测试与并行执行教程

本专题整理Selenium Grid架构、远程WebDriver、并行测试、Docker部署、Kubernetes动态Grid、浏览器矩阵和测试环境扩展方法,适合进阶自动化测试团队使用。

2026.08.05

4

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.4万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 131.8万人学习