· 接入文档 控制台

Qiutian AI 接入文档

企业级 AI 模型 API 聚合平台。一个密钥直连 Claude、GPT、Gemini、Grok 等主流大模型,兼容 OpenAI 与 Anthropic 接口格式,按官方价格计费。

快速开始

三步接入:

  1. 控制台 免费注册账号(邮箱 + 密码即可,无需邀请码 / 验证码);
  2. 进入「API 密钥」页面创建一把密钥(形如 sk-xxxxxxxx);
  3. 充值余额后,把下面的 Base URL 和密钥填入你的代码即可调用。
项目
API Base URLhttps://api.qiutian.io
OpenAI SDK base_urlhttps://api.qiutian.io/v1
Anthropic SDK base_urlhttps://api.qiutian.io
鉴权方式请求头 Authorization: Bearer <你的密钥>
现有工具链(Claude Code、各类 OpenAI/Anthropic SDK)无需改造,只需把 Base URL 指向本平台、把密钥换成你的 Qiutian AI 密钥。

认证

所有接口通过请求头携带密钥进行认证:

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.jsonenv 字段长期生效。

CC-Switch(Claude Code / Codex 供应商切换器)

用于在多个供应商之间一键切换的桌面工具。打开后「新增供应商」,填入本平台信息:

供应商名称Qiutian AI
Base URL / API 地址https://api.qiutian.io
API 密钥 / Tokensk-你的密钥
模型(可选)claude-opus-4-8 / claude-sonnet-5
保存后点击切换到该供应商,CC-Switch 会自动把 Claude Code 的 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 URLhttps://api.qiutian.io/v1
API Keysk-你的密钥
Model IDgpt-5.5 / claude-sonnet-5

Cherry Studio / NextChat / LobeChat 等客户端

通用做法:在「模型服务 / 供应商」里新增一个 OpenAI 类型服务:

API 地址 / Base URLhttps://api.qiutian.io(部分客户端需填到 /v1
API 密钥sk-你的密钥
模型手动添加 gpt-5.5claude-opus-4-8 等,或点「获取 / 管理模型」自动拉取
通用规律:任何支持「OpenAI 兼容 / 自定义 Base URL」的工具都能接入 —— OpenAI 类填 https://api.qiutian.io/v1,Anthropic 类填 https://api.qiutian.io,密钥用你的 sk- 密钥。

模型列表

下列为部分常用模型,完整实时列表请调用 GET/v1/models(需携带密钥)。

Claude(Anthropic)

claude-opus-4-8claude-opus-4-8-thinking claude-sonnet-5claude-sonnet-4-6 claude-haiku-4-5claude-fable-5

GPT(OpenAI)

gpt-5.6-solgpt-5.6-terragpt-5.5 gpt-5.4gpt-5.4-minigpt-image-2

Gemini / Veo(Google · 图像与视频)

gemini-3-pro-imagegemini-3.1-flash-image veo_3_1_t2v_fast_8s

Grok(xAI)

grok-4.3-betagrok-4.3-fast grok-4.20-expertgrok-4.20-fast

开源模型(DeepSeek · MiniMax · Kimi)

deepseek-3.2deepseek-v4-pro minimax-m3kimi-k2.6kimi-k2.7-code

计费与充值

本平台采用预付费模式,按各模型官方 API 价格计费(输入 / 输出 / 缓存分项计价,无额外加价),实时从账户余额扣减。

错误码与限流

HTTP含义处理建议
401密钥无效或缺失检查 Authorization 头与密钥是否正确、是否被停用
402 / 余额不足账户余额不足前往控制台充值
429触发速率限制降低并发 / 请求频率后重试
5xx上游或网关异常稍后重试;持续异常请联系我们
每把密钥可在控制台单独设置额度、并发与可用模型范围,适合团队多项目分账与权限隔离。

联系我们

技术支持与商务合作:wei@qiutian.io