CometAPI

CometAPI 是什么

CometAPI 是面向开发者和企业的多模型 API 聚合平台，用一套账户、密钥和计费体系连接不同厂商的文字、图像、视频与音频模型。它主要解决多家模型接口格式、密钥、账单和切换逻辑分散的问题。

产品关于页称 CometAPI 于 2025 年 1 月由 Sonic 创办，服务面向全球专业用户；公开条款适用香港法律。当前公开页面未给出完整运营法人名称，企业采购时应在合同、发票和数据处理文件中进一步确认签约主体。

主要功能

统一模型目录与接口

• 通过单个 CometAPI 密钥调用多个提供商的模型，覆盖对话、推理、编程、图像生成与分析、视频、语音和音乐等任务。
• 公开模型目录提供模型标识、提供商、能力、可用端点和计费信息，应用可在运行前查询当前目录。
• 常见文字、图像、音频和视频工作流采用 OpenAI 兼容请求格式，已有 OpenAI SDK 项目通常只需替换基础地址、密钥和模型标识即可开始迁移测试。
• 并非每个模型都支持完全相同的参数、输入或返回结构，接入前需要查阅该模型的端点说明，不能仅替换模型名称。

文字、图像、视频与音频能力

模型切换与故障回退

• 应用可以在保持同一密钥和接口地址的前提下，把主模型切换为能力兼容的备用模型。
• 官方文档建议仅对连接失败、超时、限流和临时服务端错误执行回退；参数错误、密钥错误和不受支持字段应直接修复。
• 如需再回退到模型厂商直连接口，必须另备厂商账户、密钥、预算和模型标识，直连产生的费用也会单独结算。
• 跨模型家族时要统一输入和输出字段，并验证工具调用、视觉、上下文长度和结构化输出等必需能力。

异步任务、轮询与回调

• 视频等长任务创建后会返回任务标识，应用可以轮询任务状态，直到成功、失败或取消。
• 只有选定端点明确支持时才能配置回调地址；各提供商回调负载不完全统一，应用应保存原始事件并自行规范化。
• 轮询应作为丢失回调时的最终状态依据，回调处理需按任务标识实现幂等，避免重复通知造成重复入库。
• 完成结果可能通过结果字段或内容下载端点返回，具体形式以模型页面为准。

工作区与团队管理

• Workspace 用于管理组织内成员，Owner 与 Admin 可以邀请或移除成员，Member 可查看成员列表。
• 工作区不单独持有 Credits，成员请求共用组织余额；只有 Organization Owner 能充值、设置自动充值或兑换余额码。
• 邀请在 24 小时后失效，移除成员时会删除该成员在工作区创建的 API 密钥记录。
• 团队应为环境和服务分别创建密钥，并配合额度限制、轮换和人员离职流程，不要多人共享同一长期密钥。

完整接入流程

1. 注册并进入控制台，先查看当前模型目录、端点能力和计费单位，选出主模型及能力相近的备用模型。
2. 创建名称清晰的 API 密钥，可按项目设置额度上限；复制后保存在服务端密钥管理系统或环境变量中。
3. 在现有 OpenAI 客户端中替换接口基础地址和密钥，或安装官方 SDK，再填写目录中的准确模型标识。
4. 用短提示进行最小调用，记录响应内容、模型标识、Token 用量、延迟和请求标识，确认请求格式正确。
5. 根据业务补充流式输出、结构化结果、图片或异步媒体流程，不要向不支持的模型发送同一套参数。
6. 为限流和临时错误加入指数退避、随机抖动与并发上限；对无效请求和认证失败停止重试。
7. 在控制台检查余额与用量，依据真实调用记录设置预算、密钥额度和自动充值阈值。
8. 上线前测试主模型、备用模型和必要的厂商直连回退，并建立模型下线、价格变化和异常账单告警。

开发接口与 SDK

官方 Node.js 与 TypeScript SDK 要求服务端使用，并明确提醒不要把长期密钥放入浏览器代码、日志、截图或公开仓库。其当前 0.1.x 支持对话完成、Responses 和模型列表，图像、视频、音频、批处理、微调及实时方法不在这一 SDK 维护面的默认承诺内。

价格与计费方式

CometAPI 采用预付 Credits 的按量计费模式，不收固定月费、最低消费或订阅费。用户充值后按实际 Token、生成资产、片段或时长扣减，账户正常时购买余额不会过期。

不同模型的定价口径

价格页同时显示不同模型的即时单价，模型上线、下线和厂商价格都可能变化。预算应使用同一模型标识的当前输入价、输出价或任务单价估算，并在调用完成后用实际账单校正。

自动充值与失败请求

• 用户可在账户中设置余额低于阈值时通过 Stripe 自动充值，并可随时修改或关闭设置。
• 网关在转发前因参数或认证拒绝的请求不计费，上游返回服务端错误的请求也不计费。
• 流式生成已经返回内容后中断，通常按已生成 Token 计费；成功完成但结果不符合主观预期的请求会全额计费。
• 余额不足或付款失败时，平台可以暂停或限制服务，生产系统不应仅依赖自动充值维持连续性。

退款规则

• 已使用或消耗的 Credits、API 调用和计算时间不退款，余额也不可转让或兑换现金。
• 未使用 Credits 可提交书面申请，但是否批准由 CometAPI 审核决定，并非默认退款权利。
• 申请应包含充值金额、购买日期、当前未用余额和原因；退款政策写明通常在 5 个工作日内回应。
• 获批退款尽可能退回原支付方式，支付机构、银行或中间方不可退的处理费可能被扣除。
• 疑似错误扣费应在扣费日起 30 天内提出争议，超期可能被视为接受该笔费用。

适合用户与场景

• 希望用一套接口比较和切换多家模型的应用开发团队。
• 需要在客服、内容、搜索、编程或代理系统中动态选择成本与能力的产品团队。
• 批量生成图片、短视频、配音或音乐，同时希望统一余额和账单的创意技术团队。
• 需要给成员分配工作区、共享组织余额并集中管理密钥的企业研发部门。
• 需要多模型回退或希望减少单一模型厂商绑定的基础设施团队。

优势与能力边界

• 统一密钥、目录和账单能减少重复接入，但聚合层并不会消除各模型在参数、内容政策、能力和输出质量上的差异。
• 平台支持模型内回退，但错误分类、幂等、队列、超时和最终厂商直连仍需由应用自行设计。
• 限流额度会受账户、模型、路由和上游容量影响；宣传中的高容量不应替代生产压测和合同承诺。
• 公开模型数量和具体型号会持续变化，生产环境必须固定模型标识并监控下线公告。
• 模型输出可能不准确、侵权或不适合业务，使用者仍需进行事实、安全、版权和合规审核。
• 未经书面授权不得转售、再许可或重新分发服务，商业平台如需把 API 能力提供给下游客户，应先确认授权方式。

隐私、安全与合规

• 隐私政策称 CometAPI 不收集、存储或记录提示、输入、输出和对话内容，也不会把这些内容保存到自身数据库。
• 请求仍会实时路由给实际模型提供商以产生结果，因此每个上游提供商的数据处理、保留和内容政策仍需单独审查。
• 平台会收集有限的 IP 地址、时间、请求频率、浏览器、设备和访问记录，用于安全、合规、分析与服务优化。
• 账户注册可能收集用户名和邮箱，使用 GitHub 或 Google 登录时会在用户同意后取得用于认证的用户名和邮箱。
• 平台称不出售、出租或交易个人信息，但在法律或监管要求下可能披露相关信息，并声明采取合理技术和组织措施但无法保证绝对安全。
• 企业关于页将 SOC 2 Type II 列为推进中的路线图事项，不能据此认定平台当前已经取得该认证。

API 密钥安全建议

1. 为开发、测试和生产分别创建密钥，设置合理额度，并只保存在服务端环境变量或密钥管理系统中。
2. 禁止把密钥写入浏览器包、移动客户端、公开代码仓库、日志、截图或支持工单。
3. 日志只保留模型标识、状态、延迟和请求标识等排错字段，不记录密钥或不必要的用户原文。
4. 发现泄露后立即撤销并轮换密钥，核查异常用量、自动充值和成员权限。

开源状态与平台支持

总结

CometAPI 适合需要快速接入多家模型、统一余额并保留模型切换能力的开发团队。它的实际价值取决于目标模型是否稳定可用、接口是否完整兼容，以及团队能否做好成本、密钥、重试和上游政策管理。

开始使用时宜先用试用 Credits 完成最小调用，再以真实业务输入测试质量、延迟和费用。准备生产部署或大额充值前，还应确认模型生命周期、企业服务等级、签约主体、退款条件和上游数据处理要求。