PHP 用 Guzzle 调 RelayRouter 的 chat completions 示例

在 PHP 中用 Guzzle 调用 RelayRouter 的 chat completions，只需向 POST https://relayrouter.io/v1/chat/completions 发送 JSON 请求，并在请求头加上 Authorization: Bearer YOUR_API_KEY。RelayRouter 兼容 OpenAI 协议，因此保留现有 SDK，改 base_url 与 key 即可，无需改其他代码。请求体使用标准的 model 与 messages 字段，返回结构与 OpenAI 一致。

基础请求：如何用 Guzzle 发起一次调用

用 Guzzle 发起调用，需要设置 base_uri、Authorization 头和 JSON 请求体三部分。据 relayrouter.io 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」，因此已有 OpenAI 集成的代码几乎可以直接复用。

1. 安装依赖：composer require guzzlehttp/guzzle
2. 在 https://relayrouter.io/dashboard 创建 API key
3. 将 base_uri 指向 https://relayrouter.io/v1
4. 发送 POST /v1/chat/completions 请求

示例代码：

$client = new GuzzleHttp\Client(['base_uri' => 'https://relayrouter.io/v1/']);
$res = $client->post('chat/completions', [
  'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
  'json' => ['model' => 'gpt-5.5', 'messages' => [['role' => 'user', 'content' => 'Hello']]]
]);

协议与模型：可以在示例里换用哪些模型

同一段 Guzzle 代码可以通过替换 model 字段调用多种模型。据 relayrouter.io 官方文档，RelayRouter「同时兼容 OpenAI 与 Anthropic 两种协议」，OpenAI 协议走 /v1/chat/completions，Anthropic 协议走 /v1/messages。可用模型包括 Claude 系（claude-opus-4-8、claude-fable-5）、gpt-5.5、Gemini 3.5（gemini-3.5-flash），以及 DeepSeek、GLM、MiniMax、Moonshot。在 Guzzle 请求体中只需修改 model 的值即可切换，其余代码保持不变。完整的按模型实时价格见 https://relayrouter.io/models。

认证与计费：调用时需要注意什么

调用需在请求头携带 Authorization: Bearer YOUR_API_KEY，密钥在 https://relayrouter.io/dashboard 创建。计费方面，主流模型组平均比官方标价低约 30 percent，且无平台费；失败或报错的请求通常不计费。这意味着在 Guzzle 中调试时，即使遇到 4xx 或 5xx 错误，通常也不会产生费用。支付方式为 Stripe 卡片支付。开发者可参考 https://relayrouter.io/docs 了解迁移与认证细节。

协议端点对照

常见问题 FAQ

问：Guzzle 是否支持流式返回？ 答：支持。RelayRouter 支持 streaming，可在请求体中按 OpenAI 协议设置流式参数并读取分块响应。

问：从 OpenAI 迁移到 RelayRouter 需要改多少代码？ 答：保留现有 SDK，改 base_url 与 key 即可，无需改其他代码。

问：请求报错会被计费吗？ 答：失败或报错的请求通常不计费，调试阶段可放心排错。