PHP调用SenseNova多模态接口需手动构造multipart/form-data HTTP请求，严格满足鉴权、白名单、二进制图片上传及平级字段格式要求，无官方SDK支持。
SenseNova 是商汤科技推出的 AI 大模型平台，但截至 2024 年底，**官方未开放 PHP SDK，也未提供直接支持多模态图文生成（如“奇策”创作模型）的 PHP 客户端封装**。你无法像调用 curl_init() 那样简单几行就发图+文请求并拿到结果。
下面说清楚怎么在 PHP 环境里“实际走通”这条路：
PHP 调用 SenseNova 多模态接口必须走 HTTP 请求（非 SDK）
商汤只提供了 Python/Java/Go 的参考示例和 OpenAPI 文档，PHP 没有现成 sensennova-sdk-php。你得自己拼 POST 请求，且必须满足以下条件：
- 使用
curl或file_get_contents()+stream_context_create()发送带multipart/form-data的请求（图文混合必须用这种格式） - 请求头必须包含：
Authorization: Bearer和Content-Type: multipart/form-data; boundary=...（不能硬写application/json） - 必须先调用鉴权接口获取
access_token，该 token 有 1 小时有效期，需缓存复用 - “奇策”模型目前仅对白名单用户开放，
model参数填"qice"或"qice-v1"会返回403 Forbidden，除非你已通过商汤后台开通权限
上传图片必须 Base64 编码或二进制流，不能传本地路径
很多人卡在这步：把 /var/www/img/test.jpg 直接当参数传，结果 API 返回 "image data is empty"。SenseNova 接口不认文件路径，只认原始字节或 Base64 字符串。
- 推荐方式：读取图片为二进制，用
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data)提交（$post_data是用curl_file_create()构造的） - 备选方式：用
base64_encode(file_get_contents($img_path))，然后放在 JSON body 里（但注意：部分多模态接口只接受multipart，Base64 会报错invalid image format） - 图片尺寸建议 ≤ 1024×1024，超大会被截断或拒绝，且不返回明确提示
请求体结构容易错：text 和 image 必须同级、不可嵌套
错误写法（常见于照搬 Python 示例）：
{"input": {"text": "画一只猫", "image": "data:image/png;base64,..."} } —— 这是纯文本接口格式，不是多模态。
正确 multipart 格式（以 curl 命令为参照，PHP 需模拟）：
------boundary Content-Disposition: form-data; name="text" 一只戴墨镜的柴犬 ------boundary Content-Disposition: form-data; name="image"; filename="dog.png" Content-Type: image/png你用 PHP 构造时，------boundary--
name="text" 和 name="image" 必须是平级字段，不能包在 input 里。
返回结果解析要小心 content-type 和编码
成功响应的 Content-Type 是 application/json，但部分环境（尤其 Nginx + PHP-FPM）可能被代理篡改为 text/plain，导致 json_decode() 返回 null。
立即学习“PHP免费学习笔记（深入）”；
- 务必检查
curl_getinfo($ch, CURLINFO_CONTENT_TYPE)，不是只看 HTTP 状态码 - 响应体开头若有 BOM（
\xEF\xBB\xBF），json_decode()也会失败，需用trim($raw, "\x00..\x1F\x7F")清理 - 生成的图片 URL 是临时直链（带签名），30 分钟过期，不能长期缓存；若需持久化，得自己
file_get_contents()下载再保存
