Ontoway 帮助中心

从准备账户、充值与创建密钥，到配置客户端和排查错误，都可以从这里开始。本文中的操作入口、示例域名和支持方式均对应 Ontoway。

常用入口

要做什么	直接打开
进入控制台	账户控制台
登录 / 注册	登录 · 注册
创建、复制和管理 Key	API 密钥
充值、兑换或查看套餐	钱包
查看充值订单	钱包订单记录
查看模型及价格	模型价格
查看请求与消耗	使用日志
网页调试	模型操练场
返回官网	ontoway.ai

需要账户的页面会先要求登录。API 调用使用 api.ontoway.ai；ontoway.ai 是官网，docs.ontoway.ai 是文档站。

1. 充值与购买套餐

登录后打开钱包。
按量使用时，在充值区域选择金额和页面提供的支付方式，核对实际支付金额后继续。
购买套餐时，查看钱包中的订阅套餐区域，核对额度、周期、有效期和适用条件后下单。
完成付款后返回钱包刷新，查看余额、订阅状态和订单记录。

支付入口和套餐以登录后的页面为准。若页面暂未提供某种方式，可联系支持咨询。已付款但状态未更新时，保留订单号与付款时间核对，避免重复支付。

更多说明：充值、套餐与用量。

2. 使用兑换码

Ontoway 用户的兑换入口位于钱包。

找到钱包中的兑换码输入区域。
粘贴完整兑换码，确认没有空格或遗漏字符。
提交兑换，按页面提示查看结果，并刷新对应的额度或权益。
若提示无效、过期或已使用，先确认兑换码来源和使用记录，再联系支持核对。

兑换内容与有效期以发放时的说明为准。不要将完整兑换码发布到群聊、截图或公开工单中。

3. 创建 API Key

打开 API 密钥，选择创建密钥。
为用途命名，例如 claude-laptop、codex-work 或 cherry-home。
选择账户可用的分组，设置过期时间和密钥额度；需要时配置模型限制和 IP 白名单。
保存后，在该密钥行的操作菜单选择复制密钥。
将 Key 填入你信任的客户端，并发送一个简短测试请求。

密钥备注用于识别用途，不会自动改变分组或扣费偏好。建议不同应用分别使用独立密钥；失效或泄露的 Key 应及时停用、删除并替换。

完整说明：API Key 与分组。

4. 套餐、分组、模型与协议

这四项需要分别核对：

项目	在哪里看	决定什么
余额 / 订阅	钱包	可用额度、套餐周期和消费偏好
分组	密钥配置及账户可选项	模型路由范围和相应价格配置
模型 ID	模型价格页、当前 Key 的模型列表	实际请求哪个模型
接口协议	客户端配置及模型说明	URL、认证头和 JSON 请求结构

不要凭分组名称推断协议，也不要把密钥备注中的“余额”“订阅”当作系统规则。使用哪种协议由客户端与渠道能力共同决定。

使用场景	Base URL	常见完整请求地址
OpenAI 兼容聊天	`https://api.ontoway.ai/v1`	`https://api.ontoway.ai/v1/chat/completions`
Codex / Responses	`https://api.ontoway.ai/v1`	`https://api.ontoway.ai/v1/responses`
Claude / Messages	`https://api.ontoway.ai`	`https://api.ontoway.ai/v1/messages`
Gemini 原生	`https://api.ontoway.ai`	`https://api.ontoway.ai/v1beta/models/{model}:generateContent`

复制模型价格页面中的完整 ID；开发者也可用当前 Key 查询 GET /v1/models。以下示例中的模型占位符必须替换，模型可见也不保证渠道实时可用。

5. OpenAI 兼容 API

客户端供应商名称可填 Ontoway，Base URL 填 https://api.ontoway.ai/v1，密钥使用 Ontoway Key。认证头采用 Authorization: Bearer。

以下示例使用 Bash，先替换密钥和模型：

bash

export ONTOWAY_API_KEY="替换为你的 Ontoway API Key"

curl --fail-with-body https://api.ontoway.ai/v1/chat/completions \
  -H "Authorization: Bearer $ONTOWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为可用的模型 ID",
    "messages": [{"role": "user", "content": "你好，请简短回复。"}]
  }'

流式请求设置 stream: true，客户端按 SSE 解析。图像生成使用 /v1/images/generations，不能直接向聊天端点发送同样的生图请求。

详细示例：Chat Completions、Responses 与 Python SDK · 图像生成。

6. Anthropic / Claude API

Anthropic 客户端的 Base URL 填 https://api.ontoway.ai，由客户端补齐 /v1/messages。手动请求示例：

bash

curl --fail-with-body https://api.ontoway.ai/v1/messages \
  -H "x-api-key: $ONTOWAY_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为可用的 Claude 模型 ID",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "你好，请简短回复。"}]
  }'

这里的 ONTOWAY_API_KEY 使用上一节设置的环境变量。工具调用、思考模式和多模态参数应按实际模型能力启用，详见 Anthropic Messages。

7. CC Switch 一键导入

Ontoway 已提供密钥行菜单中的 CC Switch 导入入口。

从 CC Switch 发布页下载安装，并打开一次。
进入 Ontoway API 密钥。
找到目标密钥，打开该行操作菜单，选择 CC Switch。
在弹窗选择 Claude / Codex / Gemini，名称填写 Ontoway，选择主模型；Claude 可按需设置其他模型映射。
点击“打开 CC Switch”，允许浏览器唤起本机应用，核对供应商、地址和 Key 后导入。
启用刚导入的供应商，重启目标客户端并测试。

导入链接包含密钥，只在可信设备上使用。没有唤起应用时，可按手动配置说明操作。

8. Claude Code

可以先使用上面的 CC Switch 导入，也可以在当前终端临时配置：

macOS / LinuxWindows PowerShellWindows CMD

bash

export ANTHROPIC_BASE_URL="https://api.ontoway.ai"
export ANTHROPIC_AUTH_TOKEN="替换为你的 Ontoway API Key"
claude --model "替换为可用的 Claude 模型 ID"

powershell

$env:ANTHROPIC_BASE_URL = "https://api.ontoway.ai"
$env:ANTHROPIC_AUTH_TOKEN = "替换为你的 Ontoway API Key"
claude --model "替换为可用的 Claude 模型 ID"

bat

set "ANTHROPIC_BASE_URL=https://api.ontoway.ai"
set "ANTHROPIC_AUTH_TOKEN=替换为你的 Ontoway API Key"
claude --model "替换为可用的 Claude 模型 ID"

启动后用 /status 检查实际地址，再到使用日志确认请求。旧环境变量或其他供应商配置可能覆盖当前设置，切换后需要重新启动客户端。

详见 Claude Code 指南。

9. Claude Desktop

适用于桌面应用的第三方推理 / Gateway 模式：

字段	配置
Inference provider	Gateway
Credential kind	Static API key
Gateway base URL	`https://api.ontoway.ai`
Gateway API key	Ontoway Key
Gateway auth scheme	Bearer，或客户端支持的 x-api-key

在支持的版本中，从 Help → Troubleshooting 启用开发者模式，重启后进入 Developer → Configure Third-Party Inference，填写网关参数并应用本地设置。按提示重启，通过 Gateway 进入，并核对实际模型和请求记录。

组织管理策略可能限制此入口。不能仅凭 CLI 环境变量已设置就判断桌面应用已经接入。安装、版本限制和故障处理见 Claude Desktop 指南。

10. Codex CLI

Codex 使用 Responses 协议。先给当前终端设置密钥环境变量：

macOS / LinuxWindows PowerShell

bash

export ONTOWAY_API_KEY="替换为你的 Ontoway API Key"

powershell

$env:ONTOWAY_API_KEY = "替换为你的 Ontoway API Key"

在用户级 ~/.codex/config.toml 中合并下面的配置，保留已有其他设置，避免重复定义字段：

toml

model = "替换为可用的模型 ID"
model_provider = "ontoway"

[model_providers.ontoway]
name = "Ontoway"
base_url = "https://api.ontoway.ai/v1"
env_key = "ONTOWAY_API_KEY"
wire_api = "responses"

在同一终端启动 codex。这里的 env_key 是变量名称，不是真实密钥；Base URL 不填写完整的 /responses 路径。

Windows 配置路径、启动检查和官方字段参考见 Codex CLI 指南。

11. Codex++

从 CodexPlusPlus 发布页获取对应系统的版本。在供应商配置或供应商池中添加：

字段	配置
名称 / ID	`Ontoway` / `ontoway`
控制台	`https://api.ontoway.ai/dashboard`
Base URL	`https://api.ontoway.ai/v1`
API Key	Ontoway Key
协议	Responses
模型	当前分组支持的模型 ID

保存并启用供应商。使用本地网关模式时，还需接入目标 Agent 并指定模型；按工具提示重新启动客户端后测试。官方 Codex CLI 与第三方 Codex++ 的配置入口不同，详见 Codex++ 指南。

12. Cursor

打开 Cursor Settings → Models。如果当前版本提供自定义 OpenAI Base URL，将地址设为 https://api.ontoway.ai/v1，填入 Ontoway Key，并选择当前分组可用的模型。

保存后发送一条聊天消息，在使用日志确认请求确实进入 Ontoway。仅支持官方 Key、没有地址覆盖项的入口不能直接作为 Ontoway 接入入口。

自定义 Key 的能力范围受 Cursor 限制，例如 Tab 补全不会因此改用 Ontoway。详见 Cursor 指南。

13. Cherry Studio

打开 Cherry Studio 的设置，进入模型服务并添加自定义供应商。
名称填写 Ontoway，类型选择 OpenAI 兼容。
Base URL 填 https://api.ontoway.ai/v1，Key 使用 Ontoway 密钥页中的密钥。
获取模型列表或手动添加完整模型 ID。
启用供应商，新建对话并选择该模型。
核对返回内容与 Ontoway 日志。

如果客户端会自动补齐 /v1，按其字段提示调整，最终请求不要出现 /v1/v1。详见 Cherry Studio 指南。

14. 常见问题

问题	检查方向
401 / 密钥错误	Key 是否完整、已启用、未过期，认证头是否与协议一致
model_not_found	模型 ID、密钥模型限制、分组是否匹配
余额充足仍无法调用	另行检查密钥额度、套餐状态和钱包消费偏好
404 / 地址错误	最终请求是否重复 `/v1`，是否误填文档站或网页路径
429 / 请求受限	降低并发和频率，采用有限重试与退避
502 / 503	检查渠道可用性、代理连接；持续失败时提供请求 ID
客户端不显示请求记录	检查当前供应商和旧配置；认证前失败也可能没有消费日志
支付已完成但未到账	刷新钱包，查看订单，提供订单号与付款时间核对

更详细的定位步骤见故障排查。

15. 账户和密钥保护

为不同应用分别创建 Key，按需设置额度和有效期。将密钥存入可信客户端、环境变量或服务端密钥管理系统，不要放入公开网页、仓库或分享截图。

发现异常时先在密钥页撤销旧 Key，再创建替代密钥并检查使用日志。删除一张截图并不能让已经泄露的 Key 重新安全。

完整说明：密钥安全。

16. 获取支持

联系 support@ontoway.ai，或查看控制台公布的支持入口。

请提供问题时间与时区、客户端版本、模型和分组、错误信息及请求 ID。订单问题附订单号和脱敏付款凭证。不要发送密码、验证码、完整 API Key、Cookie 或完整兑换码。

问题反馈模板 · 用户协议 · 隐私政策

17. xAI / Grok

Grok 聊天可按 OpenAI 兼容接口接入：Base URL 为 https://api.ontoway.ai/v1，Key 为 Ontoway Key，模型填写当前账户可用的完整 Grok ID。

使用第 5 节的聊天请求结构，将模型替换为可用的 Grok 模型。联网、工具调用和图片能力需分别核对；图像模型请按对应接口发送请求。

完整示例：xAI / Grok 指南。

18. Nano Banana / Gemini 图像模型

在模型价格页面确认真实模型 ID 和支持的协议。Gemini 原生端点为：

text

https://api.ontoway.ai/v1beta/models/{model}:generateContent
https://api.ontoway.ai/v1beta/models/{model}:streamGenerateContent?alt=sse

其中 {model} 替换为当前模型 ID，认证使用 x-goog-api-key，请求结构使用 contents / parts。是否需要图像输出模态、输入图片和额外参数，以实际模型说明为准。

若渠道提供 OpenAI Images 兼容接入，则按 /v1/images/generations 的结构调用。不能把展示名称、固定别名或一种接口的 JSON 直接套到所有渠道。

继续阅读：Nano Banana / Gemini 生图 · Gemini 原生示例 · 图像生成示例。

Ontoway 帮助中心 ​

常用入口 ​

1. 充值与购买套餐 ​

2. 使用兑换码 ​

3. 创建 API Key ​

4. 套餐、分组、模型与协议 ​

5. OpenAI 兼容 API ​

6. Anthropic / Claude API ​

7. CC Switch 一键导入 ​

8. Claude Code ​

9. Claude Desktop ​

10. Codex CLI ​

11. Codex++ ​

12. Cursor ​

13. Cherry Studio ​

14. 常见问题 ​

15. 账户和密钥保护 ​

16. 获取支持 ​

17. xAI / Grok ​

18. Nano Banana / Gemini 图像模型 ​

Ontoway 帮助中心

常用入口

1. 充值与购买套餐

2. 使用兑换码

3. 创建 API Key

4. 套餐、分组、模型与协议

5. OpenAI 兼容 API

6. Anthropic / Claude API

7. CC Switch 一键导入

8. Claude Code

9. Claude Desktop

10. Codex CLI

11. Codex++

12. Cursor

13. Cherry Studio

14. 常见问题

15. 账户和密钥保护

16. 获取支持

17. xAI / Grok

18. Nano Banana / Gemini 图像模型