go调用通义千问api可行但需手动处理http细节：必须用指定base_url、bearer认证、正确模型名、input.prompt+history结构（history为小写key的对象数组）、分结构解析成功/错误响应、限流防429、记录request_id。
Go 直接调用通义千问 API 是可行的，不需要 SDK，但必须手动处理 HTTP 请求头、请求体结构和错误响应解析——官方没提供 Go SDK，这点和 Python/Java 不同。
确认 base_url 和认证方式
通义千问 DashScope API 的 Go 调用依赖两个硬性配置：正确的 endpoint 和 Authorization 头格式。不匹配会导致 401 Unauthorized 或 404 Not Found。
-
base_url必须是https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation（不是兼容 OpenAI 的/compatible-mode/v1） -
Authorization头值为Bearer sk-xxx，注意是Bearer前缀，不是API-Key或其他形式 - 不要漏掉
Content-Type: application/json - 模型名必须写对，比如
qwen-turbo、qwen-plus、qwen-max，大小写敏感，拼错会返回InvalidParameter.Model
构造符合 DashScope 规范的 JSON 请求体
DashScope 的 Go 接口不接受 OpenAI 风格的 messages 数组，而是要求 input.prompt + input.history 结构，且 history 是字符串数组而非对象数组。
-
prompt字段是必需的，不能为空或纯空格 -
history是可选字段，类型为[]map[string]string，但实际 DashScope API 期望的是形如[{"role":"user","content":"xxx"},{"role":"assistant","content":"yyy"}]的数组 —— 注意 key 名必须小写，且role只支持user和assistant - 如果传了
parameters，里面temperature、top_p等需为 float64 类型，整数（如0）会触发InvalidParameter.Temperature - 完整示例字段结构：
{"model":"qwen-plus","input":{"prompt":"你好","history":[]},"parameters":{"temperature":0.8}}
正确解析响应与错误
成功响应和失败响应结构不同，直接 json.Unmarshal 到统一 struct 容易 panic。必须先检查 resp.StatusCode，再按需解码。
- 成功时状态码是
200，响应体含output.text、usage.input_tokens、request_id - 失败时状态码通常是
400、401、429，响应体是{"code":"xxx","message":"yyy","request_id":"zzz"}，不能和成功结构共用一个 struct - 建议定义两个 struct：
TongYiSuccessRsp和TongYiErrorRsp，分别解码 - 别忽略
defer resp.Body.Close()，否则连接会泄漏
避免 token 超限与频率限制
Go 程序默认没有重试和限流逻辑，高频调用容易触发 TooManyRequests 错误（HTTP 429），尤其在本地快速循环测试时。
- DashScope 对免费账号有每分钟 60 次、每小时 1800 次的默认限制，超限后返回
Throttling.RateQuotaExceeded - 建议在 client 层加简单 sleep（如
time.Sleep(2 * time.Second)）或使用golang.org/x/time/rate限速 - 注意
input_tokens + output_tokens总和不能超过模型最大上下文（如qwen-turbo是 8192），否则报InvalidParameter.InputLengthExceeded - 日志里务必打印
request_id，出问题时阿里云工单必须提供它才能查到真实请求链路
最易被忽略的是 history 字段的结构兼容性：DashScope 文档写的是“字符串数组”，但实际接口接受的是 role/content 对象数组；很多 Go 示例代码照抄 Python 版本却没改字段名大小写，导致静默失败返回空结果。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
