PHP调用Vertex AI必须通过REST API；需用OAuth2 access token构造Authorization头，请求体为JSON格式instances数组，URL含正确project_id、location和endpoint_id。
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。
- 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 错误对应的真实原因
这类错误几乎从不因为代码写错，而是权限或资源配置问题：
立即学习“PHP免费学习笔记（深入）”；
-
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 的严格匹配 —— 这三处出错，日志里几乎不提示具体哪错了。
