开始使用
快速开始
用一把密钥，把你的工具连接到 SOTA AI。
开始前，你需要准备什么
准备一个 SOTA AI 账户、账户内可用的余额或订阅，以及能使用自定义 API 地址的客户端。公开文档和模型广场可以先浏览，创建密钥与实际调用需要登录。
01 · 登录并创建专用密钥
- 打开控制台，通过邮箱密码、Google 或 GitHub 登录。
- 进入API 密钥，为这个应用新建密钥，例如 laptop-codex。
- 选择有权限的服务分组，确认额度、有效期及访问限制。复制密钥并妥善保存。
游客入口可以查看控制台的布局与公开内容；游客没有可用密钥，也不会获得真实账户余额。
02 · 填好接入信息
| 配置项 | 填写内容 |
|---|---|
| API Base URL | https://sotaai.org/v1 |
| API Key | 你在本站创建的密钥 |
| 模型 | 该密钥的 /v1/models 返回的模型 ID |
| 接入协议 | 本教程使用 OpenAI Responses |
如果工具要求的是“站点地址”，填写 https://sotaai.org。完整接口路径和 Base URL 的区别见地址怎么填。
03 · 验证模型列表与首个请求
打开 macOS、Linux 或 WSL 的 Bash 终端。Windows PowerShell 用户可先看Windows 环境准备。
export SOTAAI_API_KEY='YOUR_API_KEY'
export SOTAAI_BASE_URL='https://sotaai.org'
export SOTAAI_MODEL='YOUR_MODEL'curl --fail-with-body --max-time 30 "$SOTAAI_BASE_URL/v1/models" \
-H "Authorization: Bearer $SOTAAI_API_KEY"把下面的 YOUR_MODEL 替换为列表中的实际 ID，然后执行：
curl --fail-with-body -N --max-time 120 "$SOTAAI_BASE_URL/v1/responses" \
-H "Authorization: Bearer $SOTAAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_MODEL",
"input": "Reply with exactly OK.",
"stream": true,
"store": false
}'收到文本增量和 response.completed 才说明生成完整结束。只有 HTTP 200、只有开头事件，或仅仅能打开网站，都不足以确认模型调用成功。
04 · 回到控制台核对
在使用记录中查看本次请求的模型、Token、费用与耗时。第一次连接正常后，再配置日常工具或增加并发。
发现内容有误，或有未解答的问题？反馈文档问题 ↗