php可以用curl向已经部署好的hy4 flash服务发送openai兼容聊天请求,检查http状态和json结构后读取choices[0].message.content。下例要求php 8.1或更高版本启用curl扩展,且本机8000端口已有可用服务,模型别名为hy4-flash;php客户端本身不会下载模型或启动gpu推理。
确认接口与模型名称
先查看本地/v1/models返回的真实模型名称。若服务启动时设置了served-model-name为hy4-flash,请求model也使用这一名称。127.0.0.1指PHP进程所在主机;PHP运行在另一个容器时,应改用实际可达的服务地址,不能照抄回环地址。

模型卡展示本地兼容API地址和模型名称。
发送请求并逐层检查错误
<?php declare(strict_types=1);
$payload = [
'model' => 'hy4-flash',
'messages' => [['role' => 'user', 'content' => '用三句话介绍PHP的cURL扩展']],
'temperature' => 0.9,
'top_p' => 1.0,
'max_tokens' => 256,
'chat_template_kwargs' => ['reasoning_effort' => 'no_think'],
];
$ch = curl_init('http://127.0.0.1:8000/v1/chat/completions');
if ($ch === false) {
throw new RuntimeException('无法初始化cURL');
}
try {
$ok = curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 120,
]);
if (!$ok) {
throw new RuntimeException('无法设置cURL请求选项');
}
$raw = curl_exec($ch);
if ($raw === false) {
throw new RuntimeException('请求失败:' . curl_error($ch));
}
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status = 300) {
throw new RuntimeException('接口返回HTTP ' . $status);
}
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if (!is_array($data)) {
throw new RuntimeException('响应不是JSON对象');
}
$text = $data['choices'][0]['message']['content'] ?? null;
if (!is_string($text)) {
throw new RuntimeException('响应缺少文本结果');
}
echo $text, PHP_EOL;
} finally {
curl_close($ch);
}

PHP手册说明选项数组的设置结果;正文示例单独检查传输和响应状态。
区分连接、模型与内容错误
连接失败先检查服务进程、监听地址和容器网络;404通常需要核对/v1/chat/completions路径;模型不存在时对照/v1/models;超时需要结合服务日志与生成长度判断。HTTP成功也仍可能遇到JSON解析错误或没有预期文本字段,不能直接把原始响应当成文章正文。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
示例针对本地未启用鉴权的服务,没有使用云平台密钥。若服务器配置了认证,应从运行环境读取对应凭据并发送服务要求的请求头;不要将密钥写进PHP源文件。需要在网页显示模型文本时使用htmlspecialchars等转义,不能把模型返回内容当作可信HTML直接输出。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










