1. 注册、登录与工作空间
打开控制台，使用 Google、GitHub 或邮箱登录。受邀加入时使用邀请邮箱对应的账户，登录后核对头像菜单里的邮箱和工作空间。 点击右上角头像 → 添加账号，完成另一个账户的登录；之后在切换账号列表选择已登录账户。切换会重新加载目标账户的数据，账户之间不共享余额、Key 或权限。仅退出当前账户不会退出列表中的其他账户；会话过期时需重新登录。共享设备上请逐个退出不再使用的账户。 注册登录后即可在模型广场浏览平台支持的有效模型与价格，与服务是否开通无关。实际调用前，在总览 → 真实模型服务查看状态；该卡片仅出现在总览，不展示已开通模型清单。注册验证后平台按当前策略自动处理开通；旧账户或尚未提交的账户可在卡片提供入口时点击申请开通。申请进入后台队列，不保证立即可调用。等待充值、开通中或需联系支持时按页面提示处理；真实调用仍需可用余额、有效 Key、模型权限及完成配置核验。 手机通过左上角菜单展开导航，点击遮罩或关闭按钮收起；账户菜单支持滚动，较宽表格可在表格内横向滑动。抽屉独立滚动，底部操作保持可见。2. 认识控制台
登录后，控制台右下角会显示 AI 助手。可询问 OmniRelay 的使用方法；使用范围和数据处理见助手说明。若未配置平台助手，控制台可改用你选择的 OmniRelay 推理 Key，并按普通模型调用计费。你的近期对话内容会发送给回答问题的模型服务方，请勿输入密码、Key、付款资料或客户隐私数据。
3. 选择模型
公开模型目录用于发现和比较；模型广场展示平台支持的型号与工作空间调用状态；未开通时全部标记为需开通，仍可查看详情；带自己 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。在 API Keys 页点击管理密钥标题旁的问号，可打开管理密钥帮助；该按钮仅显示图标。请求上限与 IP 白名单
在 API Keys → 设置 为 Key 配置每分钟请求次数、并发上限及 IP 白名单。留空时跟随账户范围的规则，不能用 Key 设置突破工作空间或成员上限。工作空间默认每分钟 120 次、并发 5；所有成员与 Key 共享，实际值以 API Keys 页为准。流式请求在结束前持续占用并发名额。 IP 白名单最多 20 个 IPv4／IPv6 地址或 CIDR 网段，每行一个；留空表示不限来源。填写应用对外出口 IP，而非电脑的局域网地址。白名单作用于/v1 调用（包括模型列表），不作用于控制台模型体验；来源不匹配返回 403 ip_not_allowed，不产生费用。保存前确认部署出口，出口变化后同步修改。详见限流。
5. 使用模型体验
选择工作空间中的模型及自己的有效 Key，确认模型权限、余额、预算和到期时间，勾选收费确认后发送文本。可以配置系统提示词、复制回复或查看代码；真实调用按所选 Key 的限制执行。 支持流式的模型默认勾选流式，生成的接入代码也使用流式。可取消勾选以读取完整 JSON；API 未传stream 时仍按非流式处理。
刷新、离开页面或开始新对话可能丢失浏览器中的临时对话；请自行保存结果。模型不支持的工具、图片、结构化输出或采样参数不能通过 Playground 绕过。
6. 将 API 接入应用
SDK Base URL 为https://api.omnirelay.ai/v1；认证为 Authorization: Bearer <OmniRelay Key>。先查询模型，再发起请求。完整 cURL、Python、Node.js 示例见首次 API 调用。
流式调用前确认 capabilities.stream: true，传 stream: true 与 stream_options.include_usage: true。支持推理内容时，普通响应读取 message.reasoning_content，流式响应读取 delta.reasoning_content；推理内容支持不等于可以设置推理强度。详见对话补全。
/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；不支持的字段也可能被忽略而不报错。详情见对话补全与Responses。
全模型参数兼容
全部可调用模型均按入口匹配工具、采样、推理与协议。调用前查询自己的模型列表。DeepSeek 工具历史保留reasoning_content；GLM 5.3 推理仅 low/high/max；GPT Astra 工具使用 Responses。参数错误查看 error.param。新增组合按文档开放，逐项真实调用验证尚待完成。详见对话补全。
当前模型调用采用参数透传；能力表用于建议，普通参数由模型服务方判断，可能忽略不支持的字段而不报错。平台保留权限、预算和最终用量结算。
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. 故障排查
更多说明见错误处理。提交支持信息时包含时间、工作空间、模型 ID、Request ID、错误码及必要订单号，勿提供完整 Key。查看服务状态，或联系 support@omnirelay.ai。