快速开始

ClawToken 提供统一的 API,让你通过单一接口访问数百个 AI 模型。只需几分钟即可完成接入,兼容 OpenAI SDK 和标准 HTTP 请求。

已上线 79 个模型,含最新的 gpt-5.5、claude-opus-4-7、claude-sonnet-4-6。查看实时价格选择模型。
查看价格 →
接口地址: 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 错误响应:

状态码含义
401API Key 无效或缺失
400请求参数无效
404接口不存在
429请求频率超限
502上游服务错误

错误响应格式:

{
  "error": {
    "message": "Invalid API key",
    "type": "auth_error"
  }
}