三分钟上手
从注册到发出第一条请求,按顺序做完这五步就行。所有客户端都走同一个 OpenAI 兼容地址。
1注册并登录
用 1-12 位字母或数字设置用户名,填写密码即可完成注册。登录后进入会员中心,自动开通默认分组与试用额度。
2充值余额或开通套餐
打开控制台「充值 / 订阅」,两种方式可以同时拥有,按使用习惯选择:
| 方式 | 怎么用 | 适合 |
|---|---|---|
| 充值 | 选金额,微信 / 支付宝付款,按实际用量从余额扣 | 偶尔用、多个模型都想试 |
| 订阅 | 买天卡或月卡,在额度内使用,不扣余额 | 天天用、用量大 |
3创建 API Key
「API 密钥」→「创建密钥」→ 起个名字 → 给要用的模型配分组(不会配就按推荐)→「创建」。创建后可随时停用或删除。
4接到你的工具里
挑一条最省事的路径,接口地址统一是 https://qianniao.tv/v1:
| 你的情况 | 推荐做法 |
|---|---|
| 装了 CC Switch | 用「在 CC Switch 里使用」新增线路并切换 |
| 用 Codex,没装 CC Switch | 用「一键配置 Codex 和 CC Switch」 |
| 用 OpenCode | 写 opencode.json,见「快速接入 OpenCode」 |
| 用 WorkBuddy | 填自定义模型服务,见「快速接入 WorkBuddy」 |
| 自己写代码 | 用右侧通用示例,只改 base_url 与 api_key |
5确认接通了
在工具里发一条简短消息,然后打开控制台「使用记录」。能看到这次请求、走的模型和花费,就说明接通了。报错先对照下方「常见问题」查原因。
四个常用工具怎么接
以下配置里的 sk-qianniao-xxxx 换成你在控制台创建的真实密钥。演示域名上线前请替换为实际服务地址。
✓一键配置 Codex 和 CC Switch
脚本自动识别系统与已装客户端:帮你备份现有配置、写入千鸟线路、可选切换到该线路,随时可撤销。
irm https://qianniao.tv/setup.ps1 | iex
手动配置 Codex CLI(~/.codex/config.toml)
model_provider = "qianniao" [model_providers.qianniao] name = "千鸟聚合API" base_url = "https://qianniao.tv/v1" env_key = "QIANNIAO_API_KEY"
✓在 CC Switch 里使用
打开 CC Switch →「供应商」→「新增」,按下表填写 → 应用到 Codex / Claude Code → 切换到这条线路 → 重启客户端。原有线路不会被覆盖。
名称: 千鸟聚合API Base URL: https://qianniao.tv/v1 API Key: sk-qianniao-xxxx 应用: Codex CLI / Claude Code 模型: openai/gpt-6.2-astra-saver
https://qianniao.tv(不带 /v1);Codex / OpenAI SDK 才带 /v1。✓快速接入 OpenCode
先把密钥写进环境变量,再在项目根目录创建 opencode.json,然后运行 /models 就能看到千鸟下的模型。
# macOS / Linux export QIANNIAO_API_KEY="sk-qianniao-xxxx" # Windows PowerShell $env:QIANNIAO_API_KEY="sk-qianniao-xxxx"
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"qianniao": {
"npm": "@ai-sdk/openai-compatible",
"name": "千鸟聚合API",
"options": {
"baseURL": "https://qianniao.tv/v1",
"apiKey": "{env:QIANNIAO_API_KEY}"
},
"models": {
"openai/gpt-6.2-astra-saver": { "name": "GPT-6.2 Astra Saver" }
}
}
}
}
✓快速接入 WorkBuddy
在 WorkBuddy 的「自定义模型服务 / 模型供应商」里新增一个 OpenAI 兼容服务,填三项即可:Base URL、API Key、模型 ID。保存后选为当前模型,新建任务发一条消息验证。
OPENAI_BASE_URL=https://qianniao.tv/v1 OPENAI_API_KEY=sk-qianniao-xxxx OPENAI_MODEL=openai/gpt-6.2-astra-saver
✓地址速查
| 用途 | 填写的地址 |
|---|---|
| Codex、OpenAI SDK、OpenCode、WorkBuddy | https://qianniao.tv/v1 |
| Claude Code(Anthropic 兼容) | https://qianniao.tv |
| 控制台 / 充值 / 密钥 | https://qianniao.tv/console |