开始使用 OMENT

快速开始

从一枚 API Key 开始，
把模型能力接入你的工作流。

在 oment 控制台创建密钥，选择适合你的接入方式。跟随下面的步骤，完成第一次调用。

模型接入地址https://oment.cc/v1

开始前的准备

打开 oment.cc，注册或登录账号。在控制台确认账户状态、可用额度，以及你需要使用的模型和分组。

进入 API Key 页面，创建密钥并选择可用分组。建议为不同设备或项目分别创建密钥，并按需要设置额度、有效期和访问限制。

使用 CC Switch 管理客户端配置，或在兼容客户端中手动填写接入地址和密钥。具体协议与模型，以控制台该分组提供的配置为准。

如果你已经使用 CC Switch（CCS），可以优先使用控制台提供的导入功能。还没有安装时，可前往 CC Switch 发布页 ↗ 下载适合操作系统的版本。

没有看到导入入口？

直接使用下面的手动配置方式。客户端支持情况和按钮名称可能随版本变化，以控制台实际显示为准。

在兼容客户端中添加自定义服务商，填写以下信息。若控制台提供「使用密钥」或配置向导，优先复制该密钥对应的完整配置。

不同客户端对地址格式的要求不同。如果客户端会自动追加 /v1，请按它的说明填写，避免出现 /v1/v1。使用 Codex CLI 或 OpenCode 时，优先按控制台针对该客户端生成的配置操作，不要把通用 HTTP 配置直接套用到所有客户端。

以密钥对应的接入地址为准

本文使用 https://oment.cc/v1 演示。若控制台为分组提供了不同地址、协议或认证方式，请使用控制台展示的配置。

先在客户端发送一句简单的问候，再到控制台查看调用记录。开发者也可以使用下面的命令检查模型列表；此示例适用于提供 /models 接口的兼容分组。

export OMENT_API_KEY='替换为你的模型调用密钥'

curl 'https://oment.cc/v1/models' \
  -H "Authorization: Bearer $OMENT_API_KEY"

能读取模型列表只说明密钥和该接口可用。正式接入前，还需用你选择的模型完成一次实际请求，并核对用量、价格和返回格式。

密钥相当于你的调用凭证

不要把完整密钥写进网页前端、公开代码仓库、群聊或截图。应用应在服务端通过环境变量读取密钥。发现泄露时，立即在控制台停用或删除旧密钥，再创建新密钥。

现象	建议检查
401 / 认证失败	密钥是否完整、有效；认证头与客户端协议是否匹配。
403 / 无权访问	账户、分组、IP 限制及模型权限是否允许本次请求。
404 / 接口不存在	Base URL 是否多写或漏写路径；当前分组是否支持该接口。
429 / 请求受限	额度、并发和频率限制；按响应提示等待后再试。
超时 / 5xx	网络和上游状态；避免连续快速重试造成重复消耗。

仍然无法使用时，请带上发生时间、客户端版本、模型 ID 和脱敏后的错误信息，前往联系我们。

了解密钥、账户和用量管理接口。

接入遇到问题？通过 QQ 群联系我们。