> ## Documentation Index > Fetch the complete documentation index at: https://omnirelay.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # 用户手册 > 从注册、选模型与创建 Key，到调用、用量、充值及故障排查。 核对日期：2026-10-24。适用于当前客户控制台；模型权限、价格与付款方式以自己的账户页面和 API 返回为准。 ## 1. 注册、登录与工作空间 打开[控制台](https://omnirelay.ai/login)，使用 Google、GitHub 或邮箱登录。受邀加入时使用邀请邮箱对应的账户，登录后核对头像菜单里的邮箱和工作空间。 点击右上角头像 → **添加账号**，完成另一个账户的登录；之后在**切换账号**列表选择已登录账户。切换会重新加载目标账户的数据，账户之间不共享余额、Key 或权限。仅退出当前账户不会退出列表中的其他账户；会话过期时需重新登录。共享设备上请逐个退出不再使用的账户。 注册登录后即可在**模型广场**浏览平台支持的有效模型与价格，与服务是否开通无关。实际调用前，在**总览 → 真实模型服务**查看状态；该卡片仅出现在总览，不展示已开通模型清单。注册验证后平台按当前策略自动处理开通；旧账户或尚未提交的账户可在卡片提供入口时点击**申请开通**。申请进入后台队列，不保证立即可调用。等待充值、开通中或需联系支持时按页面提示处理；真实调用仍需可用余额、有效 Key、模型权限及完成配置核验。 手机通过左上角菜单展开导航，点击遮罩或关闭按钮收起；账户菜单支持滚动，较宽表格可在表格内横向滑动。抽屉独立滚动，底部操作保持可见。 ## 2. 认识控制台 | 页面 | 用途 | | - | - | | 总览 | 查看服务状态、余额、累计充值、请求及消费趋势。 | | API Keys | 创建、设置、轮换及撤销 Key；配置模型范围、预算、到期时间、默认标签、请求上限和 IP 白名单。 | | 模型广场 | 浏览平台支持的模型、精确 ID、价格及工作空间调用状态。 | | 模型体验 | 使用自己的 Key 测试真实文本对话，查看回复、用量、费用和代码。 | | 用量日志 | 查看 Token、费用、错误和耗时的汇总与图表。逐条请求列表默认不显示；核查单次调用请把 Request ID 发给支持。 | | 账单与余额 | 查看可用余额、现金与体验金余额、累计充值、预算、付款记录（含支付渠道与支付方式）、发票与收据及资金流水。 | | 消息 | 阅读账户通知和公告、提交产品反馈，并在同一会话中查看管理员回复。 | | 账户设置 | 修改名称和账户时区，查看登录方式和自己的登录日志，管理账单资料及删除账户。 | | AI 助手 | 查询 OmniRelay 产品的一般用法；不读取账户隐私数据。 | 登录后，控制台右下角会显示 **AI 助手**。可询问 OmniRelay 的使用方法；使用范围和数据处理见[助手说明](https://omnirelay.ai/docs/cn/general/console-assistant.md)。若未配置平台助手，控制台可改用你选择的 OmniRelay 推理 Key，并按普通模型调用计费。你的近期对话内容会发送给回答问题的模型服务方，请勿输入密码、Key、付款资料或客户隐私数据。 ## 3. 选择模型 [公开模型目录](https://omnirelay.ai/models)用于发现和比较；**模型广场**展示平台支持的型号与工作空间调用状态；未开通时全部标记为需开通，仍可查看详情；带自己 Key 的 `GET /v1/models` 用于确认实际调用权限。公开目录的「待接通」「计费未核实」或未验证图像／视频模型不能直接调用。 点击模型卡片右上角信息图标，仅在当前页弹出详情，不跳转页面。详情用于查看价格、上下文与能力边界；关闭后继续浏览。使用精确模型 ID，不要把显示名称、品牌分组或同名别名当成权限。Key 设置中即使出现待接通条目，也不会因此开通。新增模型不会自动突破现有 Key 白名单，必要时调整 Key 的模型范围。 平台接入不表示所有客户或 Key 都有调用权限；调用前检查自己模型响应的 `capabilities`、`limits` 和价格。多数已接入文本模型最多输出 128,000 Token、默认 32,000（Gemini 3.1 Pro Preview 和 Gemini 3.6 Flash 最多 65,536）；DeepSeek V4 Pro、GLM 5.3 和 Kimi K3 默认且最多 4,096；GPT 5.4 Mini 默认 64、最多 256。 ## 4. 创建与保护 Key 服务完成开通后才能创建推理 API Key 和管理密钥。未开通时创建入口关闭，请先在总览按状态提示完成开通；充值本身不代表开通已完成。演示工作空间只生成模拟 Key。 为不同应用分别创建 Key。完整值在创建／轮换时显示，之后可点击**查看**并确认身份后再次查看；请保存到服务端安全配置，不要写入前端、仓库或支持邮件。轮换后旧值立即失效，需要同步更新应用配置；撤销后停止调用。 客户只使用 OmniRelay Key，不需要其他账号或凭证。管理密钥用于自动化管理，不用于模型推理，详见[管理 API](https://omnirelay.ai/docs/cn/general/management-api.md)。在 API Keys 页点击**管理密钥**标题旁的问号，可打开管理密钥帮助；该按钮仅显示图标。 ### 请求上限与 IP 白名单 在 **API Keys → 设置** 为 Key 配置每分钟请求次数、并发上限及 IP 白名单。留空时跟随账户范围的规则，不能用 Key 设置突破工作空间或成员上限。工作空间默认每分钟 120 次、并发 5；所有成员与 Key 共享，实际值以 API Keys 页为准。流式请求在结束前持续占用并发名额。 IP 白名单最多 20 个 IPv4／IPv6 地址或 CIDR 网段，每行一个；留空表示不限来源。填写应用对外出口 IP，而非电脑的局域网地址。白名单作用于 `/v1` 调用（包括模型列表），不作用于控制台模型体验；来源不匹配返回 `403 ip_not_allowed`，不产生费用。保存前确认部署出口，出口变化后同步修改。详见[限流](https://omnirelay.ai/docs/cn/overview/rate-limits.md)。 ## 5. 使用模型体验 选择工作空间中的模型及自己的有效 Key，确认模型权限、余额、预算和到期时间，勾选收费确认后发送文本。可以配置系统提示词、复制回复或查看代码；真实调用按所选 Key 的限制执行。 支持流式的模型默认勾选流式，生成的接入代码也使用流式。可取消勾选以读取完整 JSON；API 未传 `stream` 时仍按非流式处理。 刷新、离开页面或开始新对话可能丢失浏览器中的临时对话；请自行保存结果。模型不支持的工具、图片、结构化输出或采样参数不能通过 Playground 绕过。 ## 6. 将 API 接入应用 SDK Base URL 为 `https://api.omnirelay.ai/v1`；认证为 `Authorization: Bearer `。先查询模型，再发起请求。完整 cURL、Python、Node.js 示例见[首次 API 调用](https://omnirelay.ai/docs/cn/quickstart/first-api-call.md)。 流式调用前确认 `capabilities.stream: true`，传 `stream: true` 与 `stream_options.include_usage: true`。支持推理内容时，普通响应读取 `message.reasoning_content`，流式响应读取 `delta.reasoning_content`；推理内容支持不等于可以设置推理强度。详见[对话补全](https://omnirelay.ai/docs/cn/llms/chat-completions.md)。 `/v1` 请求体最多 4 MiB（4,194,304 字节 UTF-8），对话消息或 Responses 输入项最多 2,000 条，单个文本值最多 1,048,576 字符；模型自身上下文窗口仍适用。控制台输入限制、向量输入限制与 API 请求体限制分别计算。大型 Agent 历史会提高发送前的费用预留，调用前检查余额和预算。 ### GPT 5.6 Sol 接入 GPT 5.6 Sol 已按模型公开文档接入函数工具、JSON object/schema 与 Responses；新增组合待逐项真实调用验证。该文档规定 Chat 工具调用使用 `reasoning_effort: "none"`；工具与推理组合及 `max` 强度使用 Responses。采样建议配合 `none`，普通参数均透传并由模型服务方判断。被拒绝的字段见错误中的 `error.param`；不支持的字段也可能被忽略而不报错。详情见[对话补全](https://omnirelay.ai/docs/cn/llms/chat-completions.md)与[Responses](https://omnirelay.ai/docs/cn/llms/native-protocols.md)。 ### 全模型参数兼容 全部可调用模型均按入口匹配工具、采样、推理与协议。调用前查询自己的模型列表。DeepSeek 工具历史保留 `reasoning_content`；GLM 5.3 推理仅 low/high/max；GPT Astra 工具使用 Responses。参数错误查看 `error.param`。新增组合按文档开放，逐项真实调用验证尚待完成。详见[对话补全](https://omnirelay.ai/docs/cn/llms/chat-completions.md)。 当前模型调用采用参数透传；能力表用于建议，普通参数由模型服务方判断，可能忽略不支持的字段而不报错。平台保留权限、预算和最终用量结算。 ## 7. 用量与费用 `usage` 为经过验证的用量，`cost_microusd` 为已结算客户费用；1,000,000 微美元等于 1 美元。需要核查单次调用时，把响应头 `X-Request-ID` 发给支持。请求日志保存元数据，不保存完整提示词、回复或完整 Key。API 来源 IP 随每次调用记录，保留 90 天（为账户开启请求列表后在列表和 CSV 中显示）；超过保留期清空 IP 字段，其他记录按各自规则保留。 真实请求发送前会预留最高费用；短提示词也需可用余额和 Key 预算覆盖预留。最终按实际用量及冻结价格结算并释放未用金额。不要把模型目录单价、预留费用或另一模型的价格当成本次实际收费。超时、断流或结果不明确时，可能保留预留等待对账，不能据失败状态认定费用为零。 ## 8. 充值、预算、发票与收据 请求、登录、账单及操作日志按**账户设置 → 账户时区**显示，默认跟随浏览器；统计分桶和账期／预算周期仍按 UTC。24 小时概览将当前滚动 24 小时与紧接此前的 24 小时按相同筛选条件比较。**上一周期无数据**表示没有可比较基准（无请求或对应指标为零），不代表当前记录丢失。 在**账单与余额**充值：有多个支付渠道时先选择渠道，单次金额 10 至 1,000 美元。注册不会自动赠送余额；需要余额或遇到开通等待时联系支持。付款前先确认模型开通、价格与付款条件；正式收银台会产生真实付款，结果以订单页面为准。付款扣款未到账时保留订单号并联系支持，不重复付款。 账户余额、Key 预算、成员预算分别控制使用；充值不会自动提高 Key／成员预算。成员周期按 UTC 统计。 ### 用本地货币付款 充值按美元计价和入账。支付页面提供本地货币时，你可以改用本地货币付款：页面显示的金额已包含支付渠道的换汇手续费和汇率，余额始终按订单的美元金额入账。退款按你付款时的币种原路退回，退回的比例与订单一致。 ### 付款记录 **账单与余额 → 付款记录**列出每笔充值的**支付渠道**（Airwallex 或 Stripe）和**支付方式**，例如 `Visa •• 4242`、`Apple Pay · Visa •• 4242`、`微信支付`。用保存的支付方式扣款的记录会标为**一键充值**或**自动充值**。点击记录可查看详情。支付渠道尚未返回结果的付款显示为 `—`。 ### 发票与收据 发票和收据由支付渠道开具，OmniRelay 不自行开具。在已付款的记录上打开**发票与收据**： * **Stripe：**可**下载发票（PDF）**、**在线查看发票**和**查看 Stripe 收据**。发票使用你付款时在 Stripe 页面确认的名称、地址和税号。 * **Airwallex：**由 Airwallex 按你的**发票抬头**开具发票（PDF 及在线版本），首次打开时生成；未填写发票抬头时会先请你填写。Airwallex 不为单笔付款另开收据。 发票开具后，之后修改发票抬头不会改变已开具的发票。单据尚未生成时，对话框会说明，请稍后重试。 ### 账单资料（发票抬头） **账户设置 → 账单资料**保存开具发票所用的名称（公司或个人）、地址、税号和账单邮箱。工作空间还没有账单资料时，会根据首笔付款自动填写：Stripe 付款填入名称或公司、地址，以企业身份付款时还会填入税号；Airwallex 银行卡付款填入姓名、邮箱和地址。这样填写的资料会显示**已根据付款信息自动填写，请核对。**，直到你保存为止。你保存过的资料不会被之后的付款覆盖。支付渠道为你的工作空间建立开票客户后，公司／个人类型不能再更改。 ### 保存的支付方式与自动充值 充值时勾选**保存此支付方式**，或用**添加支付方式**不付款直接保存银行卡或钱包。保存的支付方式只属于你本人：同一工作区的成员看不到，也无法用它扣款；它只能通过保存它的支付渠道扣款。之后账单页会提供**用该支付方式一键充值**，银行仍可能要求验证。支付方式可随时移除，移除后不再扣款；已过期的卡会标注且不再提供。 **自动充值**在现金余额低于你设定的金额时，用保存的支付方式按设定金额扣款，每月合计不超过你设定的上限。开启前需同意页面上的授权说明，其中写明支付方式、金额、触发余额和月上限。每次自动扣款都会在付款记录中标为**自动充值**，并在消息中心和邮件中通知。连续两次扣款失败、支付方式被移除或卡已过期时会自动暂停，直到你重新开启；关闭后立即停止。 ### 现金、体验金与累计充值 现金余额来自实际充值及现金调整；体验金单独记录，不能作为现金退款。调用时优先预留并扣取体验金，再使用现金；结算后退回未使用的预留。**累计充值**是已到账充值的累计总额，包含充值到账及补记，不包含体验金，也不因消费或退款减少，不能当作当前余额。 资金流水按**现金／体验金**标识展示充值、退款、体验金发放及调整，不列出逐次模型调用、预留或释放。调用费用在**用量日志**查看。管理人员查看客户资金抽屉时，现金扣减和体验金扣减仅统计已结算调用的实际分摊，未结算预留不会计入；金额最多显示六位美元小数。 ## 9. 故障排查 | 情况 | 处理 | | - | - | | `401 unauthorized` | 核对 Bearer 格式、Key 到期／撤销状态及账户。 | | `403 model_not_allowed` | 检查 Key 模型白名单。 | | `404 model_unavailable` | 用自己的 Key 重新查询模型列表。 | | `400 invalid_parameter` / `unsupported_parameter` | 核对该模型能力、输出上限及字段值。 | | `402 inference_budget_or_access_denied` | 检查可用余额、已预留金额、Key／成员预算及开通状态；仍有问题联系支持。 | | `403 ip_not_allowed` | 从 Key 的 IP 白名单内的地址调用，或修改白名单。 | | `429 rate_limited` / `concurrency_limited` / `upstream_rate_limited` | 确认的拒绝，不产生费用：等待 `Retry-After` 后重试。 | | `413 payload_too_large` | 请求体超过 4 MiB；缩短历史或工具结果，核对模型上下文。 | | 超时、`5xx`、流式错误或缺少 `[DONE]` | 按[错误处理](https://omnirelay.ai/docs/cn/general/errors.md)中的错误码判断：未送达任何输出的调用不收费。关闭 SDK 自动重试，不盲目重发付费请求。 | 更多说明见[错误处理](https://omnirelay.ai/docs/cn/general/errors.md)。提交支持信息时包含时间、工作空间、模型 ID、Request ID、错误码及必要订单号，勿提供完整 Key。查看[服务状态](https://omnirelay.instatus.com)，或联系 [support@omnirelay.ai](mailto:support@omnirelay.ai)。 ## 10. 账户与数据 **账户设置 → 登录日志**显示自己的浏览器及 UA、IP、登录时间、最后活动、结束时间、状态和登录时长，不显示设备主机名。时长基于已观测活动；30 分钟无活动显示不活跃，时长截至最后活动，并非精确的在线监测。仅记录功能上线后被观测到的会话。平台授权运营人员可在管理后台查看登录日志，普通客户不能查看其他账户。 可在**账户设置 → 账户时区**选择日志显示时区。默认跟随浏览器，也可保存固定时区，适用于请求、登录、账单及操作记录。数据库时间和计费周期保持 UTC；统计页面会注明分桶口径。 账户设置中的邮箱为只读，修改名称不会改变账户身份。删除前导出记录、处理余额和待对账请求，必要时交接工作空间所有者。删除会撤销密钥并结束访问，详情以页面确认提示为准。 提交真实模型的内容会转发给模型服务方；请求数据库不保存正文不等于所有系统零保留。详见[数据处理](https://omnirelay.ai/docs/cn/general/data-handling.md)、[隐私政策](https://omnirelay.ai/privacy?lang=zh)与[服务条款](https://omnirelay.ai/terms?lang=zh)。 GPT 5.4 Mini 还通过 API 支持函数工具、JSON object/schema 和 [Responses](https://omnirelay.ai/docs/cn/llms/native-protocols.md)。切换协议前核对模型能力标志。性能视图显示已观测流式请求的 TTFT P50／P95 及样本数；非流式请求没有首 Token 延迟样本。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.