PHP连接Google_AI平台详细操作_PHP使用云AI服务【操作】-php教程-PHP中文网

PHP调用Vertex AI必须通过REST API；需用OAuth2 access token构造Authorization头，请求体为JSON格式instances数组，URL含正确project_id、location和endpoint_id。

php连接google_ai平台详细操作_php使用云ai服务【操作】

PHP 本身不直接支持 Google AI Platform（现为 Vertex AI），官方 SDK 仅提供 Python、Java、Go、Node.js 客户端，google/apiclient 也不包含 Vertex AI 的专用服务类。想用 PHP 调用，必须走 REST API —— 这是唯一可行路径，别浪费时间找“PHP SDK”。

怎么调用 Vertex AI 的 `predict` 接口（以 TextGenerationModel 为例）

Vertex AI 的模型预测统一走 https://us-central1-aiplatform.googleapis.com/v1/projects/{project_id}/locations/{location}/endpoints/{endpoint_id}:predict（注意末尾的 :predict 冒号）。关键不是写对 URL，而是构造合法的 Authorization 头和请求体：

Authorization: Bearer {access_token} —— 必须用短期有效的 OAuth2 access token，不能用 service account key file 直接签名请求体
请求体是 JSON，instances 字段必须是数组，即使只发一条；每个 instance 是对象，字段名取决于模型，如 text 或 prompt
必须显式设置 Content-Type: application/json，否则返回 400
PHP 中推荐用 curl_setopt_array() 统一配置，避免漏掉 CURLOPT_RETURNTRANSFER 导致返回 null

如何安全获取 `access_token`（不用硬编码私钥）

把 service account key JSON 文件内容直接读取并调用 Google OAuth2 令牌端点换 token，是最轻量、最可控的方式。别用 google/auth 的 ApplicationDefaultCredentials —— 它在 PHP CLI 环境下会尝试找 GOOGLE_APPLICATION_CREDENTIALS 环境变量，但 Web 环境（如 Apache/Nginx）根本不可靠，且无法指定 scope。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

scope 固定为 https://www.googleapis.com/auth/cloud-platform，少一个字符都会报 invalid_scope
用 file_get_contents("sa-key.json") 读取后 json_decode()，提取 client_email 和 private_key
JWT 签名必须用 openssl_sign() + SHA256，且 header 要含 "alg": "RS256" 和 "typ": "JWT"
token endpoint 是 https://oauth2.googleapis.com/token，POST 数据中 grant_type 必须是 urn:ietf:params:oauth:grant-type:jwt-bearer

常见 403/404 错误对应的真实原因

这类错误几乎从不因为代码写错，而是权限或资源配置问题：

403 PERMISSION_DENIED：service account 没有 roles/aiplatform.user 角色，或者项目/位置/endpoint ID 写错（注意 endpoint ID 是纯数字字符串，不是完整 resource name）
404 NOT_FOUND：URL 中 locations/{location} 不匹配模型部署位置（如模型在 us-east1 却写了 us-central1），或 endpoint ID 根本不存在（Vertex AI 控制台里看 “Endpoint ID”，不是模型名称）
400 Invalid JSON payload：instances 不是数组、字段名拼错（如用了 input_text 而非 text）、没设 Content-Type
429 Rate Limit Exceeded：免费 tier 默认 QPS 极低（常为 1），别用 sleep(0.1) 模拟重试，应检查配额页面是否启用了对应 region 的 Vertex AI API

真正卡住人的永远不是 PHP 语法，而是 Google Cloud 的权限链（IAM → Service Account → Role → Endpoint Resource）、JWT 签名细节（比如 base64url 编码必须去掉 +// 并补 =）、以及 endpoint URL 中 location 和 ID 的严格匹配 —— 这三处出错，日志里几乎不提示具体哪错了。