Gate.AI 文档

快速开始

1. 创建 API 密钥

1. 前往 gate.ai，选择登录模式，授权登录
2. 进入控制台 → 进入设置 → 进入 API 密钥 → 创建密钥

2. 自动路由（可选）

自动路由默认开启，控制方式：

进入控制台 → 进入设置 → 进入路由 → 自动路由开关

开启后，Gate.AI 会自动为每个请求选择最佳模型。如果你更倾向于自行选择模型，可跳过此步，直接指定模型（如 anthropic/claude-sonnet-4.6）。

标准接入

与 OpenAI API 完全兼容，支持 Python、Node.js、curl 等生态工具。

替换 Base URL ( https://api.gate.ai/openai/v1 )与 API 密钥即可使用。

from openai import OpenAI

client = OpenAI(
    api_key="GATEAI_API_KEY",  # get GATEAI_API_KEY from gate.ai (API Key)
    base_url="https://api.gate.ai/openai/v1",
)

completion = client.chat.completions.create(
    model="auto",
    messages=[
        {"role": "system", "content": "system prompt"},
        {"role": "user", "content": "how are you?"}
    ],
)

# get the response from LLM (role=assistant)
print(completion.choices[0].message.content)

{
    "id": "243c850e-214c-431e-977f-ebaf4aa95f56",
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "Hello! Nice to meet you. How can I help you?"
            },
            "finish_reason": "stop"
        }
    ],
    "created": 1773408946,
    "model": "deepseek.v3-v1:0",
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 5,
        "completion_tokens": 15,
        "total_tokens": 20
    }
}

Cursor 接入

Claude Code 接入

export ANTHROPIC_BASE_URL="https://api.gaterouter.ai/anthropic"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"
claude

export ANTHROPIC_BASE_URL="https://api.gaterouter.ai/anthropic"
export ANTHROPIC_API_KEY="sk-or-v1-xxxxxxxxxxxxxxxx"

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.gaterouter.ai/anthropic",
    "ANTHROPIC_API_KEY": "sk-or-v1-xxxxxxxxxxxxxxxx"
  }
}

env -u ANTHROPIC_BASE_URL -u ANTHROPIC_API_KEY claude

export ANTHROPIC_MODEL="anthropic/claude-sonnet-4.6"

export ANTHROPIC_DEFAULT_SONNET_MODEL="anthropic/claude-sonnet-4.6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="anthropic/claude-opus-4.6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="anthropic/claude-haiku-4.5"

export ANTHROPIC_CUSTOM_MODEL_OPTION="anthropic/claude-sonnet-4.6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet（Gate.AI）"

claude

Claude Desktop 接入

Hermes 接入

前置条件

• 已在 Gate.AI 控制台 创建 API 密钥。
• 若使用自动路由，请在控制台 设置 → 路由 中开启 自动路由。

方式一：终端配置

1. 选择模型与自定义端点

在终端执行：

hermes model

在菜单中选择 Custom endpoint，按提示填写：

若询问 context length（上下文长度），直接回车留空即可（由 Hermes 自动探测）。

2.（可选）本地 Web 管理界面

若希望通过浏览器编辑配置，可运行：

hermes dashboard

3. 验证

hermes chat "Hello"

成功则说明请求已到达 Gate.AI，并由智能路由或你指定的模型返回结果。

也可运行 hermes doctor 验证是否连接成功。

方式二：直接编辑配置文件

1. 文件位置

macOS / Linux

• ~/.hermes/config.yaml，主配置（模型、provider、base_url、api_key 等）
• ~/.hermes/.env，密钥与敏感环境变量（推荐）

Windows

• C:\Users\<用户名>\.hermes\config.yaml
• C:\Users\<用户名>\.hermes\.env

2. 在 .env 中保存密钥（任选其一）

写法 A（与 Gate.AI 命名一致）

# Gate.AI API 密钥
GATEAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

写法 B（与 Hermes 自定义端点常见约定一致）

Hermes 对自定义端点在未单独配置 model.api_key 时，会回退使用 OPENAI_API_KEY。可将 Gate.AI 密钥写入：

OPENAI_API_KEY=sk-or-v1_xxxxxxxxxxxxxxxxxxxxx

3. 在 config.yaml 中配置 model

自动路由（auto）

model:
  default: auto
  provider: custom
  base_url: https://api.gate.ai/openai/v1
  api_key: ${GATEAI_API_KEY}

若使用 写法 B，可将 api_key 留空或删除该字段，让 Hermes 使用 OPENAI_API_KEY。

Hermes 会在加载配置时展开 ${VAR}（变量须已在环境中存在，通常由 ~/.hermes/.env 注入）。

固定模型示例

模型 ID 须与 Gate.AI 模型列表 一致）：

model:
  default: deepseek/deepseek-v3.2
  provider: custom
  base_url: https://api.gate.ai/openai/v1
  api_key: ${GATEAI_API_KEY}

4. 保存后验证

保存后用 hermes chat "Hello" 测试 Gate.AI 连接来验证。

多线路 / 多模型

若同一 Gate.AI 密钥下需要 多条逻辑线路（例如一条用 auto、一条固定 deepseek/deepseek-v3.2），可在 config.yaml 中配置 custom_providers（名称仅允许字母、数字、连字符等；建议用连字符，例如 gateai-auto）：

model:
  default: auto
  provider: custom
  base_url: https://api.gate.ai/openai/v1
  api_key: ${GATEAI_API_KEY}

custom_providers:
  - name: gateai-auto
    base_url: https://api.gate.ai/openai/v1
    api_key: ${GATEAI_API_KEY}
    model: auto

  - name: gateai-deepseek
    base_url: https://api.gate.ai/openai/v1
    api_key: ${GATEAI_API_KEY}
    model: deepseek/deepseek-v3.2

切换方式

1. 终端：再次运行 hermes model，在菜单中选择对应命名线路或 Custom endpoint。
2. 对话中（TUI）：使用 Hermes 官方文档中的 /model 语法，例如：

/model custom:gateai-auto:auto
/model custom:gateai-deepseek:deepseek/deepseek-v3.2

（具体名称以在 custom_providers[].name 中填写为准；三段为 custom:<配置名>:<模型 id>。）

常见问题

QClaw 接入

如果您已安装好 QClaw，请按照以下步骤接入 Gate.AI。

对话式完成配置

1. 在对话中输入以下内容，请将 apiKey 替换为您的 Gate.AI API 密钥：

帮我新增一个provider
名称：Gate.AI
apiKey: sk-or-v1-xxxxxxxxxxxxxxxx
baseUrl: https://api.gate.ai/openai/v1
模型：auto

QClaw 会自动添加成功并重启生效。

2. 验证是否成功

直接输入：「帮我验证一下 Gate.AI 配置有没有生效」。对话会返回「Gate.AI provider 已成功添加！」（以实际界面为准。）

3. 切换到 Gate.AI 使用

直接输入：「切换到 Gate.AI 下面的 auto」。对话会返回「已切换成功！」（以实际界面为准。）

AutoClaw 接入

1. 配置入口

点击左下角偏好设置，选择模型与 API，点击添加自定义模型。

2. 添加模型

• 服务商选择自定义。
• 添加 Gate.AI 支持的模型 ID，例如 deepseek/deepseek-v3.2。
• 填写显示名称，例如：Gate.AI(deepseek-v3.2)。
• 填写 API Key，例如：sk-or-v1-xxxxxxxxxxxxxxxx。
• 填写 Base URL：https://api.gate.ai/openai/v1

3. 测试配置是否成功

点击连通测试，显示「测试成功」字样，则表示配置成功。

4. 模型使用

• 点击添加按钮，保存成功后，返回应用。
• 在聊天框下方选择切换模型，选择配置的 Gate.AI(deepseek-v3.2)，即可使用。

API 参考

{
  "model": "bytedance/seedance-2.0",
  "prompt": "A golden retriever running on a sunny beach, cinematic camera movement",
  "duration": 6,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": false,
  "seed": -1,
  "metadata": {
    "source": "playground"
  },
  "webhook_url": "https://example.com/webhooks/gateai-video"
}

{
  "code": 200,
  "msg": "",
  "data": {
    "job_id": "video_abc123",
    "status": "in_progress",
    "model": "bytedance/seedance-2.0",
    "status_url": "https://api.gate.ai/api/v1/videos/video_abc123",
    "message": "视频任务已提交，请调用 status_url 查询生成进度。",
    "current_balance": "100.0000000000",
    "estimated_cost": "1.0800000000",
    "pre_deduct_amount": "1.0800000000",
    "balance_after_estimate": "98.9200000000",
    "currency": "USDT",
    "billing_notice": "视频生成完成后按实际任务结果扣款，提交后请保持余额充足。"
  }
}

{
  "code": 200,
  "msg": "",
  "data": {
    "job_id": "video_abc123",
    "status": "completed",
    "model": "bytedance/seedance-2.0",
    "status_url": "https://api.gate.ai/api/v1/videos/video_abc123",
    "download_url": "https://api.gate.ai/api/v1/videos/video_abc123/content",
    "duration": 6,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": false,
    "estimated_cost": "1.0800000000",
    "billed_cost": "1.0800000000",
    "billing_status": "settled",
    "expires_at": "2026-06-26T05:00:00Z",
    "created_at": "2026-05-27T05:00:00Z",
    "completed_at": "2026-05-27T05:03:00Z"
  }
}

HTTP/1.1 302 Found
Location: https://cdn.example.com/videos/video_abc123.mp4?expires=1780000000

模型

模型 ID 格式：provider/model-name。版本号使用 .（如 4.6），而非 -。

更多模型可访问模型页面查看

故障排除

# ❌ 错误
https://api.gate.ai/v1/chat/completions

# ✅ 正确
https://api.gate.ai/openai/v1/chat/completions  # openai 协议
https://api.gate.ai/anthropic/v1/messages  # anthropic 协议

// ❌ 部分模型不支持
{ "model": "gpt-4o", "max_tokens": 100 }

// ✅ 使用 max_completion_tokens
{ "model": "openai/gpt-5.5", "max_completion_tokens": 100 }

# ✅ 正确的请求头
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx # openai 协议
X-api-key: sk-xxxxxxxxxxxxxxxxxxxx # anthropic 协议