快速开始
ClawToken 提供统一的 API,让你通过单一接口访问数百个 AI 模型。只需几分钟即可完成接入,兼容 OpenAI SDK 和标准 HTTP 请求。
已上线 79 个模型,含最新的
查看价格 →
gpt-5.5、claude-opus-4-7、claude-sonnet-4-6。查看实时价格选择模型。
接口地址:
所有 API 请求应发送至此地址。接口完全兼容 OpenAI API 格式。
https://clawtoken.dev/v1所有 API 请求应发送至此地址。接口完全兼容 OpenAI API 格式。
身份认证
在请求头中添加 Authorization 字段,携带你的 API Key 进行身份验证。
Authorization: Bearer YOUR_API_KEY
接口地址
https://clawtoken.dev/v1
所有 API 端点均基于此地址。例如,对话补全接口为:
POST
https://clawtoken.dev/v1/chat/completions
对话补全
发送 POST 请求,传入模型和消息即可生成对话补全。
使用 OpenAI SDK
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://clawtoken.dev/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[
{"role": "user", "content": "你好!"}
]
)
print(response.choices[0].message.content)
直接 HTTP 请求
import requests
response = requests.post(
"https://clawtoken.dev/v1/chat/completions",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
json={
"model": "gpt-5.5-xhigh",
"messages": [
{"role": "user", "content": "你好!"}
]
}
)
print(response.json())
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
model 必填 | string | 使用的模型名称(例如 claude-sonnet-4-6、openai/gpt-5.5、claude-opus-4-7) |
messages 必填 | array | 消息数组,包含 role 和 content 字段 |
stream 可选 | boolean | 设为 true 时,返回 SSE 流式响应 |
temperature 可选 | number | 采样温度,取值 0 到 2,默认值:1 |
max_tokens 可选 | integer | 生成的最大 Token 数 |
top_p 可选 | number | 核采样参数,默认值:1 |
流式输出
启用流式输出后,可通过 Server-Sent Events (SSE) 实时接收生成内容。
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://clawtoken.dev/v1"
)
stream = client.chat.completions.create(
model="claude-opus-4-7",
messages=[
{"role": "user", "content": "写一首短诗"}
],
stream=True
)
for chunk in stream:
if chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="")
支持的模型
ClawToken 支持来自多家 AI 厂商的模型:
OpenAI
gpt-5.5-xhigh
OpenAI
openai/gpt-4o
OpenAI
openai/gpt-4o-mini
Anthropic
claude-opus-4-7
Anthropic
claude-sonnet-4-6
Anthropic
claude-haiku-4-5-20251001
Google
google/gemini-3-pro
Google
google/gemini-2.5-flash
完整的 79 个模型及实时价格请见 /pricing。使用页面上显示的模型标识符即可。
错误处理
API 返回标准 HTTP 状态码和 JSON 错误响应:
| 状态码 | 含义 |
|---|---|
401 | API Key 无效或缺失 |
400 | 请求参数无效 |
404 | 接口不存在 |
429 | 请求频率超限 |
502 | 上游服务错误 |
错误响应格式:
{
"error": {
"message": "Invalid API key",
"type": "auth_error"
}
}