开发者福利！Conatus Free 限时活动融合模型接口上线，聚合多个顶级大模型能力，0 计费，标准 Chat Completions 返回格式，支持推理内容返回，适合个人开发、Agent 调试、代码助手、知识库原型、测试场景。
活动周期：10.24 — 11 月 30 日，到期恢复正常计费，需要的抓紧接入。
✅ 接口亮点
- 模型标识：
qiniu/conatus-free，API ID：205 - 零费用：price=0，免费活动模型，不扣余额、积分
- 返回标准 OpenAI chat.completion 结构，自带
reasoning_content推理字段 - 混合鉴权：支持 API Key / APP_ID+APP_SECRET 两种方式
- 支持调试入口调用：
/api/v1/calls/invoke - 自带完善错误码体系，鉴权、限流、额度、上游报错分类清晰，方便后端做异常处理
📌 基础调用信息
- 接口地址：
https://api.xiaotuo.net/Conatus - 请求方式：POST
- Content-Type：application/json
- 模型名：
qiniu/conatus-free（不传默认使用该模型）
请求示例
{
"model": "qiniu/conatus-free",
"messages": [
{"role":"user","content":"写一段Python快速排序代码"}
]
}
成功返回示例
{
"id": "chatcmpl-36b3f243decc47649831ab3c2968fcc5",
"object": "chat.completion",
"created": 1793544147,
"model": "qiniu/conatus-free",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "排序代码...",
"reasoning_content": "思考过程..."
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 6,
"completion_tokens": 140,
"total_tokens": 146,
"completion_tokens_details": {
"reasoning_tokens": 54
}
}
}
📋 鉴权说明
混合鉴权 hybrid，二选一即可：
- 方式 1：API Key 鉴权
- 方式 2：APP_ID + APP_SECRET 鉴权
鉴权失败返回 100/101/130~133 等错误码，HTTP 401
⚠️ 限流与额度规则（重点）
- 免费并非无限调用，存在每日免费额度 quotaLimit，额度耗尽返回错误码
106（403） - 全站免费总上限用尽返回
10006（429） - 短时间请求频率过高触发限流，返回
10005（429），响应头携带 Retry-After - 子密钥单独配置日限额，打满返回
114
📖 完整错误码简要汇总
表格
| 错误码 | 说明 | HTTP 状态码 |
|---|---|---|
| 100 | API Key 为空 | 401 |
| 101 | Key 鉴权失败 | 401 |
| 106 | 免费日额度耗尽 | 403 |
| 10005 | 请求频繁限流 | 429 |
| 10006 | 全站免费次数用完 | 429 |
| 20001 | 上游服务失败 | 502 |
| 20002 | 上游超时 | 504 |
完整文档包含全部错误码、字段说明，文末附带完整文档。
🧩 适用场景
- 个人开发者低成本调试 Agent、代码助手
- 本地 AI 客户端、知识库、插件快速对接
- 课程演示、原型验证、小流量测试
- 需要拿到模型推理内容（reasoning_content）的场景
⚠️ 重要提醒
- 活动截止至 11 月底，到期后免费资格失效，不再支持 0 元调用；
- 免费额度用完直接报错，不会自动扣费；
- 上游模型存在不稳定、超时、异常返回场景，业务上线务必做好降级、重试、异常捕获；
- 仅用于合规场景，禁止违规内容生成。
