API Key 与首次请求

下面的流程不会把密钥写进代码或浏览器存储。完成后，你会得到一条来自 /v1/chat/completions 的文本响应。

1. 创建 API Key

1. 打开 RTOC 并登录。
2. 在控制台进入 API Keys 页面，创建新密钥。
3. 立即复制密钥，并保存到密码管理器或密钥管理服务。不要提交到 Git。

2. 设置环境变量

macOS 或 Linux：

export RTOC_API_KEY='替换为你的密钥'
export RTOC_CHAT_MODEL='gpt-5.6-luna'

PowerShell：

$env:RTOC_API_KEY = '替换为你的密钥'
$env:RTOC_CHAT_MODEL = 'gpt-5.6-luna'

示例模型已于 2026-07-14 在 模型广场 核验。上线代码应把模型作为配置，并根据端点类型选择。

3. 发送 cURL 请求

curl --fail-with-body --max-time 60 https://api.rtoc.cc/v1/chat/completions \
  -H "Authorization: Bearer ${RTOC_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d "{
    \"model\": \"${RTOC_CHAT_MODEL}\",
    \"stream\": false,
    \"messages\": [
      {\"role\": \"user\", \"content\": \"用一句话解释 Radius to Core。\"}
    ]
  }"

文本位于 choices[0].message.content。收到 401、429 或模型错误时，按 故障排查 处理。

4. Python

import os
import requests

response = requests.post(
    "https://api.rtoc.cc/v1/chat/completions",
    headers={"Authorization": f"Bearer {os.environ['RTOC_API_KEY']}"},
    json={
        "model": os.environ.get("RTOC_CHAT_MODEL", "gpt-5.6-luna"),
        "messages": [{"role": "user", "content": "你好"}],
        "stream": False,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json()["choices"][0]["message"]["content"])

5. Node.js

const response = await fetch('https://api.rtoc.cc/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.RTOC_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: process.env.RTOC_CHAT_MODEL ?? 'gpt-5.6-luna',
    messages: [{ role: 'user', content: '你好' }],
    stream: false,
  }),
  signal: AbortSignal.timeout(60_000),
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
const data = await response.json()
console.log(data.choices[0].message.content)

完整可执行版本见仓库的 cURL、Python 与 Node.js 示例。