常见问题

启元Hub 接入与使用过程中的常见问题解答。

Base URL 是什么？

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

如何获取 API Key？

1. 注册并登录控制台

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

2. 等待审核（如适用）

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

3. 创建密钥

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

常见错误码

unauthorized：API Key 缺失、格式错误或已禁用
application_pending：账号尚未审核通过
model_not_allowed：当前账户无权访问该模型
quota_exceeded：钱包余额或 Key 配额不足
rate_limited：触发平台或 Key 级限流
key_expired：API Key 已过期，请重新创建

如何计费？

按 Token 用量计费，不同模型输入/输出单价不同，详见「模型 & 定价」。每次调用完成后从钱包余额扣减，可在「使用日志」查看明细。

支持哪些模型？

qwen3.6：对话、编码、Agent
deepseek-v4：推理、长上下文
embedding：向量检索
更多模型持续上架，以控制台与定价页为准

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

确认 ANTHROPIC_API_KEY 已设为空字符串
执行 claude /logout 清除 OAuth 缓存
在 Claude Code 内执行 /status 检查 Base URL
检查 shell 配置文件中是否有冲突的环境变量

如何开启流式输出？

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

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

如何获取帮助？

请通过社区渠道或项目维护者联系支持。提交问题时请附上：请求时间、模型名、错误码、request_id（如有）及脱敏后的 API Key 前缀。

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