API 接入文档

使用统一接口调用 GPT 与 Claude

生产环境统一使用 https://api.mozhan.cc/v1。先在控制台创建 API Token，分组选择“自动线路（推荐）”，再从模型广场复制当前开放的模型名称。

创建 API Token 查看模型广场

/v1/chat/completions
/v1/responses
/v1/messages
Bearer Token

接入步骤

1. 创建 API Token

登录控制台进入“令牌管理”，按应用或环境分别创建 Token。不要把 Token 写入前端代码、截图或公开仓库。

2. 使用自动线路

Token 分组选择“自动线路（推荐）”。内部线路由系统管理，最终线路和线路售价会写入使用记录。

3. 复制模型名称

打开模型广场复制当前公开模型名称。模型范围可能更新，不要依赖已经隐藏或暂停开放的名称。

cURL 示例

下面使用当前公开模型名称作为示例。请把 API_KEY 替换为你自己的 Token。

curl https://api.mozhan.cc/v1/chat/completions \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [
      {
        "role": "user",
        "content": "请用三句话介绍智能 API 路由"
      }
    ],
    "stream": false
  }'

OpenAI Python SDK

已有 OpenAI SDK 项目通常只需修改 api_key、base_url 和 model。

from openai import OpenAI

client = OpenAI(
    api_key="API_KEY",
    base_url="https://api.mozhan.cc/v1",
)

response = client.chat.completions.create(
    model="gpt-5.4",
    messages=[
        {
            "role": "user",
            "content": "请用三句话介绍智能 API 路由",
        }
    ],
)

print(response.choices[0].message.content)

Anthropic Messages 示例

使用 Claude 客户端时可调用 Messages 接口；模型名称请从模型广场复制。

curl https://api.mozhan.cc/v1/messages \
  -H "x-api-key: API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "请说明自动线路如何计费"
      }
    ]
  }'

调用后检查

HTTP 状态与响应内容符合预期。
使用记录中的模型名称与请求一致。
最终线路显示为公开线路名称。
输入、输出 Token 与扣除额度可核对。
出现重试或切线时，以最终成功线路计费。

安全提示

不要把真实 API Token 发到聊天、工单截图或公开代码仓库。生产服务应从环境变量或密钥管理服务读取 Token，并按应用分别创建、定期轮换。模型限流、上下文和价格以控制台当前展示为准。