API 参考

地址与鉴权

API 基础地址：https://api.aithauma.com/v1。使用 Authorization: Bearer 请求头携带你的 Thauma API Key。不要将密钥写入公开仓库、前端代码或分享链接。

在 API 页面创建和管理密钥，每个账户最多可创建 1,000 条。为不同应用分别创建密钥；不再使用时撤销。创建时的预算单位以弹窗说明为准。

文本请求示例

以下为 Chat Completions 示例。将环境变量设为自己的密钥，并从目录复制模型名。执行请求会产生实际用量。

curl https://api.aithauma.com/v1/chat/completions \
  -H "Authorization: Bearer $THAUMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"你好"}],"stream":false}'

协议与错误排查

Chat Completions、Responses、Anthropic Messages 和图片接口的协议并不相同。客户端能配置 Base URL，不代表所有工具调用或模型协议自动兼容。接入前先验证目标接口。

401：检查密钥是否有效；403：检查权限；429：降低并发并采用退避重试；模型相关错误：核对调用名称与渠道可用性。超时或 5xx 时保留请求时间及请求 ID，先确认是否已生成结果。

统计页面可按网页端或具体 API Key 筛选。不要把网页端免费次数或 Pro 无限基础模型权益当作 API 免费额度。