PHP 8.2 可通过复用 OpenAI SDK 请求结构、替换 endpoint 和认证方式对接通义千问等国产大模型，无需重写业务逻辑；需确认平台支持 OpenAI 兼容接口（如 /v1/chat/completions），并正确配置 base_uri 与 Authorization header。
PHP 8.2 对接兼容 OpenAI 格式的国产大模型（如通义千问 Qwen、DeepSeek、腾讯元宝等），核心在于复用 OpenAI SDK 的请求结构 + 替换 endpoint 和认证方式。不需要重写业务逻辑，也不依赖阿里官方 DashScope SDK（它暂未提供 PHP 官方支持）。
✅ 前提条件确认
- PHP 版本 ≥ 8.2（已满足）
- 已开通对应大模型服务（如阿里云 DashScope、腾讯 HunYuan、百度千帆等），获取
API Key和Endpoint - 确认该平台提供 OpenAI 兼容接口（/v1/chat/completions 等路径） —— 阿里云、月之暗面、零一万物等均已开放
? 接入步骤（以阿里云通义千问为例）
阿里云 DashScope 支持 OpenAI 兼容调用，需开启「OpenAI 兼容模式」并在控制台获取专属 endpoint：
- Endpoint 示例：
https://dashscope.aliyuncs.com/compatible-mode/v1 - 认证方式：
Authorization: Bearer YOUR_DASHSCOPE_API_KEY - 模型名传参：
model: "qwen-max"或"qwen-plus"（注意不是 OpenAI 的gpt-4）
使用原生 cURL 或推荐的 openai-php/client（v0.8+）即可：
大模型Token成本节约
下载
大模型 Token 成本节约工具。在请求到达大模型之前自动压缩 prompt 和上下文，减少 60-95% 的 token 消耗，直接降低 API 成本。支持 Claude/OpenAI/Gemini 等主流模型，提供代理模式、CLI 包装、Python SDK 和 MCP Server 四种接入方式。内置一键安...
use OpenAI\Client;
$client = Client::builder()
->withBaseUri('https://dashscope.aliyuncs.com/compatible-mode/v1')
->withHttpHeader('Authorization', 'Bearer sk-xxx') // DashScope API Key
->build();
$completion = $client->chat()->create([
'model' => 'qwen-max',
'messages' => [['role' => 'user', 'content' => '你好']],
'stream' => false,
]);⚠️ 注意：
openai-php/client默认会加/v1后缀，若你的 endpoint 已含/v1（如上例），需手动去掉重复路径，或改用自定义 HTTP 客户端避免冲突。立即学习“PHP免费学习笔记（深入）”；
?️ 手动 cURL 调用（更可控，适合调试）
$endpoint = 'https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions';
$apiKey = 'sk-xxx';
$data = json_encode([
'model' => 'qwen-plus',
'messages' => [['role' => 'user', 'content' => '用 PHP 写一个斐波那契数列函数']],
'temperature' => 0.7,
]);
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $endpoint,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $data,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey,
],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_SSL_VERIFYPEER => false,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'] ?? '';
}? 其他国产模型适配要点
| 平台 | Endpoint 示例 | 认证方式 | 注意事项 |
|---|---|---|---|
| 腾讯 HunYuan | https://hunyuan.tencentcloudapi.com/v1/chat/completions |
Authorization: Bearer <secretid>:<secretkey></secretkey></secretid>（需签名） |
实际需按腾讯云签名规则构造 Authorization header，不直接兼容；建议用其官方 PHP SDK |
| 零一万物 Yi | https://api.lingyiwanwu.com/v1/chat/completions |
Authorization: Bearer <api_key></api_key> |
完全 OpenAI 兼容，可直接用 openai-php/client
|
| 月之暗面 Kimi | https://api.kimi.moonshot.cn/v1/chat/completions |
Authorization: Bearer <api_key></api_key> |
同样完全兼容，支持 qwen-long 类超长上下文模型 |
? 推荐工具链组合
-
HTTP 客户端：
guzzlehttp/guzzle（v7.8+）或原生 cURL（轻量场景） -
SDK 封装：
openai-php/client（v0.8.3+）——需确认是否支持自定义 base_uri 不带/v1 -
生产增强：
- 加
Swoole协程提升并发（如用swoole-llm-bridge插件） - 接入 Laravel 12 的
Illuminate\AI抽象层，统一切换模型驱动 - 使用
Neuron AI框架构建带 Tool Calling 的 PHP Agent（已原生支持 Qwen）
- 加
不复杂但容易忽略的是 endpoint 路径拼接和 header 大小写（如 Authorization 必须首字母大写）。只要对齐 OpenAI JSON 结构，国产模型基本“即插即用”。
