使用指南 | UnifyLLM Docs

服务节点与网络性能

UnifyLLM API 核心服务部署于美国洛杉矶，由 3 台 20 核 CPU、64 GB 内存的服务器组成集群，总计提供 60 核 CPU 和 192 GB 内存的计算资源，并配备 10 Gbps 专线带宽。

平台针对跨区域 API 请求使用国际专线及优化线路。无论用户位于亚太、欧洲还是北美地区，通常都可以获得良好的网络连接质量和响应表现。实际延迟仍可能受到用户所在地、当地运营商、上游模型负载、请求上下文长度及模型生成速度等因素影响。

正式扩大用量前，建议使用真实业务请求测试延迟和稳定性。重要的节点维护或基础设施变更会通过控制台和官方 Telegram 社群发布。

支持的国家和地区

UnifyLLM 目前主要面向以下国家和地区的用户提供服务：

亚太地区：日本、韩国、新加坡、马来西亚、泰国、越南、菲律宾、印度尼西亚、印度、澳大利亚和新西兰。
北美地区：美国、加拿大和墨西哥。
欧洲地区：英国、爱尔兰、法国、德国、荷兰、比利时、卢森堡、瑞士、奥地利、意大利、西班牙、葡萄牙、瑞典、挪威、丹麦、芬兰、波兰和捷克。
拉丁美洲：巴西、阿根廷、智利、哥伦比亚和秘鲁。
中东及非洲：阿联酋、沙特阿拉伯、卡塔尔、以色列、土耳其、南非、埃及和肯尼亚。

使用控制台

概览与数据面板：查看当前余额、累计用量、请求数量、模型使用情况、Token 消耗、费用趋势和近期调用。
API Key 管理：为不同项目创建独立 Key，并设置分组、有效期、额度、可用模型、IP 白名单及跨分组重试。
用量与任务日志：查看请求时间、Key、模型、分组、输入输出 Token、缓存用量、费用、耗时、流式状态、Request ID 和错误信息；图像、视频等异步任务可在任务日志中查询。
钱包：在线充值、兑换充值码、查看余额和账单记录，并在功能开放时管理邀请奖励。
额度预警：设置余额预警阈值，通过 Email、Webhook、Bark 或 Gotify 接收通知。
Playground：在正式接入应用前快速测试模型、提示词和 API Key。

额度、货币与退款

UnifyLLM 使用 ⚡️ 作为站内额度单位，当前参考换算关系为：

人民币、港币和日元金额为参考值，可能随汇率产生少量波动。实际扣费以价格页面和用量日志显示的金额为准。

用户可以申请退还实际充值且尚未消费的余额，平台不收取退款手续费。已消费额度、测试额度、赠送额度、活动奖励和推广收益不属于现金退款范围；可退款金额以账户中实际充值且尚未消费的余额为限，原支付渠道的规则仍可能适用。

⚡️1 = US$0.147
⚡️1 ≈ 人民币 ¥1
⚡️1 ≈ 港币 HK$1.15
⚡️1 ≈ 日元 JP¥23

选择模型分组

UnifyLLM 根据模型来源、服务稳定性、供应情况和价格划分模型分组。长期分组为 default、standard 和 prime，其他分组通常属于随市场供应变化的临时分组。

分组倍率是计费系数，不代表模型智能水平或生成速度的倍数。同一模型基础价格不变时，分组倍率会影响该分组下的最终价格；折扣标签是控制台展示的对比参考，具体模型的实际扣费仍以价格页面和用量日志为准。

default——1x 倍率，约优惠 85%：模型来源较为多样，因此质量、延迟和可用性可能出现波动。价格通常约为官方价格的 15%，适合学习、测试、批量任务及非关键业务。扩大用量前请使用真实业务请求进行测试，不建议作为关键生产系统的唯一线路。
standard——4x 倍率，相较 prime 约优惠 43%：通常以官方 API 或接近官方品质的稳定来源为主，模型表现几乎与官方持平。价格低于官方服务，但市场货源不足时仍可能偶发不可用。平台会通过负载均衡尽可能保障持续性，推荐大多数生产环境优先选择。
prime——7x 倍率，稳定性基准分组：价格通常接近官方价格，部分模型可能略高于官方价格，因此不承诺固定折扣。平台会投入更多资源维护供应和服务稳定性。对于不特别在意价格、但重视生产可靠性的用户，prime 是最佳选择。
临时分组——倍率和折扣动态调整：codex、kiro、cli、ccmax 等分组通常根据供应来源命名，价格可能比 default 更低，实用性和性价比很高，但倍率、折扣、可用性和持续时间都会受到上游供应或风控政策影响。建议用于可替换、可重试或成本敏感的任务，关键业务应准备备用模型或分组。

通过 default 调用前缀模型

default 分组还会通过模型名称前缀，提供部分其他分组中常用的模型。这样，用户无需为每个分组分别创建 API Key，一个 default 分组的 Key 就可以访问多个服务等级。

例如，以下模型名称表示使用 default 分组的 Key，通过 prime 分组调用 gpt-5.5：

1prime/gpt-5.5

使用限制与合规责任

UnifyLLM 仅允许用户将平台服务用于合法、合规的个人或商业用途。任何用户均不得利用本站服务违反适用法律法规、公共秩序、模型供应商政策或平台用户协议。

一经发现或有合理证据表明用户存在上述行为，平台有权立即暂停服务并永久封禁相关账号，账户剩余额度不予退还。在适用法律允许或要求的范围内，平台可能保存相关证据，并向有管辖权的司法机关、执法机关或监管机构报告或移交。

用户应对其账号、API Key 及通过平台发起的所有请求承担责任。在适用法律允许的最大范围内，UnifyLLM 不承担因用户违法违规使用而产生的责任、损失或第三方索赔。使用服务前，请认真阅读完整的用户协议。

不得实施诈骗、网络攻击、恶意自动化或其他违法活动。
不得生成、传播或协助制作违法违规内容。
不得侵犯他人隐私、知识产权或其他合法权益。
不得绕过安全限制、滥用平台资源或干扰平台正常运行。
不得以可能导致个人、组织或社会遭受损害的方式使用平台。

用户数据与隐私

UnifyLLM 不收集或持久化保存用户通过 API 提交的提示词、文件、模型输入及模型输出。请求内容仅在完成转发所必需的时间内由网关临时处理，并发送给所选模型供应商。

平台不会将请求内容用于广告、用户画像或模型训练，也不会出售、出租或交易用户数据。

为了完成计费、用量统计和故障排查，平台仅保留必要的调用元数据：

请求仍会发送给所选的上游模型供应商，因此同时受到对应供应商数据处理政策的约束。请勿通过任何第三方模型 API 提交密码、支付信息、身份凭证或其他不必要的高度敏感数据。更多信息请参阅平台隐私政策。

请求时间和 Request ID。
API Key 标识、模型及分组。
输入、输出和缓存 Token 用量。
实际费用、响应耗时、调用状态及必要的错误信息。

API 文档与供应商参考

UnifyLLM 已在接口参考中提供常用接口、请求参数和示例。由于篇幅有限且供应商能力会持续变化，接口参考不会列出所有支持参数和使用场景。使用高级参数或供应商专有能力时，请同时查阅原模型供应商的官方文档。

公告、社群与客服

模型上下架、价格调整、系统维护、分组供应和其他服务变更，会通过以下一个或多个渠道发布：

生产用户建议同时关注两个渠道。需要客服协助时，可以联系 Telegram 客服 @sunsky89757。排查 API 问题时，请提供用户 ID、请求时间、模型、分组、Request ID 和错误信息，但不要发送完整 API Key。

测试额度与企业支持

新用户加入官方 Telegram 社群后，可以联系 @sunsky89757并提供用户 ID，领取 ⚡️3 测试额度，用于了解平台是否符合自身需求。

个人创业者、企业或团队可以通过官网联系我们页面提交申请。平台会根据项目方向、实际用途、预计用量和审核结果，向通过审核的项目提供最高价值 US$1,000 的扶持额度。

对于具有长期、稳定且较大 API 用量的客户，平台可以提供专线、更具竞争力的价格，并根据业务需求签订合同或开具相应发票。请联系 Telegram 客服 @sunsky89757，或发送邮件至 [email protected]进一步洽谈。

合作伙伴与模型需求

如果你希望通过 new-api 等系统转售 UnifyLLM API、将平台集成到自己的产品，或向客户和朋友推荐本站，我们欢迎合作对接。

平台可以根据预计用量和合作方式提供合作伙伴价格，或设计长期、持续的推广分佣方案。合作不收取代理费或咨询费，具体价格、结算方式、双方责任和合规要求会根据合作模式另行确认。

如果平台暂未上架你需要的模型，也可以随时联系 @sunsky89757或发送邮件至 [email protected]。对于需求明确且具备持续用量的模型，平台可以评估新增供应渠道。