用户接入与配置指南

快速开始

QwQのapi 提供了与官方完全兼容的 OpenAI 格式和 Anthropic 格式接口。您只需在常用的客户端或开发 SDK 中，将请求地址（Base URL）和 API Key 替换为本站提供的内容即可。

Cursor 接入

Cursor 是一款非常强大的 AI 辅助编程编辑器，通过以下步骤可以快速将本站的多模型网关配置进 Cursor：

1. 打开 Cursor，进入设置页面 Settings -> Models。
2. 在设置选项中关闭 Cursor Tab 之外的其他官方通道。
3. 找到并展开 OpenAI API Key 选项，将本站的 API Key（sk-xxx）填入其中，并点击 Save。
4. 点击下方的 Override OpenAI Base URL，将其修改为：https://qwqzy.top/v1 并保存。
5. 在下方的 Models 列表中，根据需要添加或启用你要使用的模型（如 claude-3-5-sonnet-20241022，gpt-4o 等）。

Claude Code 命令行集成

Claude Code 是 Anthropic 推送的官方终端交互 AI 编码工具。您可以非常容易地通过终端环境变量配置，使其通过 QwQのapi 的网关来调用最新的 Claude 模型：

在您的 shell 配置文件（如 .bashrc 或 .zshrc）中写入以下两行环境变量：

export ANTHROPIC_BASE_URL=https://qwqzy.top
export ANTHROPIC_API_KEY=sk-your-key

保存后在终端运行 source ~/.zshrc 刷新环境，之后直接运行 claude 即可流畅运行官方命令行工具，享受稳定快速的调用。

Cline / Roo Code (VS Code 插件)

如果您在 VS Code 中使用 Cline（前身为 Claude Dev）或 Roo Code 插件进行 Agent 编码，请按照以下方式进行接口对接：

方法 A：选择 OpenAI Compatible 提供商

• API Provider: 选择 OpenAI Compatible。
• Base URL: 填写 https://qwqzy.top/v1。
• API Key: 填写您的本站 Key。
• Model ID: 手动输入你要调用的模型名（如 claude-3-5-sonnet-20241022）。

方法 B：选择 Anthropic 提供商（更推荐，支持 Prompt Caching 提示词缓存）

• API Provider: 选择 Anthropic。
• Base URL: 手动填写 https://qwqzy.top（注意：末尾没有 /v1）。
• API Key: 填写您的本站 Key。
• Cline/Roo Code 将能完全激活 Anthropic 特有的 Prefill 和 Prompt Cache，为您节省高达 90% 的长上下文重复调用费用。

Chatbox / NextChat / OpenCat 等常用工具

对于大部分的通用对话客户端，直接选用 OpenAI 提供商，将 API 地址的 https://api.openai.com 替换为 https://qwqzy.top 即可。

接口地址 (Base URL): https://qwqzy.top
API Key: sk-your-本站密匙
自定义模型: claude-3-5-sonnet-20241022, gpt-4o, gemini-1.5-pro

SDK 开发者接入代码示例

您也可以将此网关直接作为后端上游直接集成到业务代码中。以下是不同语言 SDK 接入本站网关的配置方式：

Python SDK 接入方式

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key-here",
    base_url="https://qwqzy.top/v1"
)

response = client.chat.completions.create(
    model="claude-3-5-sonnet-20241022",
    messages=[
        {"role": "user", "content": "用 Python 写一个快速排序"}
    ]
)
print(response.choices[0].message.content)

Node.js SDK 接入方式

import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: 'sk-your-key-here',
  baseURL: 'https://qwqzy.top/v1',
});

async function main() {
  const chatCompletion = await openai.chat.completions.create({
    messages: [{ role: 'user', content: 'Say hello!' }],
    model: 'gpt-4o-mini',
  });
  console.log(chatCompletion.choices[0].message.content);
}
main();

常见问题 FAQ

1. 为什么接口返回 401 Unauthorized？

请检查填写的 API Key 是否完整无缺，是否有空格被复制。如果 Key 确认无误，请在控制台页面检查该 Key 是否由于触发了额度限制或账户本身余额不足而被暂停。

2. 为什么提示词缓存（Prompt Cache）没有生效？

提示词缓存主要在 Anthropic 接口提供。在使用 Cline 或 Roo Code 等客户端时，必须确保 API Provider 选项被选为 Anthropic 并且 Base URL 字段不带 /v1。如果选用的是 OpenAI 兼容选项，上游提示词缓存机制不会被完全激发。

3. 实际计费扣款规则是什么？

实际调用扣费将按您选择调用的模型单价以及调用时该模型对应的「计费分组」所对应的费率相乘计算。在您的控制台密钥中，也可以对特定 Key 配置消费上限，保护账户额度免受异常循环的损耗。