Skip to content
入门

快速开始 ​

创建 API Key,用 curl 或官方 SDK 发出第一个请求。

1. 创建 API Key ​

  1. 登录 ThetaIO 控制台。
  2. 打开 API 密钥 页面,点击 创建密钥,选择一个分组。
  3. 复制生成的 Key,保存为环境变量:
bash
export THETAIO_API_KEY="sk-..."

保管好 Key

Key 只在创建时完整显示一次。不要把它提交到代码仓库或写进前端页面;泄露后在控制台删除并重新创建。

2. 发出第一个请求 ​

按 Key 所属分组选择协议。Claude 分组用 Messages,GPT 分组用 Responses 或 Chat Completions。

bash
curl https://api.thetaio.tech/v1/messages \
  -H "x-api-key: $THETAIO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'
bash
curl https://api.thetaio.tech/v1/responses \
  -H "Authorization: Bearer $THETAIO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句话介绍你自己"
  }'
bash
curl https://api.thetaio.tech/v1/chat/completions \
  -H "Authorization: Bearer $THETAIO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

3. 使用官方 SDK ​

官方 SDK 只需改 Base URL。注意 Anthropic SDK 的 Base URL 不带 /v1,OpenAI SDK 的 Base URL 带 /v1。

python
import anthropic

client = anthropic.Anthropic(
    base_url="https://api.thetaio.tech",
    api_key="sk-...",
)
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(message.content[0].text)
python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.thetaio.tech/v1",
    api_key="sk-...",
)
response = client.responses.create(model="gpt-5.5", input="你好")
print(response.output_text)
ts
import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  baseURL: 'https://api.thetaio.tech',
  apiKey: process.env.THETAIO_API_KEY,
})
const message = await client.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '你好' }],
})

4. 查看用量 ​

每次请求的 Token 与费用都会记录。在控制台 使用记录 页查看明细,或用当前 Key 调用 GET /v1/usage。

下一步 ​