最简方式是用curl调/v1/chat/completions接口:POST请求,Header含Authorization: Bearer sk-xxx和Content-Type: application/json,Body中指定model、messages数组(至少一个user消息),temperature设0.7。
直接用 curl 调 OpenAI 的 /v1/chat/completions 接口是最轻量、最可控的方式,不需要装 SDK,也不依赖第三方包——只要 PHP 支持 curl(默认开启),5 分钟就能跑通。
OpenAI 当前主力接口是 /v1/chat/completions,必须用 POST,Content-Type: application/json,且请求头带 Authorization: Bearer sk。别用
-xxx/v1/completions(已逐步弃用,不支持 system 角色)。
关键点:
model 必须显式指定,比如 "gpt-4o" 或 "gpt-3.5-turbo",不能留空messages 是数组,至少含一个 {"role": "user", "content": "..."};加 {"role": "system", "content": "..."} 可约束行为temperature 建议设为 0.7 左右,太低会死板,太高易胡说 'gpt-3.5-turbo',
'messages' => [
['role' => 'system', 'content' => '你是一个简洁的助手,只回答核心内容,不加解释。'],
['role' => 'user', 'content' => 'PHP 中如何检测一个变量是否为数组?']
],
'temperature' => 0.7
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer ' . $api_key
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code === 200) {
$result = json_decode($response, true);
echo $result['choices'][0]['message']['content'] ?? '';
} else {
echo "HTTP {$http_code}: " . ($response ?: 'Unknown error');
}
?>
这是最常卡住的地方,不是密钥写错就是格式不对:
sk- 开头的密钥是否完整复制,有无多余空格或换行(建议先 var_dump(trim($api_key)) 看一眼)Authorization: Bearer sk-xxx,不是 Bearer: sk-xxx 或漏了 Bearer 前缀OpenAI 对免费试用额度和每分钟请求数有限制(例如新账号默认 3 RPM)。不是代码问题,而是配额耗尽或触发限流:
sleep(1) 是最简单的缓解方式,但治标不治本;生产环境应加队列或退避重试逻辑messages 数组传入,比逐条发更省 quotaRetry-After header,应解析并遵守绝不能硬编码在 PHP 文件里,尤其上线后:
.env 文件 + getenv() 或 $_SERVER 注入(推荐 vlucas/phpdotenv,但即使不用它,也至少从外部读取).env(Nginx 加 location ~ \.env { deny all; })php -S 启动本地服务,密钥走 $_ENV 或 putenv()
真正麻烦的不是第一次调通,而是没处理好流式响应(stream: true)、超时、token 截断、中文乱码(确保 response header 有 Content-Type: application/json; charset=utf-8)、以及密钥轮换后的自动刷新机制——这些在简单 demo 里全被掩盖了。