腾讯云AI绘画API无官方PHP SDK，需手动封装HTTP请求，Region必须为ap-beijing、Endpoint固定为https://aigc.tencentcloudapi.com，签名用HMAC-SHA256，请求体字段Prompt/NegativePrompt/Size/ModelId须严格符合格式，ResultUrl为30分钟临时链接须及时下载保存。
腾讯云 AI 绘画 API 没有官方 PHP SDK
直接调用腾讯云「AI 绘画」接口（即 TencentCloud\Aigc\V20220721\Client 所属服务）时，你会发现官方文档里只提供了 Python/Java/Go/Node.js 的示例，PHP 官方 SDK 目前不包含 AIGC 服务模块。这不是你配置错了，是 SDK 确实没同步更新。
所以别浪费时间搜 composer require tencentcloud/aigc——它不存在。得自己封装 HTTP 请求，用通用的 TencentCloud\Common\Credential + TencentCloud\Common\Profile\HttpProfile 拼出合规签名请求。
- 必须手动构造
X-TC-Action、X-TC-Version、X-TC-Timestamp、X-TC-Nonce和Authorization头 - 请求体必须是 JSON，且
ContentType设为application/json; charset=utf-8 - 签名算法用的是
HMAC-SHA256，不是 MD5 或简单拼接，漏掉任意一步都会返回InvalidParameter.SignatureIncorrect
POST /v20220721/TextToImage 必须带 Region 和 Endpoint
腾讯云 AIGC 接口不是全局可用的，目前仅限 ap-beijing 地域开通，且 Endpoint 固定为 https://aigc.tencentcloudapi.com。哪怕你账号主体在广州或上海，也得把 Region 写死成 ap-beijing，否则会报错 UnsupportedRegion 或直接 404。
常见错误是照抄 CVM 或 COS 的 region 写法，比如用 ap-guangzhou 或留空，结果请求发到不存在的后端。
立即学习“PHP免费学习笔记（深入）”；
- Endpoint 只能是
https://aigc.tencentcloudapi.com，不能替换成https://aigc.ap-beijing.tencentcloudapi.com -
Region参数在签名和请求头中都需显式传ap-beijing - 请求 URL 路径固定为
/v20220721/TextToImage，大小写敏感，少一个斜杠或字母都会 404
text_to_image 请求体字段容易填错的三个点
接口要求传 Prompt（正向提示词），但实际生效还依赖 NegativePrompt、Size 和 ModelId 的组合。很多人卡在“没报错但图不生成”，其实是字段名或值不合法。
-
Prompt是字符串，不是数组；中文要 UTF-8 编码，不能含控制字符（如 \x00），否则返回InvalidParameterValue.Prompt -
Size必须是"1024:1024"、"768:768"或"512:512"三者之一，写成"1024x1024"或1024*1024会触发InvalidParameterValue.Size -
ModelId当前只有"stable-diffusion-xl"和"wanx-v1"可用，填错（如"sd-xl"或空字符串）会返回InvalidParameterValue.ModelId
示例正确片段：
{"Prompt":"一只柴犬穿宇航服，赛博朋克风格","NegativePrompt":"模糊，低质量，文字","Size":"1024:1024","ModelId":"stable-diffusion-xl"}
返回的 ResultUrl 是临时链接，30 分钟失效
API 成功响应后返回的 ResultUrl 是预签名临时地址，不是永久 CDN 链接。直接存库或前端直连，过期后就 403。很多人以为拿到 URL 就万事大吉，结果第二天页面全裂图。
生产环境必须立刻下载并保存到自有存储（如 COS 或本地磁盘），不能跳过这步。
- 用
file_get_contents($resultUrl)下载时记得加stream_context_create(['http'=>['timeout'=>30]])，避免大图超时 - 下载后建议校验
Content-Type是否为image/png或image/jpeg，防止腾讯返回错误 HTML 页面（偶发网关错误） - 不要依赖
ResultUrl做前端 img src，必须中转一次，否则用户刷新页面就挂
真正难的不是调通第一次，而是处理异步失败、重试策略、URL 过期、模型切换兼容这些细节。腾讯云这个接口文档里没写的坑，基本都在这儿了。
