Clawo API

面向已开通 API 的客户说明密钥、兼容接口与用量查看方式；本页不是新订阅的购买入口。

已开通的 Clawo API 服务继续使用，公开营销入口调整不改变既有接入权限。
一个域名、一个 Key，同时承接 OpenAI-compatible 与 Anthropic-compatible 接入。
API 密钥、模型目录、请求日志和费用都通过控制台统一管理。

Clawo API 是什么

已开通 API 的客户可以通过 Clawo Key 调用获准模型。密钥、可用范围与实际用量以登录后的控制台为准。

我们统一把客户接入点收口到 api.clawo.net。OpenAI 兼容客户端继续走 /v1/models、/v1/chat/completions、/v1/responses，Claude 兼容客户端继续走 /v1/messages；模型映射、来源选择和回退策略由平台在后台判断，而不是让你自己维护多套上游地址。

查看已授权模型

登录控制台查看当前账号可用的模型、配额和权益。公开文档不列售卖目录，不代替账号的实时授权范围。

订阅与成本管理

已开通账号的订阅、Key、账本与用量记录仍可通过控制台查看。

模型范围、额度与费用以账号的实际权益、订单和使用记录为准。

如何开始使用

注册并登录

在Clawo注册账号并登录控制台。

核对已有权限

确认当前账号已开通的 API 模型范围、配额和接入权限；本文档不提供新订阅购买入口。

获取 API Key

在控制台的 API 管理区创建你的 API Key。Key 管理支持预算限额、速率限制和按需轮换。

开始调用

客户端默认只需要把接入域名填写为 https://api.clawo.net，并附上你的 Key；具体协议面由请求本身决定。

发送第一个请求

先把 YOUR_EXISTING_CLAWO_KEY 替换为当前账号已开通的 API Key，查询这把 Key 实际可用的模型。模型列表以本次返回为准；公开文档不承诺固定的授权模型。

模型列表只返回标识，不提供协议能力。先登录控制台模型页（/console/api/models），核对同一模型的接口能力包含“对话接口”，且账号与第一个示例使用的同一把 Key 均已获准；再从上一步 data 数组中选择对应 id，替换 AUTHORIZED_MODEL_ID。只有确认支持 chat/completions 协议及可用额度后才执行第二个示例；仅支持 Responses 的模型应使用对应协议。若无法核实模型映射、接口能力或权限，不要猜测或发送请求。下面是可复制的文本示例，页面不会自动执行。

新逻辑请求使用新的 UNIQUE_REQUEST_ID；同一请求重试保留原来的 Idempotency-Key，不要通过换 ID 重复执行结果尚未确认的请求。

1. 查询当前 Key 的模型目录

curl --fail-with-body 'https://api.clawo.net/v1/models' \
  -H 'Authorization: Bearer YOUR_EXISTING_CLAWO_KEY'

2. 调用已授权模型

curl --fail-with-body 'https://api.clawo.net/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_EXISTING_CLAWO_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: UNIQUE_REQUEST_ID' \
  --data-raw '{
    "model": "AUTHORIZED_MODEL_ID",
    "messages": [{"role": "user", "content": "请只回复：连接成功。"}],
    "stream": false
  }'

余额与用量请登录控制台，在 API 管理或用量页面查看（/console/api、/console/usage）。账户余额读取需要控制台登录权限，不要把登录会话或控制台接口与上述 API Key 接入面混用。

API 平台由哪些部分组成

已有服务权益

查看当前账号已开通服务的额度与权益边界，以控制台实际记录为准。

密钥管理

创建、轮换和管理你的 API Key。支持设置预算限额和速率限制，确保使用安全可控。

模型目录

查看所有可用模型的清单，包括能力标签、适用场景和接入批次。后续将提供每个模型的独立详情页和定价信息。

用量与账单

查看 API 调用量、Token 消耗、费用明细和账单历史。支持按模型、按 Key、按时间维度拆分查看。

安全与合规

API 调用全程 HTTPS 加密传输。Key 权限管理、调用审计和异常告警确保使用安全。

兼容性说明

Clawo API 对外统一收口到 api.clawo.net。同一套账号和 Key 同时承接 OpenAI-compatible 与 Anthropic-compatible 两类接入面，后台再按模型别名、来源策略和可用性池决定真实上游。这意味着：

客户侧只需要维护一个接入域名：https://api.clawo.net。
同一个域名、同一个 Key，同步承接 OpenAI-compatible 与 Anthropic-compatible 两类请求，不需要分别记忆不同厂商地址。
所有兼容 OpenAI 接口的第三方工具和框架都可以继续直连；需要 Claude 原生消息格式时，也沿用同一个域名。
无论请求最终命中哪种协议面，真正的模型来源、fallback 和账本回流都在 Clawo 后台统一处理。

与 AI 主机配合使用

如果你已经部署了自己的 AI 主机，Clawo API 可以作为这些主机的统一模型供给后端。你不需要在每台 AI 主机上分别配置各个厂商的 API Key 和管理各自的余额——通过 Clawo API，所有模型调用、费用和额度都由平台统一管理。

已有接入配置按当前权限继续使用；调整公开营销展示不会停用已开通服务。