常见问题

QiyuanHub 接入与使用过程中的常见问题解答（含 Claude Code / Codex 等客户端）。

Base URL 是什么？

QiyuanHub 的 OpenAI 兼容端点为：`https://api.qiyuanapi.cc/v1`。所有兼容 OpenAI SDK 的客户端，只需替换 baseURL 与 apiKey 即可接入。

OpenAI / Codex 兼容：必须带 `/v1`，例如 `https://api.qiyuanapi.cc/v1`
只填 Host（`https://api.qiyuanapi.cc`）且客户端不会自动拼 `/v1` 时，容易 404
Claude Code 等 Anthropic 风格客户端：按对应文档设置 `ANTHROPIC_BASE_URL`，Key 仍用本站 `sk-opc-...`

如何获取 API Key？

1. 注册并登录控制台

访问网站注册账号，使用邮箱验证码完成注册。

2. 等待审核（如适用）

新用户默认 status 为 pending，审核通过后可创建 API Key。

3. 创建密钥

进入控制台 → API 密钥 → 创建 API 密钥，复制 sk-opc- 开头的密钥（仅显示一次）。

常见错误码

unauthorized：API Key 缺失、格式错误或已禁用
application_pending：账号尚未审核通过
model_not_allowed / model_unavailable：模型 slug 写错、未上线，或当前 Key 无权限
quota_exceeded：钱包余额或 Key 配额不足
rate_limited：触发平台或 Key 级限流
key_expired：API Key 已过期，请重新创建
ip_not_allowed：当前 IP 不在该 Key 白名单内

如何计费？

对话模型按 Token 计费（输入、输出、缓存命中单价不同，详见「模型 & 定价」）。思考内容也按输出 token 计费。每次成功调用后从钱包扣减，可在「使用日志」核对明细。

失败请求一般不计费（以状态 success 且产生费用为准）
长上下文重复前缀可能命中缓存，按缓存价计费（若模型配置了缓存价）
API Key 分组倍率会乘到最终费用上（以控制台分组说明为准）

支持哪些模型？

deepseek-v4.1：平台自营的唯一对话模型。编码、Agent、深度推理，原生多模态（可传图片），上下文 1,048,576（1M），默认开思考（可用 reasoning_effort 调深浅或关闭）
2026-09-12 起下线的名字：deepseek-v4、qwen3.8-flash、qwen-0810、qwen-image、qwen-image-edit。生图自 2026-09-16 起换成 seedream-5.0-pro(所有账号可用)。再调用会返回 404 并在报错里列出当前可用模型；把客户端里的模型名改成 deepseek-v4.1 即可，密钥不用换
图像生成用 seedream-5.0-pro：只支持 POST /v1/images/generations（填到对话接口会 400）。三种用法：文生图 = prompt + size；图生图 = prompt + image（参考图 URL，一张给字符串、多张给数组，最多 14 张）；图层拆分 = image + layer_decomposition: true（不用 prompt，返回一张合成图加多张 PNG 图层，**每张图层都按张计费**，一次约十几张）。size 填 1K / 2K 或具体宽高（92 万～462 万像素，4K 暂不支持）；watermark 默认不加，要加传 true；output_format 可选 jpeg（默认）/ png；出图一律以 b64_json 返回、不提供 URL；不支持 stream。计费：≤ 261 万像素 ¥0.3/张，> 261 万像素 ¥0.6/张，参考图每张另计 ¥0.02。看图识图（OCR、截图问答）用 deepseek-v4.1，见「图片理解」
以控制台与定价页 slug 为准，不要填客户端内置的官方模型名（如 gpt-*、claude-*）

长上下文表现如何？可以放心塞长文档吗？

可以。deepseek-v4.1 单会话上下文 1,048,576 token，2026-09-12 上线当天我们在自己的部署上做了实测。

超长请求的瓶颈是首次响应时间，不是准确率。若对延迟敏感，可先做检索再问答，或把长材料放在对话开头让后续轮次全部命中缓存。

59 万 token 输入：首次请求 54 秒返回，答案准确；同一份材料再问一次，命中前缀缓存后 1.2 秒返回。
6 万 token 输入：首次 3.5 秒，第二次 0.2 秒（缓存命中 99.9%）。
响应时间随输入长度线性增长，准确率不随位置衰减。
成本提示：重复前缀按缓存价计费（¥0.04 / 百万 token，约为全价的 1/50），多轮追问同一份材料很划算。

明明选的是某个模型，使用日志里为什么会出现别的模型？

这是 Claude Code / 部分 Agent 客户端的正常行为，不是账号被盗，也不是平台乱扣费。

想核对：打开控制台 → 使用日志，按时间查看模型名与费用。

客户端会在后台做「起会话标题」「压缩超长历史」等小事，往往会换一个更便宜、更快的模型
派生 Subagent（如 Explore、general-purpose 等）可在各自配置里指定不同模型，与主对话所选模型无关
若额外费用只有几分到几毛，一般可忽略；若突然出现大额异常调用，再到使用日志按时间核对，并联系支持

新建对话时为什么会自动出现一笔小额调用？

Claude Desktop / Claude Code 在你发出第一条消息后，常会用便宜小模型自动生成会话标题（左侧历史列表那一行字）。这与主对话模型无关，通常金额极小，可忽略。

Claude Code 配置了网关仍走官方 API？

确认 ANTHROPIC_API_KEY 已设为空字符串
执行 claude /logout 清除 OAuth 缓存
在 Claude Code 内执行 /status 检查 Base URL
检查 shell 配置文件中是否有冲突的环境变量
若用 CC Switch：确认当前启用的是 QiyuanHub 供应商，而不是官方 Anthropic

Claude Code 提示无法连接到 Anthropic 服务？

首次安装后若出现 `Unable to connect to Anthropic services` / `Failed to connect to api.anthropic.com`，多为尚未完成官方 onboarding，可跳过并强制标记已完成：

同时请确认已按「Claude Code 配置」文档设置 ANTHROPIC_BASE_URL 指向本站，且 ANTHROPIC_API_KEY 为空字符串。

# 需已安装 jq；没有则先: brew install jq
jq '. + {"hasCompletedOnboarding": true}' ~/.claude.json > /tmp/tmp.json && mv /tmp/tmp.json ~/.claude.json

# 然后重新启动 claude

如何在 VS Code 的 Claude Code 插件中使用 QiyuanHub？

先保证本机 Claude Code CLI 已按文档配好并能正常对话，再配置插件：

`primaryApiKey` 的值应与你在 settings / 供应商里使用的名称一致；若你用 CC Switch 导入的名称不同，请改成实际名称。

1. 打开配置目录

Windows：Win+R，输入 `%userprofile%\.claude`
macOS：访达 Command+Shift+G，输入 `~/.claude`

2. 编辑或创建 config.json

写入以下内容后保存，并重启 VS Code：

{
  "primaryApiKey": "QiyuanHub"
}

Claude Code 如何切回 200K 上下文并减少非必要流量？

若希望从 1M 上下文切回 200K，并关闭部分遥测 / 非必要请求，可在 `~/.claude/settings.json` 的 `env` 中合并以下配置（不要覆盖已有 ANTHROPIC_* 令牌）：

关闭 Git 状态注入（`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`）可减少系统提示词频繁变化导致的缓存失效，对按量计费更省钱
改完后重启 Claude Code 再验证 `/status`

{
  "env": {
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
    "DISABLE_AUTOUPDATER": "1",
    "DISABLE_TELEMETRY": "1",
    "DISABLE_BUG_COMMAND": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS": "1"
  }
}

Claude Code 常用命令

`claude` — 在当前目录启动交互式对话
`claude -p "问题"` — 一次性问答后退出，适合脚本
`claude -c` — 继续当前目录最近一次会话
`claude --model <slug>` — 指定模型（请用本站定价页 slug）
`claude /logout` — 清除 OAuth，避免绕过网关
`claude update` — 更新 CLI
`claude mcp` — 管理 MCP 服务器

如何开启流式输出？

const stream = await client.chat.completions.create({
  model: "deepseek-v4.1",
  messages: [{ role: "user", content: "写一首诗" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

为什么开了联网搜索还是搜不到？

QiyuanHub 不提供服务端联网搜索——我们是纯推理端点，不会代替你去互联网上搜索。客户端里的「服务端搜索 / 内置联网」开关对本站不生效，把它关掉、改用客户端自带的网页搜索即可正常联网。

这不是某个模型的限制，换任何模型结果都一样
若客户端硬发 Anthropic 原生 web_search 工具，会在参数校验阶段被拒，返回 400 且提示 Input should be 'function'
各客户端（DSH / Cherry Studio / ChatBox 等）的具体开法见「联网搜索」页

如何获取帮助？

请通过社区渠道或项目维护者联系支持。提交问题时请附上：请求时间、模型名、错误码、request_id（如有）及脱敏后的 API Key 前缀。也可先查阅「接入排查」与对应客户端文档。

{ "env": { "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1", "DISABLE_AUTOUPDATER": "1", "DISABLE_TELEMETRY": "1", "DISABLE_BUG_COMMAND": "1", "DISABLE_ERROR_REPORTING": "1", "CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS": "1" } }

const stream = await client.chat.completions.create({ model: "deepseek-v4.1", messages: [{ role: "user", content: "写一首诗" }], stream: true, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content || ""); }