接入文档
10 分钟完成首次调用
从零开始接入熊猫算力:注册登录、充值或兑换、创建 API 密钥、选择模型、完成首次 API 调用并查看调用记录。
这条主线只做一件事:让你在 10 分钟内发出第一条成功请求。概念说明、客户端细节和排障都放在独立页面,遇到问题再跳转。
开始前准备
你需要一个熊猫算力账号、可用的钱包余额或兑换码、以及一个准备接入的客户端。还没有确定客户端时,建议先用 curl 验证,再接入 Claude Code、Codex 或桌面客户端。
1 注册并登录
2 充值或兑换
前往钱包页面,确认当前团队钱包有可用余额。若你拿到兑换码,在钱包页输入兑换码完成入账。
余额不足会直接拒绝调用
钱包余额不足时,请求会被拒绝并在调用记录中看到余额相关错误。扣费、退款和流水说明见钱包、扣费与退款。
3 创建 API 密钥
进入密钥页面,点击「新建密钥」。
名称建议按用途填写,例如 claude-code、codex 或 curl-test。第一次接入时模型白名单可以留空,后续再按团队策略收紧。
创建成功后复制 Base URL 和 API 密钥明文。密钥明文只展示一次,请保存在密码管理器或本机安全位置。
更多鉴权和密钥生命周期说明见 鉴权与密钥。
4 选择模型
打开模型广场,复制要调用的 模型 ID。
先选一个低成本对话模型
第一次验证只需要能稳定返回文本的模型。如何选择模型、查看价格倍率和 API 分组,见模型广场与API 分组与价格倍率。
5 选择一种接入方式
CC Switch(推荐给 Claude Code / Codex)
如果你使用 Claude Code 或 Codex,先看 CC Switch 接入。它可以从密钥详情页导入 Base URL、API 密钥和模型 ID,减少手动编辑配置文件。
CLI 配置文件
- Claude Code 接入指南:在
settings.json中配置,ANTHROPIC_BASE_URL不带/v1。 - Codex 接入指南:在
config.toml或环境变量中配置,base_url或OPENAI_BASE_URL带/v1。 - 不确定本机 CLI 是否读到配置时,先做 CLI 环境检查。
桌面客户端
Cursor、Cherry Studio、Cline、ChatBox 都可以按字段表配置 API 地址、API 密钥和模型 ID。
6 直接用 curl 验证
如果你只想先确认密钥、余额和模型都可用,运行 curl:
把 {API_KEY} 替换成真实密钥,把 [在模型广场复制的模型 id] 替换成第 4 步复制的模型 ID。
成功响应会包含 choices 和 usage:
{
"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 与扣费金额。