鹊桥 API
使用教程 · 进阶

能力表

给已经熟悉这些工具的用户:每个分组在三种接口格式下支持什么、和官方有哪些差别,各种工具的地址怎么填。第一次用的,建议先看使用教程里的 5 条推荐路线。

01

地址怎么填

规律:OpenAI 格式填 https://queqiaoapi.com/v1,Anthropic(Claude)格式填 https://queqiaoapi.com。少数工具会自己补 /v1,或者要求带上 /v1,见下表。

各工具的接口地址
工具接口格式地址填什么
Claude CodeAnthropicANTHROPIC_BASE_URL=https://queqiaoapi.com

不带 /v1,带了会报错

CodexOpenAI Responsesbase_url = "https://queqiaoapi.com/v1"

新版 Codex 只支持 Responses(wire_api = "responses")

Cherry StudioOpenAI 或 Anthropichttps://queqiaoapi.com

Cherry 会自己补 /v1;地址末尾不要加 #

OpenCodeOpenAI 兼容 或 Anthropichttps://queqiaoapi.com/v1

两种提供方都带 /v1;自定义提供方要自己写上下文和输出上限

Cline、Kilo CodeOpenAI Compatiblehttps://queqiaoapi.com/v1

最大输出、上下文窗口、图片支持要手动填

ChatboxOpenAIhttps://queqiaoapi.com/v1
NextChatOpenAIhttps://queqiaoapi.com

它会自己补 /v1

LobeChatOpenAI 或 AnthropicOpenAI:https://queqiaoapi.com/v1
Anthropic:https://queqiaoapi.com
DeepSeek HarnessAnthropicDEEPSEEK_BASE_URL=https://queqiaoapi.com

密钥放 DEEPSEEK_API_KEY,用 DeepSeek 分组的密钥

openai 官方库OpenAIbase_url="https://queqiaoapi.com/v1"
anthropic 官方库Anthropicbase_url="https://queqiaoapi.com"

表里的工具不是每个都有本站的详细教程;填完报 405 或 404,多半是 /v1 多了或少了,换另一种写法试试。浏览器里运行的客户端(网页版、手机版)也能用,本站支持跨域请求。

02

分组 × 接口格式

三种格式:Chat Completions(/v1/chat/completions,大多数聊天软件)、Responses(/v1/responses,Codex)、Messages(/v1/messages,Claude Code 等 Claude 格式的工具)。2026-10-27 实测。

✓推荐 / 实测正常!能用,但有差别✕不支持

各分组在三种接口格式下的支持情况
分组Chat CompletionsResponsesMessages
默认分组GPT ✓推理强度、工具调用、缓存都正常 ✓Codex 推荐用法,缓存自动命中 ✓本站转成 GPT 来答(Claude Code 路线 2)。不转发 max_tokens、temperature、top_p;Anthropic 服务端工具只支持网页搜索(改由 GPT 搜索完成)
GPT 特惠GPT,不保证满血 !能用,缓存时有时无 !能用,缓存实测基本不命中,推理强度高低差别不明显 !能用,同默认分组的转换方式
Claude(MAX 满血)官方 Claude !能用。本站自动补 1 小时缓存标记;没写回复上限时按 32000。reasoning_effort 不会打开思考,要思考请用 Messages !Codex 能用:本站自动补缓存标记、补回上一步的思考。Codex 界面会多几行报错提示,思考内容混在回复里显示,不影响结果;联网搜索的域名限制等参数会被忽略 ✓原生格式,推荐。思考签名完整;缓存要在请求里加标记(Claude Code 自己会加)
Claude(Kiro)Claude,更便宜 !能用,reasoning_effort 不起作用;没写回复上限时按 32000 !Codex 能跑,但没有缓存优化,不推荐 ✓Claude Code 能用。思考不带签名,看不到思考过程;没有 sonnet-5-5、haiku-5-5,4.5 系列要用带日期的全名
GeminiVertex 官方 ✓推荐在聊天软件里用;流式请求有时会报错,重试或关掉流式输出即可 !Codex 能跑,但出错较多、缓存不命中,不推荐 ✕不支持,Claude Code 不能用 Gemini
Kimi ✓文字和工具调用正常 !Codex 能完成任务,但较慢,改文件时容易反复失败 ✓Claude Code 实测可用,思考不带签名
DeepSeek ✓不写推理强度时默认思考(high),和官方一致 ✓Codex 实测可用,缓存正常 ✓DeepSeek Harness、Claude Code 实测可用,缓存正常
生图gpt-image ✕不支持 ✕不支持 ✕不支持

生图只支持 /v1/images/generations(生成)和 /v1/images/edits(改图),返回 base64,不支持 response_format 参数;不写代码的可以直接在游乐场里画图。Gemini 还支持原生格式 /v1beta/models/模型名:generateContent,其中 gemini-4-argon 不接受 thinkingBudget。DeepSeek 不支持 stop 停止词和 logprobs。

03

本站对请求做了什么

原则:你明确设置的参数原样转发;只在请求里没写的时候补默认值;和官方不一样的地方都写在这里。

原样转发

你写了的回复上限(max_tokens)、温度、推理强度、思考设置、缓存标记,本站都不改。上游返回的报错原样回给你。

只在没写的时候补

  • Claude 请求没写回复上限:按 32000(OpenAI 格式转成 Claude 时)。
  • 用 OpenAI 格式(Chat Completions、Responses)调 Claude MAX:这两种格式没法写缓存标记,本站自动补 1 小时缓存标记,第二轮起重复的前文按缓存价计费。
  • Codex 调 Claude MAX:本站记下每一步的思考,下一步补回给 Claude。
  • DeepSeek 没写推理强度:按官方默认的 high 思考。

和官方不一样的地方

  • gpt-5.6-luna 目前由 gpt-6.1-sol 提供服务,按 gpt-6.1-sol 的价格计费。
  • 默认分组的密钥在 Claude Code 里填 claude- 开头的模型名,会改用 GPT 来答,不是真 Claude。
  • Claude MAX 的 claude-haiku-5-5 上游暂时不可用时,会由 claude-haiku-4-5 代答,仍按 haiku-5-5 的价格计费。
  • Claude 开着思考时,OpenAI 格式转过来的 temperature、top_p 会被去掉(Claude 不允许同时使用);直接用 Messages 格式传这些参数会收到 400。
  • 同一个对话里中途换 Claude 分组会报签名错误,换分组后请新开对话。
  • Claude 格式(/v1/messages)单次请求最大 10MB,超过会报 413;其他接口以上游的限制为准。
  • 不支持依赖服务端保存对话的用法(previous_response_id、store: true)和 /v1/responses/compact,每次请求请带上完整对话。