Qiutian AI 接入文档
企业级 AI 模型 API 聚合平台。一个密钥直连 Claude、GPT、Gemini、Grok 等主流大模型,兼容 OpenAI 与 Anthropic 接口格式,按官方价格计费。
快速开始
三步接入:
- 在 控制台 免费注册账号(邮箱 + 密码即可,无需邀请码 / 验证码);
- 进入「API 密钥」页面创建一把密钥(形如
sk-xxxxxxxx); - 充值余额后,把下面的 Base URL 和密钥填入你的代码即可调用。
| 项目 | 值 |
|---|---|
| API Base URL | https://api.qiutian.io |
| OpenAI SDK base_url | https://api.qiutian.io/v1 |
| Anthropic SDK base_url | https://api.qiutian.io |
| 鉴权方式 | 请求头 Authorization: Bearer <你的密钥> |
认证
所有接口通过请求头携带密钥进行认证:
Authorization: Bearer sk-你的密钥
对话接口 · OpenAI 兼容
POST/v1/chat/completions
cURL
curl https://api.qiutian.io/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"messages": [{"role": "user", "content": "你好,介绍一下你自己"}]
}'
Python(openai SDK)
from openai import OpenAI
client = OpenAI(
api_key="sk-你的密钥",
base_url="https://api.qiutian.io/v1",
)
resp = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "写一首关于秋天的诗"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: "sk-你的密钥",
baseURL: "https://api.qiutian.io/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.4",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);
"stream": true 即可,返回 SSE 事件流,与 OpenAI 官方行为一致。对话接口 · Anthropic 兼容
POST/v1/messages — 适用于 Claude 官方 SDK 与 Claude Code。
cURL
curl https://api.qiutian.io/v1/messages \
-H "x-api-key: sk-你的密钥" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你好"}]
}'
Python(anthropic SDK)
from anthropic import Anthropic
client = Anthropic(
api_key="sk-你的密钥",
base_url="https://api.qiutian.io",
)
msg = client.messages.create(
model="claude-opus-4-6",
max_tokens=1024,
messages=[{"role": "user", "content": "介绍一下量子计算"}],
)
print(msg.content[0].text)
开发工具接入
本平台兼容 OpenAI 与 Anthropic 接口格式,主流 AI 编程 / Agent 工具无需改造,只需把 Base URL 指向本平台、把密钥换成你的 Qiutian AI 密钥。下方 sk-你的密钥 均替换为你在控制台创建的密钥。
Claude Code
Anthropic 官方 CLI,走 /v1/messages,建议搭配 Claude 模型。设置环境变量后直接运行 claude:
export ANTHROPIC_BASE_URL="https://api.qiutian.io"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"
export ANTHROPIC_MODEL="claude-opus-4-8"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"
claude
ANTHROPIC_MODEL;后台轻量任务用 ANTHROPIC_SMALL_FAST_MODEL。也可写进 ~/.claude/settings.json 的 env 字段长期生效。CC-Switch(Claude Code / Codex 供应商切换器)
用于在多个供应商之间一键切换的桌面工具。打开后「新增供应商」,填入本平台信息:
| 供应商名称 | Qiutian AI |
| Base URL / API 地址 | https://api.qiutian.io |
| API 密钥 / Token | sk-你的密钥 |
| 模型(可选) | claude-opus-4-8 / claude-sonnet-5 等 |
ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN(Codex 则写入 ~/.codex/config.toml)指向本平台,无需手动改环境变量。Codex
OpenAI Codex CLI。编辑 ~/.codex/config.toml,新增一个自定义模型供应商:
model = "gpt-5.5"
model_provider = "qiutian"
[model_providers.qiutian]
name = "Qiutian AI"
base_url = "https://api.qiutian.io/v1"
env_key = "QIUTIAN_API_KEY"
wire_api = "chat"
再设置密钥环境变量并运行:
export QIUTIAN_API_KEY="sk-你的密钥"
codex
OpenCode
在项目根 opencode.json(或全局 ~/.config/opencode/opencode.json)配置供应商:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"qiutian": {
"npm": "@ai-sdk/openai-compatible",
"name": "Qiutian AI",
"options": {
"baseURL": "https://api.qiutian.io/v1",
"apiKey": "sk-你的密钥"
},
"models": {
"gpt-5.5": {},
"claude-sonnet-5": {},
"claude-opus-4-8": {}
}
}
}
}
运行 opencode,在模型选择里选 qiutian/gpt-5.5 等即可。
Cline / Roo Code(VS Code 插件)
在插件设置里选 API Provider = OpenAI Compatible,填:
| Base URL | https://api.qiutian.io/v1 |
| API Key | sk-你的密钥 |
| Model ID | gpt-5.5 / claude-sonnet-5 等 |
Cherry Studio / NextChat / LobeChat 等客户端
通用做法:在「模型服务 / 供应商」里新增一个 OpenAI 类型服务:
| API 地址 / Base URL | https://api.qiutian.io(部分客户端需填到 /v1) |
| API 密钥 | sk-你的密钥 |
| 模型 | 手动添加 gpt-5.5、claude-opus-4-8 等,或点「获取 / 管理模型」自动拉取 |
https://api.qiutian.io/v1,Anthropic 类填 https://api.qiutian.io,密钥用你的 sk- 密钥。模型列表
下列为部分常用模型,完整实时列表请调用 GET/v1/models(需携带密钥)。
Claude(Anthropic)
GPT(OpenAI)
Gemini / Veo(Google · 图像与视频)
Grok(xAI)
开源模型(DeepSeek · MiniMax · Kimi)
计费与充值
本平台采用预付费模式,按各模型官方 API 价格计费(输入 / 输出 / 缓存分项计价,无额外加价),实时从账户余额扣减。
- 余额以美元(USD)计价,可在控制台查看实时用量与逐条账单;
- 充值支持 支付宝(桌面扫码 / 手机端一键唤起)与 QRIS(印尼)扫码支付:充值金额按美元计入余额,支付时按汇率换算为对应本地货币;
- 亦支持兑换码充值;余额不足时相关请求将被拒绝(见错误码)。
错误码与限流
| HTTP | 含义 | 处理建议 |
|---|---|---|
| 401 | 密钥无效或缺失 | 检查 Authorization 头与密钥是否正确、是否被停用 |
| 402 / 余额不足 | 账户余额不足 | 前往控制台充值 |
| 429 | 触发速率限制 | 降低并发 / 请求频率后重试 |
| 5xx | 上游或网关异常 | 稍后重试;持续异常请联系我们 |
联系我们
技术支持与商务合作:wei@qiutian.io