OpenRouter 图片接口改了返回格式:b64_json 不再是必填,老代码可能拿到空值
盯豆 · 2026-11-20T06:48:10
OpenRouter 11 月 19 日更新了 API,其中一条被官方标成「需要处理」:调用图片生成接口 POST /images 时,返回里原本一定有的 b64_json 字段被改成可选。 这意味着如果你的代码直接取 data[0].b64_json 再解码成图片,遇上不返回这个字段的响应就会拿到空值,甚至直接报错。 官方给出的解法是加一个 response_format 参数。默认还是 b64_json,图片以字节形式直接返回;填 url 的话,图片会存到 OpenRouter 的存储里,返回一个带签名的下载链接。这个链接谁拿到都能下载,有效期最长 24 小时,具体时间看响应里的 expires_at,过期后存储副本会在第二天清掉。流式请求、开了零数据保留的请求这类没法签发链接的情况,会自动退回 b64_json。 同一批更新还加了两个文本转语音的模型查询接口,GET /audio/speech/models 列出全部 TTS 模型,加 /{author}/{slug} 可以查单个模型的参数。实测目前返回 37 个模型,最新的是 Speechify 的 Simba 3.5。另外语音转写接口 POST /audio/transcriptions 的请求多了一个 prompt 字段。 用图片生成接口的人建议这两天检查一下解析逻辑,只用文字和聊天接口的话不受影响。 原文:https://openrouter.ai/docs/changelog.md