北洛 AI 接入文档

先完成最短测试，再开启高级功能。 本页把地址、认证、模型和高频故障放在最前面；表格用于快速对照，示例用于复制。

先看这里：一眼配置

4 步完成接入

先查模型名

curl https://beiluoxi.top/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

返回的 id 原样复制为 Model。不要猜模型名，也不要把地址写成 /v1/v1。

首屏故障速查

一、购买、兑换、API Key

安全底线： Key 不要放网页前端、截图、群聊、公开仓库或共享配置。

二、协议怎么选

三、工具配置总表

“支持自定义地址”以软件当前版本为准；没有自定义字段时，改用 OpenCode、CC Switch 或其他兼容客户端。

四、国产工具：统一填写

五、海外工具：OpenAI 兼容

Continue 示例

models:
  - name: Beiluo
    provider: openai
    model: YOUR_MODEL
    apiBase: https://beiluoxi.top/v1
    apiKey: YOUR_API_KEY

OpenCode 示例

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "beiluo": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Beiluo OpenAI Compatible",
      "options": { "baseURL": "https://beiluoxi.top/v1", "apiKey": "YOUR_API_KEY" },
      "models": { "YOUR_MODEL": { "name": "YOUR_MODEL" } }
    }
  }
}

六、Claude Code / Anthropic

macOS/Linux：

export ANTHROPIC_BASE_URL="https://beiluoxi.top"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
claude

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://beiluoxi.top"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
claude

官方 Claude Desktop 通常不提供任意 Base URL；需要本站时优先使用 Claude Code、Anthropic SDK、CCS 或支持自定义地址的客户端。

七、Gemini 原生与 Antigravity

curl "https://beiluoxi.top/v1beta/models/MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"你好"}]}]}'

Gemini CLI 若只有 Google 登录、GEMINI_API_KEY 或 Vertex 配置而没有 Custom Endpoint，不能直接套用本站地址。普通 Claude 分组与 Antigravity 分组不要混用。

八、CC Switch（CCS）

官网： ccswitch.io　GitHub： farion1231/cc-switch　下载： Releases

CCS 只负责切换配置，不负责购买、兑换或创建本站 Key；只从官网或官方 GitHub 下载。

九、接口与高级能力

Infinite Canvas（无限画布）

登录控制台后，从左侧菜单进入 无限画布。也可以直接打开 https://canvas.107-149-55-20.sslip.io。首次使用请点击画布右上角的设置按钮，新增或修改 OpenAI 格式渠道：

基本用法：

1. 先在设置中保存渠道，并使用“获取模型”检查 Key 和地址是否正确。
2. 新建画布项目，在画布中添加图片生成节点或从工作台输入提示词。
3. 选择图片模型、尺寸和数量，连接参考图后可进行图生图或图片编辑。
4. 生成结果可以继续拖到画布上编排、对比和下载。
5. 画布、素材、API Key 和生成记录默认保存在当前浏览器；更换浏览器、无痕模式或清理站点数据后需要重新配置。

安全提醒： 不要把完整 API Key 放进截图、提示词、分享链接或群聊。该画图页面由开源第三方项目提供，提示词、参考图和 Key 会由浏览器页面用于请求本站 API；不要上传身份证件、客户资料、未公开设计稿等敏感内容。需要离开内嵌页面时，可点击右上角“新窗口打开”。

十、连接错误原因自检

4xx：客户端错误

用户的问题，不是服务端问题。

• 400 Bad Request： 用户发送的请求格式错误，例如 JSON 语法不对、字段名拼写错误。
• 401 Unauthorized： 用户没有带 API Key，或者 Key 格式错误，例如忘记加 Bearer 前缀。
• 403 Forbidden： 用户的 API Key 无效、已过期、没有额度、没有权限，或者受到 IP 限制。
• 404 Not Found： 用户请求的 URL 路径写错了。
• 413 Payload Too Large： 用户一次发送的内容（文字、图片、上下文）超过了模型的最大限制。
• 429 Rate Limit： 用户请求太快，触发了频率限制，或者账号额度已用完。

5xx：服务端错误

• 500 Internal Server Error： 服务器内部出错。
• 502 Bad Gateway： 服务端网关配置有问题或服务挂了。
• 503 Service Unavailable： 服务器过载、正在排队，暂时处理不了更多请求。
• 504 Gateway Timeout： 服务器处理请求超时，例如模型推理太慢。
• 524 Origin Connect Timeout： Cloudflare 连不上服务器，原因可能是服务器过载、宕机等。

推荐排查顺序

1. GET  /v1/models                    验证 Key、DNS 和网络
2. POST /v1/chat/completions          stream=false 的普通文本
3. 用模型列表中的 id 重试
4. 再开 stream、图片、工具或 Agent
5. 最后切换备用域名或代理

十一、Cloudflare、网络与反代

十二、使用注意事项

十三、完成检查

[ ] 卡密已兑换，余额/额度可见
[ ] Key 来自“API 密钥”页面且未泄露
[ ] OpenAI 使用 https://beiluoxi.top/v1
[ ] Claude 使用 https://beiluoxi.top（不加 /v1）
[ ] Gemini 使用 /v1beta + x-goog-api-key
[ ] Model 从模型列表复制
[ ] 普通文本 stream=false 成功
[ ] 高级功能逐项开启
[ ] 默认地址使用 beiluoxi.top；北美直连使用 beiluoxi.xyz
[ ] CCS 只从官网或官方 GitHub 下载