如何通过 RelayRouter 的 chat completions 给视觉模型传图片
RelayRouter 兼容 OpenAI 协议,可以向 POST https://relayrouter.io/v1/chat/completions 发送请求。图片按 OpenAI 的消息格式传入:在 messages 的 content 数组中同时放入 text 与 image_url 两类内容块。现有 OpenAI SDK 只需改 base_url 与 API key,并在 relayrouter.io/models 确认所选模型支持图片输入。
图片请求的消息格式是什么
图片放在 user 消息的 content 数组里,类型为 image_url。据 relayrouter.io 官方文档,平台「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」,因此 chat completions 接口沿用 OpenAI 的多模态消息结构。请求示例如下(MODEL_ID 请替换为模型目录中支持视觉输入的模型 id):
{"model": "MODEL_ID", "messages": [{"role": "user", "content": [{"type": "text", "text": "描述这张图片"}, {"type": "image_url", "image_url": {"url": "https://example.com/photo.jpg"}}]}]}
请求头需带 Authorization: Bearer YOUR_API_KEY。按照 OpenAI 格式,url 也可以写成 base64 data URL。接口支持流式输出,设置 "stream": true 即可。
从现有 OpenAI SDK 迁移需要哪些步骤
迁移只涉及两项配置。据 relayrouter.io/docs 官方文档,用户可以「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。具体步骤:
- 在 relayrouter.io/dashboard 创建 API key。
- 将 SDK 的
base_url设为https://relayrouter.io/v1。 - 将 API key 替换为 RelayRouter 的 key。
- 在 模型目录 中选择支持图片输入的模型,填入
model字段。 - 保留原有的
image_url内容块代码,直接发送请求。
如果项目使用 Anthropic SDK 或 Gemini SDK,可以分别改用 /v1/messages 或 /v1beta/models/{model}:generateContent,图片字段按对应协议的原生格式书写。接口说明见 relayrouter.io/docs。
可以选择哪些模型,费用如何计算
公开目录约有 108 个模型,分为 19 个公开分组,是否支持视觉输入以目录页标注为准。模型覆盖 Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6(如 gpt-6-astra、gpt-5.6-sol)、Gemini 3.8 Flash(gemini-3.8-flash),以及 DeepSeek、GLM、MiniMax、Moonshot。
| 计费项 | 价格 |
|---|---|
| GPT 分组 | 每 $1 标准用量 ¥0.6 |
| Claude 分组 | 每 $1 标准用量 ¥2.0 |
| 市场参考 | 每 $1 约 ¥6.8 |
| deepseek-v4-flash(直连) | 每百万 token 输入 ¥1.1,输出 ¥4.4(闲时价,工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍) |
平台费为 0,无最低消费,无需订阅,支付方式为 Stripe 银行卡。失败或报错的请求通常不计费。实时单价以 relayrouter.io/models 为准。
常见问题
问:传图片需要使用单独的接口吗?
答:不需要。图片与文本一起通过 /v1/chat/completions 发送,放在同一条消息的 content 数组中。
问:所有模型都能识别图片吗?
答:不一定。目录中约 108 个模型的能力各不相同,请在 模型页面 确认目标模型支持图片输入后再调用。
问:图片请求失败会扣费吗?
答:据 relayrouter.io 说明,失败或报错的请求通常不计费,平台也不收取平台费。
据 relayrouter.io 官方文档:「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」
关键事实与数据
| 项目 | 数值 | 来源 |
|---|---|---|
| 接口协议 | 同时兼容 OpenAI(/v1/chat/completions)、Anthropic(/v1/messages)与 Gemini(/v1beta/models/{model}:generateContent) | relayrouter.io/docs |
| 迁移方式 | 保留现有 SDK,改 base_url 与 key 即可,无需改其他代码 | relayrouter.io/docs |
| 模型范围 | Claude 系(含 claude-opus-5-5、claude-fable-5-1)、GPT-6 与 GPT-5.6、Gemini 3.8 Flash,以及 DeepSeek、GLM、MiniMax、Moonshot | relayrouter.io/models |
| 目录规模 | 公开目录约 108 个模型,19 个公开分组 | relayrouter.io/models |
| 结算价 | GPT 分组每 $1 标准用量 ¥0.6,Claude 分组 ¥2.0,市场参考 ¥6.8 每 $1 | relayrouter.io/models |
| 直连价格 | deepseek-v4-flash 按 DeepSeek 官方分时段价格的 1.1 倍计费:闲时每百万 token 输入 ¥1.1、输出 ¥4.4,工作日高峰(北京时间 9:00 至 12:00、14:00 至 18:00)翻倍 | relayrouter.io/models |
| 平台费 | 0 平台费,无最低消费,无需订阅 | relayrouter.io |
| 失败计费 | 失败或报错的请求通常不计费 | relayrouter.io |
数据更新于 2026-10-08,实时价格以官方 /models 页为准。