DEVELOPER · QUICK START

快速开始

概述

鹊桥 AI 是一个自建的 AI API 中转站。你只需一个 API Key，就能在国内直连调用全球主流大模型——无需梯子。接口完全兼容 OpenAI 格式，原有代码几乎零改动即可迁移。

当前已接入 DeepSeek（deepseek-chat / deepseek-reasoner）。Kimi、通义千问、豆包、GPT、Claude、Gemini、Grok 标记「即将接入」，上线后同一套接口即可调用。

Base URL

所有请求发往以下地址（兼容 OpenAI 路径）：

https://api.queqiao.cloud/v1

例如聊天补全接口：POST https://api.queqiao.cloud/v1/chat/completions

认证

在请求头中携带 API Key（即你在鹊桥后台创建的令牌）：

Authorization: Bearer sk-你的令牌

令牌以 sk- 开头。在控制台 → 令牌中创建，可设置额度上限与模型分组。

第一次调用

用 cURL 发一条最简单的聊天请求：

curl https://api.queqiao.cloud/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的令牌" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

返回结构与 OpenAI 完全一致，可直接用官方 SDK 解析。

流式输出

加上 "stream": true 即可逐字返回，首字延迟更低、体感更快：

{
  "model": "deepseek-chat",
  "stream": true,
  "messages": [{"role": "user", "content": "用一句话解释量子纠缠"}]
}

获取 API Key

登录控制台 api.queqiao.cloud
左侧「令牌」→ 点击「添加令牌」
设置名称、额度（可设无限）、可用模型分组
创建后复制以 sk- 开头的完整 Key（只显示一次，请妥善保存）

Key 是访问凭据，请勿提交到代码仓库或公开页面。如泄露，在控制台立即重置。

下一步：查看可用模型 →