API 调用配置

适用于 OpenClaw、Hermes，以及其他支持标准 OpenAI 协议的客户端、工具和 Agent。

基本信息

项目	说明
Base URL	见下方动态显示的当前 API 地址
API Key	在API 密钥页面创建
推荐接口	OpenAI Responses：`/v1/responses`
备用接口	OpenAI Chat Completions：`/v1/chat/completions`
Claude 接口	Anthropic Messages：`/v1/messages`

本服务兼容标准 OpenAI 协议。只要客户端支持标准格式，就可以使用这里的 Base URL、API Key 和模型进行配置。

支持的接口

接口	路径	适用场景
OpenAI Responses（推荐）	`/v1/responses`	默认选择，缓存命中率和 Agent 场景表现更好
OpenAI Chat Completions	`/v1/chat/completions`	客户端不支持 Responses 时使用
Anthropic Messages	`/v1/messages`	Claude 系列或仅支持 Claude 官方协议的客户端

除 Claude 系列（或仅支持 Messages 协议的模型）外，其他模型优先使用 Responses，客户端不支持时再使用 Chat Completions。图片等多模态请求通常也支持这两种 OpenAI 接口。

可用模型

以下是文档维护的模型示例。实际可用模型和权限以账号所在分组及控制台显示为准。

OpenAI 系列（Responses / Chat Completions）

gpt-5.4
gpt-5.4-mini
gpt-5.6-luna
gpt-5.6-sol
gpt-5.6-terra

Claude 系列（Anthropic Messages / Claude Code）

claude-fable-5
claude-sonnet-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-sonnet-4-6
claude-haiku-4-5
claude-haiku-4-5-20251001

xAI 系列（Responses / Chat Completions）

grok-4.5

给 AI / Agent 的配置

把协议、动态显示的 Base URL、API Key 和模型交给 Agent 即可完成配置。下面的模板会自动使用当前站点的 API 地址：

当前 API Base URL正在读取当前文档地址...

Responses 接口（推荐）

curl /responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "input": "你好，介绍一下你自己"
  }'

Chat Completions 接口（备用）

curl /chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-5.6-sol",
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

Anthropic Messages 接口

curl /messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: $API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "你好，介绍一下你自己"}
    ]
  }'

发给 AI / Agent 的配置模板

1. 协议     ：OpenAI Responses API（走 /v1/responses 接口）
2. Base URL ：
3. API Key  ：<你的密钥>
4. 模型     ：例如 gpt-5.6-sol

一句话模板：

请走 OpenAI Responses 接口配置 API 调用，Base URL 使用上方当前 API Base URL，Key 是我的 API Key，模型使用可用的 OpenAI 模型。

已有配置如何迁移

如果之前使用过其他 OpenAI 兼容服务，通常只需要替换 API Base URL 和 API Key，其他协议配置保持不变。迁移后确认模型名称属于当前账号可用列表。

接口选择速查

场景	推荐接口
默认情况	`/v1/responses`
客户端不支持 Responses	`/v1/chat/completions`
上传图片或其他多模态内容	优先 Responses，不支持时使用 Chat Completions
Claude 系列模型	`/v1/messages`
其他模型（包括国产模型）	Responses / Chat Completions，优先 Responses

常见问题

为什么优先使用 Responses？

两种 OpenAI 接口都能完成常见对话，但 Responses 在长对话和 Agent 场景中的缓存命中通常更好，成本和响应速度更有优势。

迁移其他 OpenAI 兼容服务麻烦吗？

通常不麻烦。替换 Base URL 和 API Key 即可；如果客户端还要求选择协议，请选择 Responses。

为什么请求返回 401 或 403？

检查 API Key 是否复制完整、是否已被删除，以及当前密钥所属分组是否有对应模型权限。不要把真实 Key 放进公开文档、截图或 URL 参数中。

API URL 是固定的吗？

不是。页面会根据当前访问的站点域名和站点配置动态生成 API URL，因此同一份文档产物可以部署到不同域名。

API 调用配置 ​

基本信息 ​

支持的接口 ​

可用模型 ​

给 AI / Agent 的配置 ​