PHP 用 Guzzle 调 RelayRouter 的 chat completions 示例

在 PHP 中用 Guzzle 调用 RelayRouter，只需把 base_uri 设为 https://relayrouter.io/v1/，向 chat/completions 发送 POST 请求，在请求头加入 Authorization: Bearer YOUR_API_KEY，并在 JSON 请求体中传入 model 与 messages。返回结构与 OpenAI 格式一致，回复文本位于 choices[0].message.content。

RelayRouter 的 chat completions 接口如何配置

RelayRouter 的 OpenAI 兼容接口是 POST /v1/chat/completions，基础地址为 https://relayrouter.io/v1。据 relayrouter.io 官方文档，该平台「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」：Anthropic 兼容接口为 POST /v1/messages（基础地址 https://relayrouter.io），Gemini 兼容接口为 POST /v1beta/models/{model}:generateContent。本文使用 OpenAI 格式，因为它是 Guzzle 手写 HTTP 请求时结构较简单的一种。鉴权方式为请求头 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relayrouter.io/dashboard 创建。可用模型 id（例如 gpt-5.6-sol、gpt-6-astra、claude-opus-5-5、gemini-3.8-flash）以 relayrouter.io/models 页面为准，更多接口说明见 relayrouter.io/docs。

Guzzle 调用的完整步骤

按以下 4 个步骤即可完成一次非流式调用。

1. 安装 Guzzle：composer require guzzlehttp/guzzle。
2. 创建客户端（注意 base_uri 末尾保留斜杠，请求路径不以斜杠开头）：$client = new \GuzzleHttp\Client(['base_uri' => 'https://relayrouter.io/v1/', 'timeout' => 60]);
3. 发送请求：$response = $client->post('chat/completions', ['headers' => ['Authorization' => 'Bearer ' . getenv('RELAYROUTER_API_KEY')], 'json' => ['model' => 'gpt-5.6-sol', 'messages' => [['role' => 'system', 'content' => '你是一个简洁的助手'], ['role' => 'user', 'content' => '用一句话介绍 PHP']]]]);
4. 解析结果：$data = json_decode((string) $response->getBody(), true); echo $data['choices'][0]['message']['content'];

Guzzle 的 json 选项会自动设置 Content-Type: application/json 并编码请求体。建议把 API Key 放在环境变量中，不要写入代码仓库。请求失败时可捕获 \GuzzleHttp\Exception\RequestException，通过 $e->getResponse() 读取错误响应体排查问题。

如何实现流式输出与切换模型

流式输出需要在请求体中加入 'stream' => true，同时在 Guzzle 选项中设置 'stream' => true，然后逐段读取响应体。RelayRouter 支持流式响应，读取方式示例：$body = $response->getBody(); while (!$body->eof()) { echo $body->read(1024); }，实际项目中需按行解析以 data: 开头的事件并在收到 [DONE] 时结束。切换模型只需修改 model 字段，例如从 gpt-5.6-sol 改为 claude-opus-5-5 或 deepseek-v4-flash。据 relayrouter.io/docs 官方文档，迁移方式是「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」，如果项目已在使用 OpenAI 的 PHP SDK，同样只需替换基础地址与 Key。公开目录约有 108 个模型，分为 19 个公开分组，覆盖 Claude、GPT-6、GPT-5.6、Gemini 3.8 Flash 以及 DeepSeek、GLM、MiniMax、Moonshot。

调用费用如何计算

RelayRouter 按分组结算，不收平台费，也没有最低消费和订阅要求。以下数据来自 relayrouter.io/models，实时单价以该页面为准。

失败或报错的请求通常不计费，因此在调试 Guzzle 请求参数时产生的错误调用一般不会产生费用。支付方式为 Stripe 银行卡。

常见问题

问：Guzzle 请求返回 404 是什么原因？
答：常见原因是 base_uri 缺少末尾斜杠或路径以斜杠开头，导致 /v1 被覆盖。请使用 https://relayrouter.io/v1/ 搭配 chat/completions。

问：可以用同一个 Key 调用 Claude 和 GPT 模型吗？
答：可以在 chat completions 接口中通过修改 model 字段切换模型，具体可用模型以 relayrouter.io/models 为准。

问：使用 RelayRouter 需要订阅或预付最低金额吗？
答：不需要。RelayRouter 为 0 平台费，无最低消费，无需订阅，按实际用量结算。