快速开始

本指南会带你完成接入 APINebula 的最短路径，包括注册账号、登录控制台、充值额度、创建 API 令牌，以及发起第一次请求。

立即注册立即登录

阅读建议

如果你是第一次接入，建议先按顺序完成注册、登录、充值额度和创建 API 令牌，再开始正式调用。

视频教程：完整接入流程

如果你更习惯跟着视频操作，可以先观看下面的完整教程，再按本页步骤逐项完成注册、充值和 API 令牌配置。

视频与文字教程怎么配合

视频适合快速了解完整流程；遇到具体字段、入口或报错时，请以本页文字步骤和截图为准。

第一步：注册账号

注册入口：

• https://apinebula.ai/register

注册完成后，建议先确认可以正常跳转到登录页或控制台。

第二步：登录账号

登录入口：https://apinebula.ai/login

登录成功后，你会进入控制台首页。首页顶部导航可以看到 首页、控制台、模型广场、文档 等入口，左侧菜单可以看到 数据看板、令牌管理、钱包管理 等功能。

第三步：充值额度

进入控制台后，建议先确认账户余额是否充足。

控制台传送门

点击 打开 APINebula 钱包管理 直接进入充值页面。

在左侧边栏点击 钱包管理 进入充值页面。

完成充值后，返回 数据看板 查看：

• 当前余额
• 历史消耗
• 请求次数
• 统计额度

充值与计费

• 充值后有多少额度：以钱包管理页面显示的实际到账额度为准。
• 调用会扣多少额度：查看模型广场中对应模型、对应分组的最终价格。

模型广场中的价格已经折算完成，不需要自己换算美元或再次计算倍率。详见模型与令牌分组介绍：倍率怎么算。

警告

如果账户没有可用额度，即使 API Key 创建成功，接口请求也可能依然失败。

第四步：创建 API 令牌

API Key（也叫“令牌”或“密钥”）就是后面要粘贴到配置文件或输入框中的一串身份凭证。它不是模型名称，也不是请求地址。先在这里创建并复制它，再回到对应客户端的教程中填写。

新手只要记住这 3 步

1. 按客户端教程指定的分组创建令牌。
2. 提交后回到令牌列表，直接复制；剪贴板中复制出来的就是纯 API Key，不包含 Bearer。
3. 回到配置页面：如果是独立的 API Key 输入框，直接粘贴完整内容；只有配置文件或请求示例中的占位文字才需要替换。

后面看到“API Key”“令牌”“密钥”时，指的都是这同一串内容。

完成充值后，进入左侧菜单中的 令牌管理 页面。

控制台传送门

点击 打开 APINebula 令牌管理 直接进入令牌页面。

1. 点击左侧菜单 令牌管理

2. 在令牌管理页面点击 添加令牌

3. 进入令牌设置页，填写必要信息并提交

填写信息

• 令牌名称：给这把 Key 起一个便于识别的名字，例如 测试 或 生产。
• 令牌分组：决定这把 Key 能调用哪些模型。先到模型广场找到要使用的模型，再选择该模型对应的分组；不要凭名称猜测。
• 过期时间：可选；不填写表示长期有效。
• 额度设置：可选；可以限制这把 Key 的最大调用额度。
• 模型可用列表：新手建议留空，表示不额外限制模型。只有需要限制调用范围时才填写。

提示

令牌分组一定要根据你实际使用的模型来选择：用什么模型，就选对应的分组。如果你不确定应该选哪个分组，建议先到 模型广场 确认模型所属分组，再创建令牌。

需要一把 Key 调用多个模型？

可以选择 Auto 分组，创建时保持默认设置即可；如需控制路由优先级，只在“调整分组顺序”中拖动排列。Auto 会按请求中的模型名称自动路由，不能通过勾选分组来改变范围。对分组规则不熟悉时，请先选择具体分组；完整步骤见创建 Auto 分组令牌。

4. 点击提交，完成令牌创建

5. 回到令牌列表并复制密钥

找到刚创建的记录，在这一行的密钥栏直接复制。

点击后，纯 API Key 会直接复制到剪贴板，通常以 sk- 开头；复制内容不包含 Bearer。后续教程中的“API Key”或“令牌”都指这串内容。

使用 Auto 分组时，同一把 Key 可以按模型名称自动路由到多个模型。请求里的 Authorization 保持不变，切换模型只需要修改 model 字段；模型名称和接口类型以模型广场当前显示为准。

你的API_KEY 到底填在哪里？

你的API_KEY 或 YOUR_API_KEY 只是配置文件、代码示例中的占位文字，不能原样保留。独立的 API Key 输入框则直接粘贴完整 Key。下面是填写规则（示例中的 Key 仅用于说明格式，不要原样复制）：

看到的位置	正确填写方式	注意事项
JSON 或 TOML	把引号里的 你的API_KEY 替换为完整 API Key	保留原有引号，不要删掉字段名或等号
.env 文件	GEMINI_API_KEY=你的完整 API Key	不加引号，不要在等号两边加空格
网页上的 API Key 输入框	直接粘贴完整 API Key	不加引号，不要输入 Bearer
请求示例中的 Authorization: Bearer YOUR_API_KEY	只替换 YOUR_API_KEY	Bearer 只有在示例已经写出时才保留

例如，下面这行里的 你的API_KEY 要被替换，而不是继续填写“你的API_KEY”：

"OPENAI_API_KEY": "你的API_KEY"

替换后应当仍然保持同样的结构：

"OPENAI_API_KEY": "你的完整 API Key"

如果你关闭了创建成功提示，仍可回到令牌列表复制；不需要重新创建令牌。

如果列表中暂时看不到完整 Key，请点击该令牌的查看或复制按钮；出于安全原因，页面可能只显示部分字符。

危险

API Key 只应保存在本机受控配置文件、服务端环境变量或安全密钥管理工具中，不要写进前端代码、公开仓库或聊天截图里。

第五步：配置客户端（可选）

如果你还需要配置本地 CLI、桌面客户端或 VS Code 插件，可以继续阅读对应的客户端配置教程。

推荐阅读：

• Codex 配置教程
• Claude Code 配置教程
• Gemini Antigravity CLI（推荐）与 Gemini CLI 配置教程
• Grok Build 配置教程
• GLM Claude Code 配置教程
• Kimi Code CLI 配置教程
• 桌面版配置教程
• Node.js 环境安装教程

如果你只需要直接发起接口请求，也可以跳过这一步，继续看下面的第一次调用示例。

第一次请求示例

在开始调用前，请先确认下面三项：

• Base URL：https://apinebula.ai/v1
• Authorization：Bearer YOUR_API_KEY
• 令牌分组：请使用 Codex 分组的 API Key，本示例模型为 gpt-6-astra

如果你的后台还有模型分组、模型别名或专用渠道配置，请以控制台中的实际显示为准。

按系统调用

Windows

在 PowerShell 中执行：

$headers = @{
  Authorization = "Bearer YOUR_API_KEY"
}

$body = @{
  model = "gpt-6-astra"
  messages = @(
    @{
      role = "user"
      content = "你好，请简单介绍一下你自己。"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod `
  -Uri "https://apinebula.ai/v1/chat/completions" `
  -Method Post `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

macOS

打开“终端”：按下 Command+Space 打开聚焦搜索，输入“终端”或 Terminal，然后按回车。在终端中执行：

curl https://apinebula.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下你自己。"
      }
    ]
  }'

Linux

在终端中执行：

curl https://apinebula.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-6-astra",
    "messages": [
      {
        "role": "user",
        "content": "你好，请简单介绍一下你自己。"
      }
    ]
  }'

Python

import requests

url = "https://apinebula.ai/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "model": "gpt-6-astra",
    "messages": [
        {"role": "user", "content": "你好，请简单介绍一下你自己。"}
    ],
}

response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.status_code)
print(response.json())

Node.js

const response = await fetch("https://apinebula.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    model: "gpt-6-astra",
    messages: [
      {
        role: "user",
        content: "你好，请简单介绍一下你自己。",
      },
    ],
  }),
});

const result = await response.json();
console.log(result);

调用失败时优先检查什么

1. 请求地址是否正确
2. Authorization 是否为 Bearer YOUR_API_KEY
3. API Key 是否复制完整
4. 模型名称是否可用
5. 账户是否还有可用额度
6. 请求体 JSON 格式是否正确

下一步阅读

• Codex 配置