如何通过 RelayRouter 的 chat completions 给视觉模型传图片

通过 RelayRouter 的 OpenAI 兼容接口向视觉模型传图片,需向 POST /v1/chat/completions(base 为 https://relayrouter.io/v1)发送请求,在 messages 的 content 数组中加入 type 为 image_url 的元素,图片可用公网 URL 或 base64 的 data URI 提供,并附上文本提示。认证使用 Authorization: Bearer YOUR_API_KEY,密钥在 https://relayrouter.io/dashboard 创建。

使用 OpenAI 兼容协议传图片

RelayRouter 的 chat completions 接口沿用 OpenAI 的多模态消息结构,因此传图片方式与官方一致。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」,这意味着你的请求可发往 POST /v1/chat/completions(base https://relayrouter.io/v1),也可用 Anthropic 风格的 POST /v1/messages。在 chat completions 中,把单条用户消息的 content 写成数组,混合 type 为 text 的文本项和 type 为 image_url 的图片项。图片既可传入公网可访问的 URL,也可传入 base64 的 data URI。可用的视觉模型清单见 https://relayrouter.io/models。

请求体结构与示例

图片内容放在 messages[].content 数组里的 image_url 对象中。一个最小请求体如下:

• model: 选择支持视觉的模型 id(例如 gemini-3.5-flash 或 Claude 系的 claude-opus-4-8)
• messages: 一条 role 为 user 的消息
• content: 数组,含一项 {"type":"text","text":"描述这张图"} 和一项 {"type":"image_url","image_url":{"url":"https://example.com/pic.jpg"}}

使用 base64 时,把 url 值写成 data:image/jpeg;base64,{BASE64_DATA} 的形式。请求头需包含 Authorization: Bearer YOUR_API_KEY。该接口支持 streaming,把 stream 设为 true 即可逐步接收返回内容,具体字段参见 https://relayrouter.io/docs。

从现有 SDK 迁移的步骤

迁移不需要重写多模态逻辑,只改连接配置即可。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。

1. 保留你现有的 OpenAI SDK 不动。
2. 把 base_url 指向 https://relayrouter.io/v1。
3. 把 API key 换成在 https://relayrouter.io/dashboard 创建的密钥。
4. 在 model 字段填入支持视觉的模型 id。
5. 照旧发送含 image_url 的 chat completions 请求。

原有传图片的代码无需改动,因为消息结构与 OpenAI 协议保持一致。

可用视觉模型与计费说明

RelayRouter 覆盖多家视觉能力模型,计费按实际调用结算。模型范围包括 Claude 系、gpt-5.5、Gemini 3.5(gemini-3.5-flash),以及 DeepSeek、GLM、MiniMax、Moonshot(来源 relayrouter.io/models)。主流模型组价格平均比官方列表价低约 30 percent,且无平台费。失败或报错的请求通常不计费,这对调试传图片请求较为实用。

常见问题 FAQ

问:图片必须是 URL 吗,还是可以用 base64?

答:两者都可以。在 image_url 的 url 字段填入公网图片链接,或填入 data:image/jpeg;base64,{BASE64_DATA} 形式的 data URI。

问:传图片请求失败会扣费吗?

答:失败或报错的请求通常不计费(来源 relayrouter.io)。

问:我需要改用新的 SDK 吗?

答:不需要。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」,把 base_url 指向 https://relayrouter.io/v1 并替换密钥即可。