第一次调用

这一页带你从零跑到第一次成功的 API 调用，大约 3 分钟。

第一步：注册账号

打开 注册页，填邮箱和密码。

也可以用 GitHub、Google、微软或 QQ 账号直接登录，登录时会自动创建账号，不需要单独填邮箱。

注册后需要验证邮箱——系统会发一封带验证码的邮件，填进去就完成了。

第二步：创建令牌

登录后进入 控制台 → API 密钥 → 创建密钥。

几个字段说明：

字段	说明
名称	随便填，用于你自己区分用途
额度	留空表示不单独限额，跟随账户余额
过期时间	留空表示永不过期

创建后会得到一串以 sk- 开头的密钥。这串东西只会显示一次，关掉弹窗就再也看不到了，记得先复制。

注意

令牌等同于密码。不要提交到 Git、不要贴在公开的聊天记录里、不要写进前端代码。

第三步：充值

进入 钱包 → 充值，选择金额完成支付。

到账后余额会立刻更新。你可以先在 模型广场 看一眼各模型的价格，再决定充多少。

第四步：发一次请求

把下面命令里的 sk-你的令牌 换成刚才复制的密钥：

curl https://www.zzcraft.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "user", "content": "用一句话介绍你自己"}
    ],
    "max_tokens": 100
  }'

看到类似这样的返回就成功了：

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "model": "deepseek-v4.1-flash",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "我是一个 AI 助手……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 28,
    "total_tokens": 40
  }
}

第五步：看账单

回到 控制台 → 使用日志，能看到刚才那次调用：

• 用了哪个模型
• 输入输出各多少 token
• 扣了多少钱

如果这里没记录，说明请求没到服务器，检查一下密钥和地址。

接下来的建议

• 想接入自己的代码：看 Chat Completions
• 想用流式输出：在上面那段 JSON 里加 "stream": true
• 想换模型：改 model 字段，其他不动
• 想看有哪些模型：看 支持的模型

常见卡点

返回 401

密钥错了或者没带 Bearer 前缀。注意是 Authorization: Bearer sk-xxx，中间有个空格。

返回 402 或「额度不足」

余额不够了，去钱包充值。

返回 404

地址错了。必须是 https://www.zzcraft.cn/v1/chat/completions，注意有 /v1。

返回 400

请求体格式不对。最常见的是 messages 不是数组，或者忘了 role 字段。