17370845950

PHP调用SenseNova多模态接口需手动构造multipart/form-data HTTP请求，严格满足鉴权、白名单、二进制图片上传及平级字段格式要求，无官方SDK支持。

SenseNova 是商汤科技推出的 AI 大模型平台，但截至 2025 年底，**官方未开放 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


------boundary--

你用 PHP 构造时，name="text" 和 name="image" 必须是平级字段，不能包在 input 里。

返回结果解析要小心 content-type 和编码

成功响应的 Content-Type 是 application/json，但部分环境（尤其 Nginx + PHP-FPM）可能被代理篡改为 text/plain，导致 json_decode() 返回 null。

• 务必检查 curl_getinfo($ch, CURLINFO_CONTENT_TYPE)，不是只看 HTTP 状态码
• 响应体开头若有 BOM（\xEF\xBB\xBF），json_decode() 也会失败，需用 trim($raw, "\x00..\x1F\x7F") 清理
• 生成的图片 URL 是临时直链（带签名），30 分钟过期，不能长期缓存；若需持久化，得自己 file_get_contents() 下载再保存

商汤的多模态接口文档颗粒度粗，PHP 示例缺失，真正跑通的关键不在代码长短，而在是否严格对齐 multipart 边界、鉴权时机、以及白名单状态——这三处任一出错，都会静默失败，连错误码都未必返回。