快速开始：完成第一次模型调用

准备账户与密钥#

Token4AI Cloud 为应用提供统一的模型接入地址。先登录 Vega 控制台，在 API-Key 管理中选择供应商和计费分组，创建用于开发环境的密钥。分组会影响可访问模型和计费价格，不应把不同分组的模型清单混用。

创建后立即保存完整密钥。在服务端环境变量中使用它；生产环境与开发环境分开管理。控制台登录凭证、CLI 授权令牌与模型 API Key 是不同凭证，不能互相替代。

export TOKEN4AI_API_KEY="replace-with-your-api-key"
export TOKEN4AI_MODEL="replace-with-an-id-from-models"

先查询可用模型#

以下只读请求用于检查密钥与目录权限，不会发起模型生成。复制返回 data 数组中一个适合聊天的模型 id，替换后续示例中的 YOUR_MODEL_ID。模型目录并不表示每个模型都支持图像、工具、音频或所有协议。

curl --fail-with-body https://api.token4ai.cloud/v1/models \
  -H "Authorization: Bearer $TOKEN4AI_API_KEY"

发起文本请求#

使用下面的最小请求验证完整链路。请先替换模型名，不要直接使用示例占位符。成功响应中可以读取 choices[0].message.content；模型生成会产生实际用量。

curl --fail-with-body https://api.token4ai.cloud/v1/chat/completions \
  -H "Authorization: Bearer $TOKEN4AI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Say hello in one sentence."
    }
  ],
  "stream": false
}'

确认结果与下一步#

打开使用历史，按时间和模型定位刚才的请求，核对状态、输入输出 Token 和费用。日志与余额可能需要短暂刷新才能显示最新结果；不要因为页面尚未更新就重复发送同一请求。

• 401：检查是否使用有效模型 API Key。
• 403/404：检查权限、计费分组、模型名和路径。
• 429：先读取错误体和重试提示，降低并发后再试。