快速接入

5 分钟跑通第一次调用。

三步流程

获取账号 → 充值/兑换 → 创建 API Key → 调用

第 1 步：获取账号

访问 token.mzyai.com，点击「注册」，用邮箱 + 验证码完成注册。

• 验证码由 token@mzyai.com 发出，注意查收垃圾邮件
• 忘记密码：登录页点「忘记密码」重置
• 两步验证（TOTP）：在「个人设置」中开启
• 注册即送 30 天 Token 体验版（含 3 个 coding 模型），无需充值即可试用

第 2 步：充值 / 兑换

充值

控制台 →「充值」选金额，支持支付宝/微信（EasyPay）、Stripe（国际卡）、Airwallex（跨境），回调确认后即时到账。

扣费规则：实际费用 = 模型标准价 × 分组费率系数。缓存命中的 Token 按缓存价计。

获取兑换码 / 优惠码

平台不定期发放 兑换码（充值抵扣） 与 优惠码（折扣分组） 两类权益：

• 兑换码/优惠码通过 企业微信智能客服、官网活动页、合作渠道发放
• 一个账号通常限用一张同类码，码面标注有效期，过期作废
• 活动详情见 促销活动页

需要帮助？

• 智能客服（企业微信）：点击咨询 — 充值异常、兑换码失效、分组开通等问题实时响应
• 邮箱：token@mzyai.com

第 3 步：创建 API Key

控制台 →「API 密钥」→「新建密钥」：

• Key 格式 sk-mzy-xxx，只在创建时完整显示一次，请立即保存
• Key 归属的分组决定可用模型清单与费率
• 可按用途建多个 Key，泄露可随时禁用

接入示例

OpenAI SDK（Python）

from openai import OpenAI

client = OpenAI(
    api_key="sk-mzy-xxx",
    base_url="https://token.mzyai.com/v1"
)

resp = client.chat.completions.create(
    model="hy3",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

curl 验证

curl https://token.mzyai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-mzy-xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"hy3","messages":[{"role":"user","content":"ping"}]}'

返回 JSON 含 choices 即接入成功。

AI 办公工具接入

WorkBuddy（企业微信AI助手）

配置路径：WorkBuddy 管理后台 → 模型配置 → 自定义 API → 填入上述参数

QClaw（AI办公套件）

配置路径：QClaw 设置 → AI 模型 → OpenAI 兼容 → 填入 Base URL 和 Key

OpenClaw（开源AI助手）

配置路径：OpenClaw 配置文件 config.yaml → providers → 添加 OpenAI 兼容 provider

爱马仕（Hermes AI）

配置路径：爱马仕 设置 → 模型管理 → 添加自定义模型 → 选择 OpenAI 兼容 → 填入参数

AI 编程工具接入

Claude Code

# 环境变量配置
export ANTHROPIC_BASE_URL=https://token.mzyai.com
export ANTHROPIC_AUTH_TOKEN=sk-mzy-xxx

或写入 ~/.claude/config.json：

{
  "apiBaseUrl": "https://token.mzyai.com",
  "apiKey": "sk-mzy-xxx"
}

Codex CLI

在 ~/.codex/config.toml 中配置：

[api]
base_url = "https://token.mzyai.com/v1"
env_key = "CODEX_API_KEY"  # 从环境变量读取 Key

export CODEX_API_KEY=sk-mzy-xxx

Cursor

配置路径：Cursor Settings → Models → OpenAI API

CodeBuddy / Cline

Gemini CLI

export GOOGLE_GEMINI_BASE_URL=https://token.mzyai.com
export GEMINI_API_KEY=sk-mzy-xxx

常用 AI 工具速查表

所有工具统一使用 sk-mzy-xxx 格式的 Key，Base URL 为 https://token.mzyai.com/v1（Claude Code / Gemini CLI 用根域名 https://token.mzyai.com）。

实战建议：通用 LLM 使用技术

参考 CodeBuddy 技术博客：什么是上下文窗口 整理，适用于所有 OpenAI 兼容接口。

1. 理解上下文窗口

上下文窗口 = 模型单次请求能处理的 Token 总量（输入 + 输出 + 系统提示）。超出会截断或报错。

• 输入 Token：你发的消息 + 历史对话 + 系统提示
• 输出 Token：模型生成的回复
• 窗口用满后，早期对话会被丢弃，模型"忘记"开头内容

实战建议：长对话场景定期总结历史，只保留关键结论回传，避免无意义的上下文堆积。

2. 控制 Token 成本

• 选对模型：轻量任务用 qwen3.5-flash，复杂推理用 hy3，不要所有请求都打旗舰模型
• 压缩输入：去掉无关背景，用结构化指令替代长篇描述
• 限制输出：设置 max_tokens 防止模型无限生成
• 流式输出：开启 stream: true，首字延迟更低，用户体验更好

3. 提示词（Prompt）工程基础

• 角色设定：用系统提示明确"你是谁、做什么"，比每次在用户消息里重复更高效
• 结构化输出：要求返回 JSON 或固定格式，便于程序解析
• 少样本（Few-shot）：给 1-3 个示例，模型准确率显著提升
• 分步思考：复杂任务让模型"先列出步骤再执行"，减少跳步错误

4. 错误处理与重试

• 429 / 限流：指数退避重试（等待 1s → 2s → 4s），不要立即狂刷
• 超时：设置客户端超时（建议 60-120s），超时后查账单确认是否扣费
• 降级：主模型失败时自动切换到备用模型（如 hy3 → deepseek-v4-pro）

5. 安全与合规

• Key 保护：sk-mzy-xxx 只存服务端环境变量，禁止写进前端代码或提交到 Git
• 输入校验：用户可控内容做长度与敏感词过滤，防止提示词注入
• 日志脱敏：日志中不打印完整 Key，只保留前缀 sk-mzy-***

下一步

• API 接入配置参考 — 模型清单、错误码、限流参数
• 常见问题 — 计费、报错、限流排查
• 价格表 — 全部模型价格与折扣
• 促销活动 — 兑换码/优惠码获取