# PatewayAI

> 专注提供 Claude、OpenAI 等 AI 大模型 API 中转接入服务。严选顶尖 AI 大模型，官方正品直连，统一定价，多充多赠。

PatewayAI 是一个 AI 大模型 API 中转/代理平台，提供 OpenAI 兼容格式的统一接入。当前支持 Claude 全系列模型，官方直连，透明定价，无月费无套餐，用多少付多少。注册即送体验额度。

开发者只需替换 Base URL 和 API Key，即可通过 PatewayAI 中转服务使用 Claude 等顶级大模型，无需直接访问官方 API，访问更稳定、定价更透明。

---

# API 参考

## 限频说明

为保障所有用户的服务质量，API 对每个账户设有以下速率限制：

| 限制类型               | 默认额度              | 说明             |
| ---------------------- | --------------------- | ---------------- |
| RPM（每分钟请求数）    | 300 次/分钟           | 每个模型独立计数 |
| RPD（每日请求数）      | 216,000 次/天         | 所有模型共享额度 |
| TPM（每分钟 Token 数） | 6,144,000 tokens/分钟 | 每个模型独立计数 |

**限流说明：**

- 速率限制采用令牌桶算法，额度会持续恢复，支持短时突发请求
- RPM 和 TPM 按模型独立计算——即使 A 模型额度耗尽，仍可正常请求 B 模型
- RPD 为账户级全局额度，所有模型的请求共同消耗
- TPM 在请求发起时按预估 Token 数预扣额度，请求完成后按实际用量自动修正

**触发限流时：**

- 返回 HTTP `429 Too Many Requests`
- 响应头 `Retry-After` 提示建议的重试等待秒数
- 响应头 `X-RateLimit-Limit-Requests` / `X-RateLimit-Remaining-Requests` 反映当前 RPM 额度
- 响应头 `X-RateLimit-Limit-Tokens` / `X-RateLimit-Remaining-Tokens` 反映当前 TPM 额度

{% hint style="info" %}
如需提频，请联系 support@pateway.ai
{% endhint %}

## Anthropic Messages API 格式

`POST /v1/messages`

使用 Anthropic 原生格式调用 Claude 系列模型。请求头中需包含`x-api-key: YOUR_API_KEY`

### 请求体参数

<table><thead><tr><th>参数</th><th>类型</th><th>说明</th><th data-type="checkbox">必填</th></tr></thead><tbody><tr><td><code>model</code></td><td>string</td><td>模型ID</td><td>true</td></tr><tr><td><code>message</code></td><td>array</td><td>对话消息数组</td><td>true</td></tr><tr><td><code>max_tokens</code></td><td>integer</td><td>最大输出 token 数</td><td>true</td></tr></tbody></table>

更多参数，详见Anthropic官方。

### 示例请求

```
curl --request POST \
  --url https://api.pateway.ai/v1/messages \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "你是一个专业的代码助手",
    "messages": [
      {
        "role": "user",
        "content": "帮我用 Python 写一个快速排序"
      }
    ]
  }'
```

### 响应示例

```
{
  "content": [
    {
      "type": "text",
      "text": "你好！很高兴见到你 😊 有什么我可以帮你的吗？"
    }
  ],
  "id": "msg_01PXFpjoBEXMn1yEGDdp8RrH",
  "model": "claude-opus-4-6",
  "role": "assistant",
  "stop_details": null,
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "type": "message",
  "usage": {
    "input_tokens": 10,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0,
    "cache_creation": {
      "ephemeral_5m_input_tokens": 0,
      "ephemeral_1h_input_tokens": 0
    },
    "output_tokens": 31,
    "service_tier": "standard",
    "inference_geo": "not_available"
  }
}
```

### 流式输出

请求示例

```
curl -N --request POST \
  --url https://api.pateway.ai/v1/messages \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'accept: text/event-stream' \
  --data '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "你好"
          }
        ]
      }
    ],
    "stream": true
  }'
```

响应以 SSE 格式逐块返回，示例：

```
event: message_start
data: {"type":"message_start","message":{"id":"msg_01...","type":"message","role":"assistant","model":"claude-opus-4-6","stop_reason":null,"usage":{"input_tokens":10,"output_tokens":0}}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"你好"}}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":5}}

event: message_stop
data: {"type":"message_stop"}
```

## OpenAI 协议（Responses API）

`POST /v1/responses`

使用 OpenAI Responses API 格式调用 Codex 系列模型。请求头中需包含 `Authorization: Bearer YOUR_API_KEY`。

### 请求体参数

<table><thead><tr><th>参数</th><th>类型</th><th>说明</th><th data-type="checkbox">必填</th></tr></thead><tbody><tr><td><code>model</code></td><td>string</td><td>模型ID</td><td>true</td></tr><tr><td><code>input</code></td><td>string</td><td>用户输入内容</td><td>true</td></tr><tr><td><code>stream</code></td><td>boolean</td><td>是否开启流式输出，默认 false</td><td>false</td></tr></tbody></table>

更多参数，详见 OpenAI 官方文档。

### 示例请求

```
curl --request POST \
  --url https://api.pateway.ai/v1/responses \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "input": "帮我用 Python 写一个快速排序",
    "stream": false
  }'
```

### 响应示例

```json
{
  "id": "resp_xxxxx",
  "object": "response",
  "model": "YOUR_MODEL_ID",
  "output_text": "def quicksort(arr):\n    if len(arr) <= 1:\n        return arr\n    ...",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 86,
    "total_tokens": 98
  }
}
```

### 流式输出

```
curl -N --request POST \
  --url https://api.pateway.ai/v1/responses \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
    "model": "YOUR_MODEL_ID",
    "input": "你好",
    "stream": true
  }'
```

响应以 SSE 格式逐块返回，示例：

```
event: response.output_text.delta
data: {"type":"response.output_text.delta","delta":"你好"}

event: response.output_text.done
data: {"type":"response.output_text.done","text":"你好！有什么我可以帮你的吗？"}

event: response.completed
data: {"type":"response.completed","response":{"id":"resp_xxxxx","status":"completed","output_text":"你好！有什么我可以帮你的吗？","usage":{"input_tokens":5,"output_tokens":12,"total_tokens":17}}}
```

## OpenAI 协议（Chat Completions API）

`POST /v1/chat/completions`

使用 OpenAI Chat Completions 格式调用 gpt-5.5。请求头中需包含 `Authorization: Bearer YOUR_API_KEY`。

### 请求体参数

<table><thead><tr><th>参数</th><th>类型</th><th>说明</th><th data-type="checkbox">必填</th></tr></thead><tbody><tr><td><code>model</code></td><td>string</td><td>模型ID</td><td>true</td></tr><tr><td><code>messages</code></td><td>array</td><td>对话消息数组</td><td>true</td></tr><tr><td><code>max_tokens</code></td><td>integer</td><td>最大输出 token 数</td><td>false</td></tr><tr><td><code>stream</code></td><td>boolean</td><td>是否开启流式输出，默认 false</td><td>false</td></tr></tbody></table>

更多参数，详见 OpenAI 官方文档。

### 示例请求

```
curl https://api.pateway.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "帮我用 Python 写一个快速排序"
      }
    ],
    "stream": false
  }'
```

### 响应示例

```json
{
  "id": "chatcmpl-xxxxx",
  "object": "chat.completion",
  "model": "gpt-5.5",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "def quicksort(arr):\n    if len(arr) <= 1:\n        return arr\n    ..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 86,
    "total_tokens": 98
  }
}
```

### 流式输出

```
curl -N https://api.pateway.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "你好" }
    ],
    "stream": true
  }'
```

响应以 SSE 格式逐块返回，示例：

```
data: {"id":"chatcmpl-xxxxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"role":"assistant","content":""}}]}

data: {"id":"chatcmpl-xxxxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{"content":"你好"}}]}

data: {"id":"chatcmpl-xxxxx","object":"chat.completion.chunk","choices":[{"index":0,"delta":{},"finish_reason":"stop"}]}

data: [DONE]
```

## 错误码

<table><thead><tr><th width="161.05078125">HTTP状态码</th><th>语义</th><th>示例错误信息</th></tr></thead><tbody><tr><td>400</td><td>请求体无法读取或解析失败。</td><td><code>请求体解析失败: unexpected end of JSON input</code></td></tr><tr><td>400</td><td>请求的模型不存在或当前不可用。</td><td><code>The model 'xxx' does not exist</code></td></tr><tr><td>400</td><td>上游供应商返回 400，请求参数被上游拒绝，原始响应透传。</td><td><em>(透传上游原始响应体)</em></td></tr><tr><td>401</td><td>请求未携带 API Key（需通过 <code>x-api-key</code> 或 <code>Authorization: Bearer</code> 传递）。</td><td><code>Missing API Key</code></td></tr><tr><td>401</td><td>API Key 不存在、格式错误或未注册。</td><td><code>Invalid API Key</code></td></tr><tr><td>402</td><td>用户余额不足以承担本次请求预估的费用。</td><td><code>余额不足: balance not enough</code></td></tr><tr><td>403</td><td>API Key 已被禁用或已过期。</td><td><code>Key disabled or expired</code></td></tr><tr><td>403</td><td>用户账号已被冻结或禁用。</td><td><code>account suspended: frozen</code></td></tr><tr><td>413</td><td>请求体超过允许的最大大小。</td><td><code>请求体过大</code></td></tr><tr><td>429</td><td>请求频次过高</td><td><code>rate limit exceeded</code></td></tr></tbody></table>

### 补充说明

#### 429 响应头

当触发限频（429）时，响应会包含以下辅助头信息：

| 响应头                           | 说明               |
| -------------------------------- | ------------------ |
| `Retry-After`                    | 建议的重试等待秒数 |
| `X-RateLimit-Limit-Requests`     | RPM 上限           |
| `X-RateLimit-Remaining-Requests` | RPM 剩余次数       |
| `X-RateLimit-Limit-Tokens`       | TPM 上限           |
| `X-RateLimit-Remaining-Tokens`   | TPM 剩余额度       |

## 查询可用模型

`GET /v1/models`

### 示例请求

{% tabs %}
{% tab title="Anthropic Messages API 格式" %}

```
curl --request GET \
  --url https://api.pateway.ai/v1/models \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

{% endtab %}
{% tab title="OpenAI 协议" %}

```
curl --request GET \
  --url https://api.pateway.ai/v1/models \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

{% endtab %}
{% endtabs %}

### 响应示例

{% tabs %}
{% tab title="Anthropic Messages API 格式" %}

```
{
  "data": [
    {
      "id": "claude-haiku-4-5-20251001",
      "type": "model",
      "display_name": "Claude Haiku 4.5"
    },
    {
      "id": "claude-opus-4-6",
      "type": "model",
      "display_name": "Claude Opus 4.6"
    },
    {
      "id": "claude-sonnet-4-6",
      "type": "model",
      "display_name": "Claude Sonnet 4.6"
    }
  ],
  "has_more": false,
  "first_id": "claude-haiku-4-5-20251001",
  "last_id": "claude-sonnet-4-6"
}
```

{% endtab %}
{% tab title="OpenAI 协议" %}

```
{
  "data": [
    {
      "id": "gpt-5.3-codex",
      "type": "model",
      "display_name": "GPT-5.3 Codex"
    },
    {
      "id": "gpt-5.5",
      "type": "model",
      "display_name": "GPT-5.5"
    }
  ],
  "has_more": false,
  "first_id": "gpt-5.3-codex",
  "last_id": "gpt-5.5"
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
建议以此接口返回结果为准，获取最新可用模型名称。
{% endhint %}

---

# FAQ

Q：PatewayAI 和直接调用官方 API 有什么区别？

A：PatewayAI 是 API 中转平台，严选渠道接入，模型质量有保障，无降智无掺水，主要解决以下痛点：

- 无需绑卡，支付宝即可付款
- 支持调用 Claude、Codex、DeepSeek、Qwen、GLM 等顶尖模型，一个 API Key 即可管理多家模型

---

Q：平台支持哪些模型和协议？

A：平台支持 **Claude 系列**（Anthropic Messages API 格式）、**Codex 系列**（OpenAI Responses API 格式；其中 gpt-5.5 同时支持 OpenAI Chat Completions 格式）和 **DeepSeek、Qwen、GLM、Kimi、MiniMax、MiMo 等国产模型**（Anthropic Messages API 格式，其中 DeepSeek、GLM 同时支持 OpenAI Chat Completions 格式），完整模型列表见[模型广场](/#/models)。

---

Q：使用价格是怎样的？

A：所有模型均为官方价格的 8 折，叠加充值赠送最低可以享受官方6折。更有各种限时优惠折扣，叠加折上折，超划算！模型单价可在[模型广场](/#/models)查看，优惠活动可在[额度管理](/#/console/funds)查看。

---

Q：怎么计费的？

A：按实际 Token 消耗量计费，计费规则与官方一致。您可以在[用量日志](/#/console/usage)中实时查看每次调用的 Token 消耗和费用明细，账单透明可控。

---

Q：使用服务过程中安全吗？

A：我们高度重视用户数据安全：

1. 全链路加密：所有数据传输均通过 HTTPS 加密通道，防止中间人攻击
2. 隐私保护：严格遵守相关隐私法规，详情请见[隐私政策](/#/privacy)

---

Q：赠送的额度有有效期吗？

A：首充奖励、充赠额度、兑换额度**永久有效**；注册赠送额度有效期为**7天**；邀请奖励额度有效期为**30天**，到期赠送额度清零。

---

Q：退费期间被冻结账户，有问题怎么联系？

A：账户冻结期间如有紧急问题，请发送邮件至 <support@pateway.ai> 说明情况，我们会人工介入处理。

---

Q：API Key 泄露了怎么办？

A：立即登录控制台 → Key管理，删除泄露的 Key并重新创建。如发现账户存在非本人产生的异常消耗，请同步联系<support@pateway.ai>，我们将协助核查。

---

Q：支持开具发票吗？

A：有企业采购或合规需求，请联系 <support@pateway.ai> 进行洽谈。

---

# 集成指南

## 编程开发

在你的 AI 编程工具中接入更多优质模型

### Claude Code

{% hint style="warning" %}
Claude Code 暂不支持 GPT 模型
{% endhint %}

1. 请先安装 [Node.js](https://nodejs.org/) 18 或更新版本，如已安装可忽略本条
2. **准备安装**

- Linux/MacOS 系统不需额外操作，默认环境即可。
- Windows 系统需要参考 [Windows 系统安装 WSL](https://learn.microsoft.com/en-us/windows/wsl/install) 安装 WSL 或参考 [Windows 系统安装 Git for Windows](https://git-scm.com/install/windows) 安装 Git for Windows，然后在 WSL 或 Git Bash 中执行下方命令。

3. **在终端中安装**：

```bash
npm install -g @anthropic-ai/claude-code

# 验证安装（如有版本号输出，则表示安装成功）：
claude --version
```

4. **创建/编辑** `settings.json`

{% hint style="info" %}
配置前，请确保已清除以下 Anthropic 官方相关环境变量，以免影响 API 正常使用：`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_BASE_URL`
{% endhint %}

- macOS/Linux：`~/.claude/settings.json`
- Windows：`用户目录/.claude/settings.json`

> 如果 `.claude` 目录不存在，用户可自己创建。

5. **将** `YOUR_API_KEY` **换成你的 API Key**：

```json
{
  "env": {
    "ANTHROPIC_API_KEY": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

6. **创建/编辑** `.claude.json`

- macOS/Linux：`~/.claude.json`
- Windows：`用户目录/.claude.json`

```json
{
  "hasCompletedOnboarding": true
}
```

7. **使配置生效启动**

配置完成后，重新打开终端窗口使配置生效。首次启动需完成以下操作：选择"信任此文件夹 (Trust This Folder)"，允许 Claude Code 访问项目文件。

```bash
claude
```

#### 使用国产模型

如需在 Claude Code 中使用国产大模型（DeepSeek、Qwen、GLM、Kimi、MiniMax、MiMo），将步骤 5 中的 `settings.json` 替换为对应厂商配置，将 `sk-xxxx` 换成你的 API Key：

{% tabs %}
{% tab title="DeepSeek" %}

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

{% endtab %}
{% tab title="Qwen（通义千问）" %}

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "ANTHROPIC_MODEL": "qwen3.7-max",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.7-max",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.7-max",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-plus",
    "CLAUDE_CODE_SUBAGENT_MODEL": "qwen3.6-plus",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

{% endtab %}
{% tab title="GLM（智谱）" %}

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "ANTHROPIC_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5",
    "CLAUDE_CODE_SUBAGENT_MODEL": "glm-5",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

{% endtab %}

{% tab title="Kimi（月之暗面）" %}

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "ANTHROPIC_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "kimi-k2.7-code",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "kimi-k2.6",
    "CLAUDE_CODE_SUBAGENT_MODEL": "kimi-k2.6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

{% endtab %}
{% tab title="MiniMax" %}

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "ANTHROPIC_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M3[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M3[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "MiniMax-M3[1m]",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

{% endtab %}
{% tab title="MiMo（小米）" %}

```json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
    "ANTHROPIC_BASE_URL": "https://api.pateway.ai",
    "ANTHROPIC_MODEL": "mimo-v2.5-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.5-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.5-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2.5-pro[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "mimo-v2.5-pro[1m]",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}
```

{% endtab %}
{% endtabs %}

### Codex

{% hint style="warning" %}
Codex 暂不支持 Claude 模型及 DeepSeek、Qwen、GLM 等国产模型
{% endhint %}

官方文档：[https://developers.openai.com/codex/quickstart](https://developers.openai.com/codex/quickstart)

1. **安装 Codex CLI**

macOS / Linux：

```bash
npm install -g @openai/codex
# 或使用 Homebrew（macOS）
brew install codex
```

Windows（PowerShell）：

```powershell
npm install -g @openai/codex
```

2. **创建/编辑 Codex 配置文件**

macOS / Linux 配置文件路径：

```text
~/.codex/config.toml
```

Windows 配置文件路径：

```text
%USERPROFILE%\.codex\config.toml
```

例如：`C:\Users\你的用户名\.codex\config.toml`

macOS / Linux 示例配置：

```toml
model          = "YOUR_MODEL_ID"
model_provider = "pateway"

[model_providers.pateway]
name     = "Pateway"
base_url = "https://api.pateway.ai/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

[model_providers.pateway.auth]
command = "printenv"
args = ["PATEWAY_API_KEY"]
```

Windows 示例配置（PowerShell）：

```toml
model          = "YOUR_MODEL_ID"
model_provider = "pateway"

[model_providers.pateway]
name     = "Pateway"
base_url = "https://api.pateway.ai/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false

[model_providers.pateway.auth]
command = "powershell"
args = ["-NoProfile", "-Command", "$env:PATEWAY_API_KEY"]
```

3. **配置 API Key 环境变量**

macOS / Linux（以 zsh 为例，在 `~/.zshrc` 中新增）：

```bash
export PATEWAY_API_KEY="YOUR_API_KEY"
```

然后执行：

```bash
source ~/.zshrc
```

或重新打开终端窗口。

Windows（PowerShell）：

```powershell
[Environment]::SetEnvironmentVariable("PATEWAY_API_KEY", "YOUR_API_KEY", "User")
```

执行后重新打开 PowerShell 或终端窗口，使环境变量生效。

4. **启动 Codex**

```bash
codex
```


### 通过 CC-Switch 接入 PatewayAI

---

#### 前置条件

| 依赖 | 说明 |
|------|------|
| cc-switch | 已安装并启动桌面应用，见下方安装步骤 |
| PatewayAI 账号 | 已注册并在控制台手动创建 API Key |

---

#### 第一步：安装 cc-switch

**macOS（推荐 Homebrew）**

```bash
brew tap farion1231/ccswitch
brew install --cask cc-switch
```

或从 [Releases 页面](https://github.com/farion1231/cc-switch/releases) 下载 DMG 文件手动安装。

**Windows**

从 [Releases 页面](https://github.com/farion1231/cc-switch/releases) 下载 `.msi` 安装包（或免安装的绿色版 `.zip`）。

**Linux**

支持 `.deb`（Debian/Ubuntu）、`.rpm`（Fedora）和 `.AppImage` 三种格式，从 Releases 页面按发行版选择下载。Arch Linux 用户可使用：

```bash
paru -S cc-switch-bin
```

---

#### 第二步：获取 PatewayAI API Key

1. 前往 [PatewayAI](https://pateway.ai/) 注册账号（新用户自动获得 $3 体验额度）
2. 注册完成后，进入控制台 [Key 管理页](https://pateway.ai/#/console/keys) 手动创建一个 API Key
3. 复制生成的 API Key，备用

---

#### 第三步：在 cc-switch 中添加 PatewayAI

1. 打开 cc-switch 桌面应用
2. 点击 **「添加供应商」**
3. 在预设列表中搜索 PatewayAI；若未找到，选择自定义配置并填入：
   - **API Base URL**：`https://api.pateway.ai/v1`
   - **API Key**：上一步复制的 PatewayAI Key
4. 粘贴 Key 后可一键导入，保存后供应商列表中即可看到 PatewayAI

---

#### 第四步：切换到 PatewayAI

切换方式有两种，效果相同：

- **主界面**：在供应商列表中选中 PatewayAI，点击 **「启用」**
- **系统托盘**：直接点击托盘图标，选择 PatewayAI（立即生效）

> **注意**：切换后需重启对应的终端或 CLI 工具才能生效。Claude Code 支持热切换，无需重启。

---

#### 第五步：验证配置

重启终端后，正常使用 Claude Code 或其他已接入的 AI 工具发起一次请求，若响应正常则说明已通过 PatewayAI 路由。也可登录 [PatewayAI 控制台](https://pateway.ai/#/console/usage) 查看用量页面，确认是否有新增请求记录。

---

#### 恢复官方登录

如需切换回 Anthropic 官方认证，在 cc-switch 中添加 **「官方登录」** 预设，按登录流程完成认证，然后重启对应 CLI 工具即可。

---

## 代码集成

### Python

Anthropic Messages API 格式：

```bash
pip install anthropic
```

OpenAI 协议（Codex 系列）：

```bash
pip install openai
```

{% tabs %}
{% tab title="Anthropic SDK（Claude 系列）" %}

```python
import anthropic

client = anthropic.Anthropic(
    api_key="YOUR_API_KEY",
    base_url="https://api.pateway.ai/v1",
)

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(message.content[0].text)

# 流式输出
with client.messages.stream(
    model="claude-opus-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "写一篇关于 AI 的短文"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
```

{% endtab %}
{% tab title="OpenAI SDK（Codex 系列）" %}

```python
from openai import OpenAI

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api.pateway.ai/v1",
)

response = client.responses.create(
    model="gpt-5.3-codex",
    input="Hello!",
)

print(response.output_text)
```

{% endtab %}
{% tab title="OpenAI SDK（Chat Completions）" %}

```python
from openai import OpenAI

client = OpenAI(
    api_key="sk-YOUR_API_KEY",
    base_url="https://api.pateway.ai/v1",
)

response = client.chat.completions.create(
    model="gpt-5.5",
    messages=[
        {"role": "user", "content": "Hello!"}
    ],
    stream=False,
)

print(response.choices[0].message.content)
```

{% endtab %}
{% endtabs %}

### Node.js

Anthropic Messages API 格式：

```bash
npm install @anthropic-ai/sdk
```

OpenAI 协议（Codex 系列）：

```bash
npm install openai
```

{% tabs %}
{% tab title="Anthropic SDK（Claude 系列）" %}

```typescript
import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.pateway.ai/v1',
})

const message = await client.messages.create({
  model: 'claude-opus-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '你好' }],
})
console.log(message.content[0].text)

// 流式输出
const stream = await client.messages.stream({
  model: 'claude-opus-4-6',
  max_tokens: 1024,
  messages: [{ role: 'user', content: '写一篇关于 AI 的短文' }],
})

for await (const chunk of stream) {
  if (chunk.type === 'content_block_delta' && chunk.delta.type === 'text_delta') {
    process.stdout.write(chunk.delta.text)
  }
}
```

{% endtab %}
{% tab title="OpenAI SDK（Codex 系列）" %}

```js
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-YOUR_API_KEY',
  baseURL: 'https://api.pateway.ai/v1',
})

const response = await client.responses.create({
  model: 'gpt-5.3-codex',
  input: 'Hello!',
})

console.log(response.output_text)
```

{% endtab %}
{% tab title="OpenAI SDK（Chat Completions）" %}

```js
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'sk-YOUR_API_KEY',
  baseURL: 'https://api.pateway.ai/v1',
})

const response = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [
    { role: 'user', content: 'Hello!' },
  ],
  stream: false
})

console.log(response.choices[0].message.content)
```

{% endtab %}
{% endtabs %}

### Java

{% tabs %}
{% tab title="Anthropic SDK（Claude 系列）" %}

```java
import okhttp3.*;
import org.json.*;

public class Test {
  public static void main(String[] args) throws Exception {
    OkHttpClient client = new OkHttpClient();

    String body = new JSONObject()
      .put("model", "claude-opus-4-6")
      .put("max_tokens", 1024)
      .put("messages", new JSONArray()
        .put(new JSONObject()
          .put("role", "user")
          .put("content", "你好")))
      .toString();

    Request request = new Request.Builder()
      .url("https://api.pateway.ai/v1/messages")
      .post(RequestBody.create(body, MediaType.get("application/json")))
      .addHeader("x-api-key", "YOUR_API_KEY")
      .addHeader("anthropic-version", "2023-06-01")
      .addHeader("Content-Type", "application/json")
      .build();

    try (Response response = client.newCall(request).execute()) {
      JSONObject result = new JSONObject(response.body().string());
      System.out.println(
        result.getJSONArray("content")
          .getJSONObject(0)
          .getString("text")
      );
    }
  }
}
```

{% endtab %}
{% tab title="OpenAI SDK（Codex 系列）" %}

```java
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.responses.Response;
import com.openai.models.responses.ResponseCreateParams;

public class Main {
    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.builder()
                .apiKey("sk-YOUR_API_KEY")
                .baseUrl("https://api.pateway.ai/v1")
                .build();

        ResponseCreateParams params = ResponseCreateParams.builder()
                .model("gpt-5.3-codex")
                .input("Hello!")
                .build();

        Response response = client.responses().create(params);
        System.out.println(response.outputText());
    }
}
```

{% endtab %}
{% tab title="OpenAI SDK（Chat Completions）" %}

```java
import com.theokanning.openai.completion.chat.ChatCompletionRequest;
import com.theokanning.openai.completion.chat.ChatMessage;
import com.theokanning.openai.service.OpenAiService;
import java.time.Duration;
import java.util.List;

public class Example {
    public static void main(String[] args) {
        String apiKey = "sk-YOUR_API_KEY";
        String baseUrl = "https://api.pateway.ai/v1/";

        OpenAiService service = new OpenAiService(apiKey, baseUrl, Duration.ofSeconds(60));

        ChatCompletionRequest request = ChatCompletionRequest.builder()
                .model("gpt-5.5")
                .messages(List.of(new ChatMessage("user", "Hello!")))
                .stream(false)
                .build();

        String response = service.createChatCompletion(request)
                .getChoices().get(0).getMessage().getContent();

        System.out.println(response);
    }
}
```

{% endtab %}
{% endtabs %}

### Go

{% tabs %}
{% tab title="Anthropic Messages API 格式（Claude 系列）" %}

```go
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  payload := map[string]interface{}{
    "model":      "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": []map[string]string{
      {"role": "user", "content": "你好"},
    },
  }

  body, _ := json.Marshal(payload)

  req, _ := http.NewRequest(
    "POST",
    "https://api.pateway.ai/v1/messages",
    bytes.NewBuffer(body),
  )
  req.Header.Set("x-api-key", "YOUR_API_KEY")
  req.Header.Set("anthropic-version", "2023-06-01")
  req.Header.Set("Content-Type", "application/json")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}
```

{% endtab %}
{% tab title="OpenAI 协议（Codex 系列）" %}

```go
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  payload := map[string]interface{}{
    "model": "gpt-5.3-codex",
    "input": "Hello!",
  }

  body, _ := json.Marshal(payload)

  req, _ := http.NewRequest(
    "POST",
    "https://api.pateway.ai/v1/responses",
    bytes.NewBuffer(body),
  )
  req.Header.Set("Authorization", "Bearer sk-YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}
```

{% endtab %}
{% tab title="OpenAI 协议（Chat Completions）" %}

```go
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  payload := map[string]interface{}{
    "model": "gpt-5.5",
    "messages": []map[string]string{
      {"role": "user", "content": "Hello!"},
    },
  }

  body, _ := json.Marshal(payload)

  req, _ := http.NewRequest(
    "POST",
    "https://api.pateway.ai/v1/chat/completions",
    bytes.NewBuffer(body),
  )
  req.Header.Set("Authorization", "Bearer sk-YOUR_API_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, _ := http.DefaultClient.Do(req)
  defer resp.Body.Close()

  result, _ := io.ReadAll(resp.Body)
  fmt.Println(string(result))
}
```

{% endtab %}
{% endtabs %}

---

# 定价与计费

## 模型定价

单次扣费不足0.01的部分会累积到下次超过0.01的计费请求一并扣除

### Anthropic

官方定价8折

<table><thead><tr><th width="180">计费项</th><th align="center">claude-opus-4-8 / 4-7 / 4-6</th><th align="center">claude-sonnet-4-6</th><th align="center">claude-haiku-4-5</th></tr></thead><tbody><tr><td>Input /M</td><td align="center">✦4</td><td align="center">✦2.4</td><td align="center">✦0.8</td></tr><tr><td>Output /M</td><td align="center">✦20</td><td align="center">✦12</td><td align="center">✦4</td></tr><tr><td>Cache Write (5min) /M</td><td align="center">✦5</td><td align="center">✦3</td><td align="center">✦1</td></tr><tr><td>Cache Write (1h) /M</td><td align="center">✦8</td><td align="center">✦4.8</td><td align="center">✦1.6</td></tr><tr><td>Cache Read /M</td><td align="center">✦0.4</td><td align="center">✦0.24</td><td align="center">✦0.08</td></tr><tr><td>Web Search /1K 次</td><td align="center">✦10</td><td align="center">✦10</td><td align="center">✦10</td></tr></tbody></table>

### OpenAI

官方定价8折

<table><thead><tr><th rowspan="2" style="vertical-align:middle" valign="middle" width="180">计费项</th><th align="center" colspan="2" style="text-align:center">gpt-5.5</th><th align="center" rowspan="2" style="text-align:center;vertical-align:middle" valign="middle">gpt-5.3-codex</th></tr><tr><th align="center" style="text-align:center">Short context (&lt; 272K)</th><th align="center" style="text-align:center">Long context (≥ 272K)</th></tr></thead><tbody><tr><td>Input /M</td><td align="center">✦4</td><td align="center">✦8</td><td align="center">✦1.4</td></tr><tr><td>Output /M</td><td align="center">✦24</td><td align="center">✦36</td><td align="center">✦11.2</td></tr><tr><td>Cache Read /M</td><td align="center">✦0.4</td><td align="center">✦0.8</td><td align="center">✦0.14</td></tr><tr><td>Web Search /1K 次</td><td align="center" colspan="2" style="text-align:center">✦10</td><td align="center">✦10</td></tr></tbody></table>

### DeepSeek

官方定价8折

<table><thead><tr><th width="180">计费项</th><th align="center">deepseek-v4-pro</th><th align="center">deepseek-v4-flash</th></tr></thead><tbody><tr><td>Input /M</td><td align="center">✦0.3528</td><td align="center">✦0.1176</td></tr><tr><td>Output /M</td><td align="center">✦0.7056</td><td align="center">✦0.2352</td></tr><tr><td>Cache Read /M</td><td align="center">✦0.0032</td><td align="center">✦0.0024</td></tr></tbody></table>

### Qwen（通义千问）

官方定价8折

<table><thead><tr><th rowspan="2" style="vertical-align:middle" valign="middle" width="180">计费项</th><th align="center" rowspan="2" style="text-align:center;vertical-align:middle" valign="middle">qwen3.7-max</th><th align="center" colspan="2" style="text-align:center">qwen3.6-plus</th></tr><tr><th align="center" style="text-align:center">Short context (&lt; 256K)</th><th align="center" style="text-align:center">Long context (≥ 256K)</th></tr></thead><tbody><tr><td>Input /M</td><td align="center">✦1.412</td><td align="center">✦0.2352</td><td align="center">✦0.9408</td></tr><tr><td>Output /M</td><td align="center">✦4.2352</td><td align="center">✦1.412</td><td align="center">✦5.6472</td></tr><tr><td>Cache Write (5min) /M</td><td align="center">✦1.7648</td><td align="center">✦0.2936</td><td align="center">✦1.176</td></tr><tr><td>Cache Write (1h) /M</td><td align="center">✦1.7648</td><td align="center">✦0.2936</td><td align="center">✦1.176</td></tr><tr><td>Cache Read /M</td><td align="center">✦0.1408</td><td align="center">✦0.0232</td><td align="center">✦0.0944</td></tr><tr><td>Web Search /1K 次</td><td align="center">✦0.588</td><td align="center" colspan="2" style="text-align:center">✦0.588</td></tr></tbody></table>

### GLM（智谱）

官方定价8折

<table><thead><tr><th rowspan="2" width="180" valign="middle" style="vertical-align:middle">计费项</th><th colspan="2" align="center" style="text-align:center">glm-5.1</th><th colspan="2" align="center" style="text-align:center">glm-5</th></tr><tr><th align="center" style="text-align:center">Short context (&lt; 32K)</th><th align="center" style="text-align:center">Long context (≥ 32K)</th><th align="center" style="text-align:center">Short context (&lt; 32K)</th><th align="center" style="text-align:center">Long context (≥ 32K)</th></tr></thead><tbody><tr><td>Input /M</td><td align="center">✦0.7056</td><td align="center">✦0.9416</td><td align="center">✦0.4704</td><td align="center">✦0.7056</td></tr><tr><td>Output /M</td><td align="center">✦2.8232</td><td align="center">✦3.2944</td><td align="center">✦2.1176</td><td align="center">✦2.588</td></tr><tr><td>Cache Read /M</td><td align="center">✦0.1528</td><td align="center">✦0.2352</td><td align="center">✦0.1176</td><td align="center">✦0.1768</td></tr></tbody></table>

{% hint style="info" %}
以上价格仅供参考，实际以[模型广场](/#/models)展示为准。
{% endhint %}

## 购买与赠送

### 用户福利

- 注册即赠价值 $1 体验额度（有效期7天），无需购买即可开始使用

- 首充任意金额（最低 $1 起充），即赠 $3 额度

- 邀请好友最高可获价值 $150 免费额度（有效期30天）

- 更有兑换赠送（永久有效）等多种活动赢好礼

详情前往控制台 → [额度管理](/#/console/funds)查看

### 购买

PatewayAI 支持支付宝付款，人民币金额按当日汇率折算为美元，实际支付金额以支付页面展示为准。

| 支付金额 | 充值额度 | 充赠额度（永久有效） | 到账额度 |
| -------- | -------- | -------------------- | -------- |
| $1       | ✦1       | -                    | ✦1       |
| $3       | ✦3       | -                    | ✦3       |
| $5       | ✦5       | -                    | ✦5       |
| $10      | ✦10      | +✦0.5                | ✦10.5    |
| $20      | ✦20      | +✦2                  | ✦22      |
| $50      | ✦50      | +✦8                  | ✦58      |
| $100     | ✦100     | +✦25                 | ✦125     |
| $200     | ✦200     | +✦66                 | ✦266     |

{% hint style="info" %}
到账额度 = 充值额度 + 充赠额度，可用于调用平台上所有模型。
{% endhint %}

## 退款政策

### 退款方式

退款仅支持退回原支付账户（支付宝），不支持转换为其他形式的补偿。

### 申请方式

请发送邮件至 <support@pateway.ai>，邮件中需包含以下信息：

<table><thead><tr><th width="221.08984375">信息项</th><th>说明</th></tr></thead><tbody><tr><td>账号邮箱</td><td>注册 PatewayAI 时使用的邮箱</td></tr><tr><td>购买日期</td><td>充值发生的具体日期</td></tr><tr><td>支付金额</td><td>实际支付金额，单位美元</td></tr><tr><td>到账额度</td><td>充值后显示的到账额度</td></tr><tr><td>当前未使用额度</td><td>申请退款时账户剩余额度</td></tr><tr><td>退款原因</td><td>请详细说明退款原因</td></tr><tr><td>其他信息</td><td>任何您认为有助于处理的补充信息（选填）</td></tr></tbody></table>

### 处理流程

提交申请 → 审核（7 个工作日内）→ 退款处理 → 到账

- 审核阶段：收到申请后 7 个工作日内完成审核。
- 退款到账：审核通过后发起退款，受支付处理流程影响可能存在延迟。
- 退款金额以实际支付金额为基准。赠送额度不参与退款计算，且已消耗的额度（含赠送部分）不予退还。
- 特殊说明：受第三方支付机构政策变化或国际汇率变化等原因的影响，实际退款过程中可能会产生差额；用户申请退款的时效为自订单完成之日起365个自然日内。逾期（即超过365天）的，视为放弃退款权利，我方有权不予办理。
- 账户冻结说明：退款处理期间，为保障资金流转安全，系统将临时冻结您的 PatewayAI 账户。受技术限制，冻结期间无法进行充值和 API 调用。退款流程结束后账户将自动解冻，可恢复正常使用。

---

<!-- docs-icon: 🚀 -->

# 快速开始

## 注册账户

点击顶部导航栏”[快速开始/控制台](/#/console/keys)”，使用邮箱注册

## 获取 API Key

1. 进入控制台，点击「[创建 API Key](/#/console/keys?create=1)」
2. 复制并妥善保存生成的 Key

{% hint style="info" %}
注意：API Key 创建后仅显示一次，请立即保存。若遗失请在控制台删除旧 Key 并重新创建。
{% endhint %}

## 购买

1. 控制台 → [额度管理](/#/console/funds)
2. 选择购买档位，完成支付
3. 额度到账后即可调用 API（通常实时到账，可能存在延迟）

## 发起第一个请求

将 `YOUR_API_KEY`替换为你的实际 API Key：

{% tabs %}
{% tab title="使用 Anthropic 协议" %}

```
curl --request POST \
  --url https://api.pateway.ai/v1/messages \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好！"
      }
    ]
  }'
```

{% endtab %}
{% tab title="使用 OpenAI 协议（Responses）" %}

```
curl https://api.pateway.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.3-codex",
    "input": "Hello!",
    "stream": false
  }'
```

{% endtab %}
{% tab title="使用 OpenAI 协议（Chat Completions）" %}

```
curl https://api.pateway.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      { "role": "user", "content": "你好！" }
    ],
    "stream": false
  }'
```

{% endtab %}
{% endtabs %}