快速开始

按照本页步骤创建 API Key，并使用 gpt-5.6-sol 发送第一次聊天请求。开始前，请确认你的账号可以进入 Vergora 控制台，并且当前余额足以完成测试请求。

开始前准备

你还需要一个可以执行 cURL 的终端。以下命令适用于 macOS、Linux，以及支持 Bash 或 Zsh 的环境。

1. 登录并进入控制台

1. 点击网站顶部的“登录”。
2. 按页面提示完成账号验证。
3. 登录后进入控制台，确认当前账号和工作区正确。
4. 检查可用余额以及已有 API Key 的状态。

如果验证码错误或长时间未收到，请先检查邮箱地址、垃圾邮件和页面提示，不要连续反复请求验证码。

2. 创建 API Key

1. 在控制台中打开 API Keys。
2. 创建一个新的 API Key。
3. 使用能够区分应用和环境的名称，例如 demo-development。
4. 按页面提示复制并安全保存完整 API Key。

API Key 是私密凭证。不要把它写入浏览器代码、公开仓库、聊天消息、日志或截图。

3. 在终端中保存 API Key

使用下面的命令输入 API Key。输入过程中，终端不会显示 Key 内容。

printf "Vergora API Key: "
read -r -s VERGORA_API_KEY
printf "\n"
export VERGORA_API_KEY

该环境变量只在当前终端会话中有效。关闭终端后，需要重新设置。正式应用应通过服务端环境变量或密钥管理工具保存凭证。

4. 发送第一次请求

在同一个终端中运行：

curl --silent --show-error --include \
  "https://api.vergora.ai/v1/chat/completions" \
  -H "Authorization: Bearer ${VERGORA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {
        "role": "user",
        "content": "你好，请用一句话介绍你自己。"
      }
    ],
    "stream": false
  }'

本示例使用聊天补全接口。切换模型前，请确认目标模型支持相同的端点、消息结构和参数。

5. 读取响应

兼容 Chat Completions 的非流式响应通常包含消息内容和用量信息。下面的字段和值仅用于说明读取位置：

{
  "id": "example-response-id",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "你好！我是一个 AI 助手。"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 8,
    "total_tokens": 20
  }
}

检查以下内容：

1. HTTP 请求是否成功完成。
2. 响应正文中是否包含模型返回的内容。
3. choices[0].message.content 是否能够正常读取。
4. 是否返回用量信息或可用于定位请求的标识。

不要只根据终端没有报错判断调用成功。

6. 核对请求记录

打开控制台中的 Requests，根据调用时间和模型查找刚才的请求，然后核对：

如果记录尚未出现，请先刷新页面并检查筛选条件，不要为了生成记录而立即重复发送相同请求。

常见问题

完成第一次请求后，可以继续阅读“身份验证”，了解 API Key 的使用和保护方式。