Skip to content

快速上手 ​

让 AI 帮你接入并开发 ​

把下面这句话粘贴到 你自己的 AI 助手聊天框,再告诉它要开发什么,或者附上正在看的 SandBase API 页面。这是给助手的指令,不是终端命令。

text
set up https://www.sandbase.ai/SKILL.md

Setup Skill 会引导 Agent 根据你的现状继续:还没账号、已有 API Key、工具已经连接、已有项目,或准备从零做一个功能。Agent 会检查接口参数和价格,帮助实现接入,并分别说明配置、真实调用和功能验证的完成情况。告诉它开发目标和费用限制,不要把 Key 发到聊天里。

已经有 Key 或项目就直接说明,不必重新开始。例如:“我已经有 SandBase Key,请在这个项目中加入 Similarweb 网站流量查询,先检查接口并说明付费实测的费用。”如果助手不能执行命令或加载工具,请按对应客户端的接入说明操作。

可以把 Markdown Quickstart 直接交给 Agent,也可以按下方步骤注册、在网页试用、直接调用 API 或搭建托管 Agent。安装 setup Skill 本身不会创建托管 Agent。

1. 注册账号 ​

SandBase 使用 GitHub 或 Google 登录,没有单独的邮箱密码注册。

  1. 打开 注册 / 登录。
  2. 完成安全验证,然后选择 Sign in with GitHub 或 Sign in with Google。
  3. 在授权窗口中确认访问。
  4. 确认进入 Console。

第一次登录会自动创建账号和 personal workspace。试用前不必先建组织。

如果出现欢迎额度,可以先不绑卡就开始。当前余额以 Console 首页的 Balance 卡片和 Billing 为准。

2. 创建组织 ​

API Key、用量和账单都属于组织。一个人试用时,留在 personal workspace 即可。多人要共享 Key 和花费时,再创建团队。

工作区适用场景
Personal第一次登录自动创建,每个用户一个。
Team共享成员、Key 和余额。公司或项目用这个。

2.1 创建团队 ​

  1. 打开 Create team,或在 Console 右上角的账号菜单选择 Create Team。
  2. 填写 Team name,点击 Create team。
  3. 确认账号菜单里已切换到这个团队作为当前 workspace。
  4. 在 Developer → Team 点击 Add member,填入对方已有 SandBase 账号的 Account email,并选择 Workspace role(Member 或 Admin)。

被邀请的人必须先有 SandBase 账号。如果还没有,把 这个页面 发给他们,让他们先登录,再添加。

如果你属于多个组织,在账号菜单里切换。Key 和账单跟随 当前选中的 组织。角色说明见 Organizations。

3. 接入 SandBase ​

按现在要做的事选一条路径,其他路径以后再加。先确认当前组织,避免 Key 和已连接的工具落到错误的 workspace。

3.1 调用 API ​

适合给自己的应用增加一项能力。

  1. 在 Developer → API Keys 点击 New key 创建 API key。立刻复制,密钥只显示一次。
  2. 在能力目录里筛选能力,打开详情页:
    • 大语言模型 — 按提供商、能力、上下文和价格筛选
    • 图像 / 视频模型 — 筛选文生图、图生图、文生视频、图生视频等多模态模型
    • APIs — 按平台和数据源筛选 API 资源
  3. 复制请求,用你的 SandBase API key 调用。

Model 调用示例:

bash
export SANDBASE_API_KEY="sk-YOUR_KEY"

curl https://api.sandbase.ai/v1/chat/completions \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Summarize this customer feedback."}]
  }'

了解更多:First API Call。

3.2 在官网使用 ​

适合先在网站上试用,还不写代码、也不接 AI 客户端。

  1. 登录后打开能力目录:
  2. 筛选并打开详情页。
  3. 在页面上发起一次请求,确认返回结果。

3.3 在 AI 中使用 ​

适合已经在用 Claude Code、Codex、Cursor、Kiro 或其他受支持客户端,希望在这个应用里直接使用 SandBase 的 Models 和 APIs。

  1. 打开 Console 的 Build → AI tools。

  2. 把这一行粘贴到你的 AI 助手聊天框,再告诉它要开发什么:

    text
    set up https://www.sandbase.ai/SKILL.md
  3. 在 agent 打开的浏览器页面里批准登录,不需要粘贴 API key。

  4. 新开一个会话或重启应用,让 SandBase 工具加载。

  5. 让 Agent 先发现并检查相关接口,再在你的授权和预算内完成一次小规模请求。如果是开发任务,让它把返回结果接入项目,并提供启动命令和实际测试结果;仅完成接口发现不代表业务调用成功。

更习惯终端?运行 npx -y @sandbaseai/cli@latest connect。接入后工具可以搜索整个目录,调用费用记在当前 workspace。

例如,可以这样问:

调研这家公司,并给出有来源的客户简报。

了解更多:Connect AI tools。

3.4 搭建 Agent ​

适合多步骤、需要复用的工作。

  1. 打开 Build → Agents,点击 Create。
  2. 填写 Overview 和 Instructions。
  3. 选择 Model。
  4. 在 Capabilities 添加 Skills 和 MCP 工具,再设置 Runtime。
  5. 点击 Create & Chat,在 Session 中测试。
  6. 在 Agent 的 API 标签页从应用调用测试通过的版本。

了解更多:Build Agent。

4. 确认已可用 ​

同时满足下面几点,就可以开始用了:

  • Console 账号菜单显示的是你打算使用的组织。
  • 完成了其中一种接入:API 调用、官网试用、AI 工具,或 Agent。
  • 一次请求成功。

如果失败,检查当前组织、Key,以及 Errors。workspace 没有余额时,到 账单和充值 充值。

5. 账单和用量 ​

登录后,在当前组织下查看花费和用量:

6. 接下来可以看 ​