Go调用AI图片生成需直接使用net/http，不可依赖重封装SDK；Replicate要求Authorization: Token、input为map、轮询获取URL后下载；Hugging Face需Authorization: Bearer、inputs字段、Wait-For-Model头及参数限制；下载时须校验状态码并处理gzip。
Go 语言本身不提供 AI 图片生成能力，所有实际生成必须调用外部模型服务（如 Stable Diffusion API、Replicate、Hugging Face Inference Endpoints 或商业 API），net/http 是最直接、可控的调用方式——别碰封装过重的第三方 SDK，它们常隐藏错误细节、难以调试。
用 http.Post 调用 Replicate 的 stability-ai/sdxl 模型
Replicate 提供免部署的 SDXL 接口，适合快速验证。关键不是“怎么发请求”，而是如何构造合规 payload 并处理响应流：
-
Content-Type必须为application/json，且 payload 中input字段是 map，不能是字符串（常见错误："input": "{\"prompt\":\"...\"}"） - API Token 需放在
Authorization: Token <your-key></your-key>头里，不是 query 参数或 body 字段 - Replicate 返回的是异步预测 ID，需轮询
/v1/predictions/{id}获取结果，不是一次 POST 就拿到图 - 最终返回的
output是 URL 数组，需额外http.Get下载二进制数据并保存为.png
示例片段：
resp, _ := http.Post("https://api.replicate.com/v1/predictions",
"application/json",
strings.NewReader(`{"version":"a00d0b7dcbb9c3f655c985122b1e0217a14b19c31741253101346e701e27f922","input":{"prompt":"cyberpunk cat wearing sunglasses"}}`))
处理 Hugging Face Inference API 的 422 错误
调用 https://api-inference.huggingface.co/models/stabilityai/stable-diffusion-xl-base-1.0 时，422 Unprocessable Entity 最常因以下原因触发：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- payload 缺少
inputs字段（注意：它叫inputs，不是input；Replicate 用input，HF 用inputs） - 未设置
Authorization: Bearer <token></token>（HF 要Bearer，Replicate 要Token） - prompt 超过 512 字符（HF 默认限制，需在 payload 加
"parameters": {"max_new_tokens": 512}） - 未加
Wait-For-Model: trueheader，而模型尚未加载（冷启动时必现）
正确结构：
req, _ := http.NewRequest("POST", hfURL, strings.NewReader(`{"inputs":"a robot dog"}`))
req.Header.Set("Authorization", "Bearer xxx")
req.Header.Set("Wait-For-Model", "true")
避免 io.Copy 直接写文件导致 PNG 损坏
AI 接口返回的图片 URL（如 Replicate 的 output[0]）指向的是原始二进制 PNG/JPEG 流，但 Go 的 http.Get 默认不校验 Content-Type 或解压 gzip。常见损坏原因：
- 服务端启用了 gzip 压缩，但 Go client 未自动解压（默认已启用，但某些代理会干扰）
- 没检查
resp.StatusCode，404 或 500 时io.Copy仍会写空/错误内容到文件 - 没设超时，大图下载卡住整个 goroutine
安全写法：
resp, err := http.DefaultClient.Do(req)
if err != nil || resp.StatusCode != 200 {
log.Fatal("fetch failed:", err, resp.Status)
}
defer resp.Body.Close()
out, _ := os.Create("out.png")
io.Copy(out, resp.Body) // 此时 resp.Body 已是解压后原始字节
真正麻烦的从来不是发请求，而是每个服务商对字段名、认证头、错误码、重试逻辑、限流策略的细微差异——同一段 Go 代码，换家 API 就得改三处 header 和两个字段名。别抽象“通用 AI 调用库”，先盯死一家，跑通再迁移。
