PHP8.2怎么对接兼容OpenAI格式的国产大模型-php教程-PHP中文网

PHP 8.2 可通过复用 OpenAI SDK 请求结构、替换 endpoint 和认证方式对接通义千问等国产大模型，无需重写业务逻辑；需确认平台支持 OpenAI 兼容接口（如 /v1/chat/completions），并正确配置 base_uri 与 Authorization header。

php8.2怎么对接兼容openai格式的国产大模型

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 客户端避免冲突。

?️ 手动 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 :`（需签名）	实际需按腾讯云签名规则构造 Authorization header，不直接兼容；建议用其官方 PHP SDK
零一万物 Yi	`https://api.lingyiwanwu.com/v1/chat/completions`	`Authorization: Bearer`	完全 OpenAI 兼容，可直接用 `openai-php/client`
月之暗面 Kimi	`https://api.kimi.moonshot.cn/v1/chat/completions`	`Authorization: Bearer`	同样完全兼容，支持 `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）