快速入门_文档中心-TokenCube

本指南介绍如何创建 API 令牌，并使用 curl 通过 AI 网关完成第一次模型调用。

发送请求前，您需要准备三项信息：用于身份验证的 API 令牌、指定目标模型的 模型 ID，以及与所选协议匹配的 请求地址。以下步骤将依次完成这些准备，并说明如何查看调用结果。

开始前的准备

账号已开通服务： 登录 AI 网关控制台。试用账号需要有可用测试额度；正式账号需要有足够的可用资金或信用额度。您可以在充值页面查看。尚未开通服务时，请联系您的商务对接人。
具有配置权限： 创建 API 令牌和模型配置需要相应权限。如果无法创建，请联系主账号管理员开通所需权限。
准备终端： 下方命令使用 Bash 或 Zsh，需安装 curl，无需安装 SDK。

模型调用会产生用量：测试阶段使用测试额度，正式阶段按适用价格计费。额度与充值规则参见余额与充值指南。

1. 创建 API 令牌

API 令牌支持统一 Base URL，并且需要关联一份 模型配置，由配置指定应用可以调用哪些模型。

在令牌管理中选择 新建令牌。输入 令牌名称，例如 quickstart-key，保留启用状态，并设置未来的过期日期和时间。
在 模型配置 区域选择 新建配置。为配置命名，例如 quickstart-yourname-01，将 yourname 替换为您自己的小写字母或数字标识。配置名称需全平台唯一，创建后不可修改。
在 模型ID范围 中选择要调用的模型。下文以 deepseek-v4.1-flash 为例，请将它加入配置；如果只需开放这一个模型，可以先 清空已选，再搜索并勾选它。
点击弹窗中的确认，将新配置用于当前令牌。首次调用可保留令牌组、IP 白名单、限额和标签的默认设置；需要限制请求来源或用量时，参见令牌管理。
提交令牌表单后，在创建结果中复制完整密钥并妥善保存。下一步将用它验证请求，令牌名称和 ID 均不能代替密钥。

请勿将密钥放入共享文档、截图或代码仓库。如果未保存密钥，可在完成身份验证后再次获取，无需重新创建令牌。

2. 发送第一条请求

下面使用 OpenAI协议兼容模式 的聊天生成接口发送一句问候。先在终端中输入刚才创建的令牌，再执行请求命令，AI 网关便会将请求转发给指定模型。

使用其他模型时

下方命令已包含 deepseek-v4.1-flash 的模型 ID 和请求地址，可直接使用。若要更换模型，请先将它加入令牌关联的模型配置，再从模型广场的模型详情中获取 模型ID 和 API示例。不同模型支持的协议与端点可能不同，应按对应示例调整请求。

在终端中执行

在终端中执行下面的隐藏输入命令，再粘贴完整令牌并按 Enter。输入内容不会显示在屏幕上，也无需将真实密钥写入命令历史。不要在共享终端会话或录屏中输入密钥。
```
printf 'API key: '
if [ -n "${ZSH_VERSION:-}" ]; then
  read -rs AIGATEWAY_TOKEN
else
  IFS= read -r -s AIGATEWAY_TOKEN
fi
printf '\n'
export AIGATEWAY_TOKEN
```

在同一个终端中执行以下命令。它会读取 AIGATEWAY_TOKEN 中的令牌，并请求模型用一句话打招呼：

curl --silent --show-error \
  --request POST 'https://api.tokencube.net/v2/llm/chat/completions' \
  --header "Authorization: Bearer ${AIGATEWAY_TOKEN}" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {
        "role": "user",
        "content": "Say hello in one short sentence."
      }
    ],
    "stream": false
  }'

messages 中的 content 是提示词，model 是要调用的模型 ID。stream: false 让回复以完整 JSON 一次返回，便于查看结果。命令中的 URL 是完整请求地址。

这里选择的是 OpenAI协议兼容模式。如果客户端会自动追加 /chat/completions，应将起始地址设为 https://api.tokencube.net/v2/llm，而不是上面的完整请求 URL。使用 OpenAI 协议时的地址对照见选择协议和调用地址。测试完成后执行 unset AIGATEWAY_TOKEN，移除当前终端中的变量。

3. 确认调用结果

请求成功后，终端会显示模型返回的 JSON。在 choices 数组的第一项中，message.content 就是模型生成的回复。下面是响应结构的节选，实际回复的措辞可能不同：

{
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello, how can I help you today?"
      }
    }
  ]
}

收到模型回复，说明您已完成一次通过 AI 网关的模型调用。您还可以打开控制台中的请求日志，查看已记录请求的状态、耗时和用量。

请求未成功时

先查看终端返回的错误信息，再按下表检查对应设置。

现象	首先检查	下一步
提示凭证无效或鉴权失败	是否使用完整密钥，令牌是否启用、过期，认证头是否与所选协议一致。	打开控制台中的令牌管理，检查凭证状态；不要使用名称或 ID 代替密钥。
提示模型不可用、访问被拒绝或请求不符合要求	模型 ID、关联配置中的模型范围，以及请求 URL、请求体和协议是否配套。	按目标模型的 API示例重新核对；来源限制问题还需检查令牌 IP白名单与模型配置 IP访问控制两处规则。
提示限额、限速或资金不足	令牌及所属组的限额，响应中的限速说明，以及账号可用测试额度或资金。	分别核对令牌和组额度；资金问题按服务暂停与恢复处理。
返回服务端错误，或仍无法定位	错误正文，以及控制台请求日志中是否已有对应记录。	按请求日志排查步骤对照应用记录；日志可能延迟显示。

需要支持人员协助时，提供请求 ID（如果返回了该字段）、带时区的调用时间、模型 ID 和脱敏后的错误信息。请勿提供令牌密钥。

接下来您还可以

接入应用： 参考聊天生成 API的通用请求参数和响应格式，将调用接入您的应用。
调用其他模型： 在模型广场选择模型、获取请求示例，并按需更新模型配置。
管理访问和用量： 为应用设置令牌访问规则与限额，或通过请求日志分析调用情况。

快速入门