php怎么调用腾讯云AI绘画_api_php如何生成艺术风格图像接口教程-php教程-PHP中文网

腾讯云ai绘画api无官方php sdk，需手动封装http请求，region必须为ap-beijing、endpoint固定为https://aigc.tencentcloudapi.com，签名用hmac-sha256，请求体字段prompt/negativeprompt/size/modelid须严格符合格式，resulturl为30分钟临时链接须及时下载保存。

php怎么调用腾讯云ai绘画_api_php如何生成艺术风格图像接口教程

腾讯云 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 或留空，结果请求发到不存在的后端。

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 的组合。很多人卡在“没报错但图不生成”，其实是字段名或值不合法。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

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 过期、模型切换兼容这些细节。腾讯云这个接口文档里没写的坑，基本都在这儿了。