配置教程

三步完成 API 接入

把客户端配置和常用入口集中到一个页面。大多数客户端直接填写推荐 Base URL；只有客户端明确要求完整端点或 Messages 协议时，才使用对应地址。

先购买 API Key查看完整开发文档

第一次接入，按这个顺序完成

先选模型并确认价格，再获取 API Key、复制对应 URL、配置一个客户端，最后发送一条小请求验证链路。

  1. 01选择模型并确认价格

    配置客户端前，先核对模型名称、上下文长度、图片支持情况和计费倍率。

  2. 02准备 API Key

    新用户：先购买并获取 API Key

  3. 03复制正确的 URL

    大多数 OpenAI-compatible 客户端使用此地址

  4. 04填写客户端配置

    请求成功就说明 Base URL、API Key、模型路由和网络链路同时正常。

01

准备 API Key

使用购买成功后收到的 API Key，或仍有额度的已有 Key，并把它保存在服务端环境变量中。

  • 新用户：先购买并获取 API Key
  • 老用户：继续给同一 Key 充值
  • 配置完成：查询额度和调用日志
02

复制正确的 URL

OpenAI-compatible 客户端通常填写以 /v1 结尾的 Base URL。只有客户端明确要求完整接口地址时，才填写具体端点。

推荐 Base URL大多数 OpenAI-compatible 客户端使用此地址
https://new.weeanno.shop/v1
备用 Base URL客户端会自动拼接 /v1 时使用
https://new.weeanno.shop
Chat Completions 完整端点Chat Completions-compatible 请求完整地址
https://new.weeanno.shop/v1/chat/completions
Responses 完整端点Responses-compatible 请求完整地址
https://new.weeanno.shop/v1/responses
Messages 完整端点Messages-compatible 客户端完整地址
https://new.weeanno.shop/v1/messages
03

填写客户端配置

在客户端对应字段中填写 Base URL 和 API Key。下面示例只含占位符，不含真实密钥。

OpenAI-compatible 客户端

config
base_url = "https://new.weeanno.shop/v1"
api_key = "sk-your-api-key"

Claude Code · Messages 兼容

config
export ANTHROPIC_BASE_URL="https://new.weeanno.shop"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

用 cURL 验证

请求成功就说明 Base URL、API Key、模型路由和网络链路同时正常。

bash
curl https://new.weeanno.shop/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

不要把真实 API Key 放进截图、聊天消息、浏览器前端代码或公开仓库。

按使用工具选择配置

先确认工具需要的协议。OpenAI-compatible 工具使用 /v1 Base URL；Claude Code 使用 Messages-compatible 网关地址。

Cherry Studio · Chatbox · WorkBuddy

OpenAI-compatible 客户端

填写这个 Base URL

https://new.weeanno.shop/v1
打开配置指南

Codex CLI · Cursor · VS Code · Trae · OpenCode

OpenAI-compatible 客户端

填写这个 Base URL

https://new.weeanno.shop/v1
打开配置指南

Claude Code

Claude Code · Messages 兼容

填写这个 Base URL

https://new.weeanno.shop
打开配置指南

OpenClaw · Hermes · Dify · n8n · LangChain · OpenWebUI

OpenAI-compatible 客户端

填写这个 Base URL

https://new.weeanno.shop/v1
打开配置指南

常见错误速查

先根据 HTTP 状态码定位问题，再决定是否更换模型或 API Key。

401 / 403
OpenAI 兼容客户端使用 Authorization: Bearer <key>；Claude Code 使用 ANTHROPIC_AUTH_TOKEN。
404
确认客户端需要的是 Base URL 还是完整端点，并核对模型名称。
429
降低并发、缩短上下文，并到 Token 额度页面检查剩余额度。
TIMEOUT
先发送一条小请求，再检查网络链路，并按退避策略重试。

联系武元客服前

请提供足够的排查信息，但不要暴露完整 API Key。

  • 工具名称和版本
  • 模型名称和 Base URL（API Key 请脱敏）
  • HTTP 状态码、错误原文和 request ID
  • 大致发生时间和时区
联系武元客服

常用网站入口

购买、充值、订单状态、Token 额度查询和完整开发文档，都可以从下面的公开网址进入。

网站入口武元官网首页与导航
https://weeanno.shop/zh
购买入口购买并自动获取新的 API Key
https://weeanno.shop/zh/buy
充值入口给已有 API Key 增加额度
https://weeanno.shop/zh/topup
订单查询查询支付和额度入账状态
https://weeanno.shop/zh/topup/query
Token 额度查询查询剩余额度和调用日志
https://weeanno.shop/zh/quota
开发文档SDK、流式输出、错误码和限流说明
https://weeanno.shop/zh/docs