文档

接入文档

10 分钟完成首次调用

从零开始接入熊猫算力:注册登录、充值或兑换、创建 API 密钥、选择模型、完成首次 API 调用并查看调用记录。

这条主线只做一件事:让你在 10 分钟内发出第一条成功请求。概念说明、客户端细节和排障都放在独立页面,遇到问题再跳转。

开始前准备

你需要一个熊猫算力账号、可用的钱包余额或兑换码、以及一个准备接入的客户端。还没有确定客户端时,建议先用 curl 验证,再接入 Claude Code、Codex 或桌面客户端。

1 注册并登录

打开注册页面,填写用户名和密码完成注册;已有账号时直接登录

注册后系统会创建个人团队。后续邀请同事、角色权限和团队钱包说明见账号、团队与邀请

2 充值或兑换

前往钱包页面,确认当前团队钱包有可用余额。若你拿到兑换码,在钱包页输入兑换码完成入账。

余额不足会直接拒绝调用

钱包余额不足时,请求会被拒绝并在调用记录中看到余额相关错误。扣费、退款和流水说明见钱包、扣费与退款

3 创建 API 密钥

进入密钥页面,点击「新建密钥」。

名称建议按用途填写,例如 claude-codecodexcurl-test。第一次接入时模型白名单可以留空,后续再按团队策略收紧。

创建成功后复制 Base URLAPI 密钥明文。密钥明文只展示一次,请保存在密码管理器或本机安全位置。

环境变量

更多鉴权和密钥生命周期说明见 鉴权与密钥

4 选择模型

打开模型广场,复制要调用的 模型 ID

先选一个低成本对话模型

第一次验证只需要能稳定返回文本的模型。如何选择模型、查看价格倍率和 API 分组,见模型广场API 分组与价格倍率

5 选择一种接入方式

CC Switch(推荐给 Claude Code / Codex)

如果你使用 Claude Code 或 Codex,先看 CC Switch 接入。它可以从密钥详情页导入 Base URL、API 密钥和模型 ID,减少手动编辑配置文件。

CLI 配置文件

桌面客户端

CursorCherry StudioClineChatBox 都可以按字段表配置 API 地址、API 密钥和模型 ID。

6 直接用 curl 验证

如果你只想先确认密钥、余额和模型都可用,运行 curl:

curl

{API_KEY} 替换成真实密钥,把 [在模型广场复制的模型 id] 替换成第 4 步复制的模型 ID。

成功响应会包含 choicesusage

{
  "id": "chatcmpl-xxxx",
  "object": "chat.completion",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 12,
    "total_tokens": 22
  }
}

首次调用完成

前往调用记录查看这次请求。你应该能看到模型、状态、tokens 与扣费金额。

7 下一步

10 分钟完成首次调用 | 熊猫算力文档