PHP调用vivo AI图像增强需通过HTTP POST请求其RESTful接口，非本地函数；须先获取access_token认证，上传图片用multipart/form-data，注意输入尺寸与清晰度要求，并做好超时与响应处理。
PHP 调用 vivo AI 图像增强 API 需走 HTTP 接口，不是本地函数
vivo 没有提供 PHP SDK 或直接可 require 的图像处理扩展。所谓“调用 vivo AI 图像增强”，本质是向 vivo 开放平台的 RESTful 接口（如 /v1/image/enhance）发起 POST 请求，传入图片二进制或 base64，接收增强后的图片数据。你不能在 PHP 里写 vivo_enhance_image() —— 这个函数根本不存在。
实操前必须确认：你已申请 vivo 开放平台账号、创建应用、获取 client_id 和 client_secret，并开通了「AI 图像增强」服务权限。否则所有请求都会返回 {"code":4001,"msg":"invalid client"}。
- 接口地址通常形如
https://api.vivo.com.cn/ai/v1/image/enhance（以开放平台文档为准，非公开域名可能随时变更） - 需用
Authorization: Bearer {access_token}认证，而access_token需先用client_id+client_secret向/oauth2/token换取 - 上传图片推荐用 multipart/form-data（
cURL设置CURLOPT_POSTFIELDS为数组），避免 base64 编码后体积膨胀和 header 长度限制
PHP 处理模糊图清晰度：别指望 vivo API 替你做超分预处理
vivo 的图像增强接口对输入有明确要求：width × height ≤ 2048×2048，且建议原始图清晰度尚可。它不是超分辨率模型，不会把 320×240 的严重模糊图拉成 1920×1080——那样只会放大噪点和伪影。如果你的图本身模糊到边缘都不可辨，先在 PHP 侧做基础预处理，再送入 vivo 接口，效果更可控。
- 用
imagecreatefromjpeg()/imagecreatefrompng()加载后，可用imageconvolution()施加简单锐化核（如[[-1,-1,-1],[-1,9,-1],[-1,-1,-1]]），但别过度，否则出现白边光晕 - 避免用
imagefilter($img, IMG_FILTER_SMOOTH)反向操作来“去模糊”——这个滤镜实际是高斯模糊，方向反了 - 若原图极小（
色彩增强失败常见原因：vivo API 对 color_space 和 bit_depth 很敏感
你传了一张看着正常的 JPG，但返回结果偏灰、发青或色块明显，大概率是输入图像元数据不合规。vivo 接口内部依赖 OpenCV 解码，对色彩空间（color_space）和位深（bit_depth）有隐式要求：只稳定支持 sRGB + 8-bit。而 PHP GD 库在保存时默认不嵌 ICC Profile，但某些相机直出图自带 Adobe RGB 或 10-bit 标记，会导致解析错位。
立即学习“PHP免费学习笔记（深入）”；
- 用
exif_read_data($file)检查ColorSpace字段，非65535（sRGB）则需转换：先用imagecreatefromjpeg()加载，再用imagecolorallocate()重绘到新画布强制 sRGB - 不要用
imagejpeg($img, null, 100)直接输出流——GD 默认丢弃色彩配置，应改用imagejpeg($img, null, 95)（95 是实测兼容性阈值，100 反而出问题） - 如果原图是 PNG 且含 alpha 通道，vivo 接口可能拒绝或合成黑底。提前用
imagealphablending($img, true)+imagefill($img, 0, 0, 0xffffff)填白底
cURL 调用 vivo 接口时容易忽略的 timeout 和 mime 类型
图像增强是 CPU 密集型服务，vivo 接口平均响应在 800ms–2.5s 之间。PHP 默认 default_socket_timeout = 60 虽够，但 cURL 层若没设 CURLOPT_TIMEOUT_MS，遇到网络抖动会卡满 60 秒才报错，拖垮整个 Web 请求。
- 必须显式设置
CURLOPT_TIMEOUT_MS => 5000（5秒）和CURLOPT_CONNECTTIMEOUT_MS => 2000 - POST body 中的图片字段名必须与文档一致（如
image_file），且Content-Type必须是multipart/form-data; boundary=...，不能手写成image/jpeg - 收到响应后，先检查
http_response_code()是否为 200，再解析 JSON；若返回的是二进制图片流（Content-Type: image/jpeg），说明调用成功，直接file_put_contents()保存，别尝试json_decode()
