常见问题
我们被问得最多的那些问题——价格、协议报错、卡住的任务、内容审核、账户和限流。
综合
Atlas Cloud 是什么？
Atlas Cloud 是一个 AI API 聚合平台。一个 API Key、一份余额，就能调用来自众多厂商的 400+ 模型——语言模型、图像、视频、音频和 3D，不必逐家去注册。
怎么开始使用？
- 注册账户
- 创建 API Key
- 按照快速开始发出第一个请求
有哪些模型可用？
请浏览模型库。模型目录变动频繁，因此它才是权威列表——文档刻意不写死那些很快就会过时的模型名。
API 兼容 OpenAI 吗？
兼容，而且不止于此。Atlas Cloud 接受六种请求格式：OpenAI Chat Completions、Completions、Responses 和 Images，以及 Anthropic Messages 和 Google Gemini。参见 LLM API 协议。
API 与技术
我调用某个模型时收到 400，为什么？
最常见的原因是给该模型用错了协议。并不是每个模型都接受每种格式：
- Anthropic 系模型要用
POST /v1/messages，不是/v1/chat/completions - 部分 OpenAI 推理系和 codex 系模型要用
POST /v1/responses，不是/v1/chat/completions
每个模型都会公布自己支持的协议。切换格式前请先查看该模型的 API 参考，各协议之间的差异见 LLM API 协议。
API 端点有哪些？
| 用途 | 端点 |
|---|---|
| LLM 对话 | POST /v1/chat/completions |
| LLM（Anthropic 格式） | POST /v1/messages |
| LLM（Responses 格式） | POST /v1/responses |
| 图像与 3D 生成 | POST /api/v1/model/generateImage |
| 视频生成 | POST /api/v1/model/generateVideo |
| 音频：语音、音乐、转写 | POST /api/v1/model/generateAudio |
| 查询任务状态 | GET /api/v1/model/prediction/{id} |
| 上传文件 | POST /api/v1/model/uploadMedia |
| 余额与用量 | GET /public/v1/balance |
Base URL：https://api.atlascloud.ai
我的任务一直是 processing，能取消吗？
图像、视频、音频和 3D 生成都是异步的。提交任务后，轮询 GET /api/v1/model/prediction/{id} 直到它进入终态。视频任务尤其可能要跑上几分钟。
平台没有取消接口。超过平台超时时间的任务会被终止并自动退款。
如果你在高频轮询，建议改用 Webhook——任务结束时会回调通知你，不必一直开着轮询循环。
支持 Webhook 吗？
支持，适用于图像、视频和音频任务。回调的数据格式和签名校验方式见 Webhook。
怎么上传文件？
使用 POST /api/v1/model/uploadMedia，再把返回的 URL 传入生成请求。你也可以直接给一个公网可访问的 URL，大多数图像和音频字段还支持内联 Base64。参见上传文件。
有限流吗？
有，按账户和模型分别生效。超出限制会返回 429。
请注意，LLM 和媒体端点不会返回任何限流响应头，因此你无法从响应里读出剩余配额——请自行实现指数退避。参见错误与限流。
需要更高的限额？请联系我们并说明预期的请求量。
我收到 401 错误，该怎么排查？
按这个顺序检查：
- 密钥是否正确、是否仍然有效？请查看 API Key
- 密钥的权限范围对不对？Coding Plan 密钥无法调用不接受该类密钥的模型
- 在团队场景下，你用的密钥是否创建于正确的账户？
- **URL 路径写对了吗？**网关先鉴权再路由，因此路径打错同样会返回
401而不是404
MCP Server 是什么？
这是官方的 MCP Server，把 Atlas Cloud 以工具的形式接入 AI 辅助 IDE——不用离开编辑器就能生成媒体、与模型对话、查询余额。
价格与计费
模型卡片上的价格就是总价吗？
**不是——对图像和视频模型而言，那是单位价格。**最终花费取决于时长、分辨率、输出数量等参数。一个按秒计价的视频模型，实际花费是该单价乘以片段长度。
想在花钱之前拿到准确数字，请在提交前先做价格预估。可参考模型如何计费里的实例。
为什么我看到的价格和账单对不上？
有三个地方可能不一样：
- 模型卡片显示的是标价单价
- Playground 会随参数变化实时重算
- 你的账单还会体现账户折扣和促销
图像和视频采用异步计费：提交时先冻结一笔金额，任务完成后按实际用量结算。冻结中的金额不是最终扣款。
失败的请求会扣费吗？
不会。失败、超时或被内容审核拒绝的任务都不计费。如果你看到一笔无法解释的扣费，请带上 prediction ID 联系技术支持。
余额会变成负数吗？
在高并发的 LLM 调用下，余额可能会略微为负，因为语言模型调用不做预授权。余额为负会阻止后续请求。开启自动充值可以避免服务中断。
Coding Plan 额度能用于图像或视频吗？
**不能。**Coding Plan 是面向语言模型用量的独立订阅额度，不能用于图像、视频或音频生成，这些消耗的是你的常规余额。Coding Plan 额度也无法转成账户余额。
怎么开发票？
在控制台的账单历史里申请或重新开具。下载链接有时效，生成后请及时保存 PDF。
支持哪些支付方式？
信用卡和借记卡（通过 Stripe）、微信支付、支付宝以及加密货币。支付以美元结算。
有注册赠送或推荐奖励吗？
Atlas Cloud 会不定期推出充值促销——当前有哪些活动请查看账单页面。此外还有推荐计划：分享你的链接，被推荐人完成首次充值后你即可获得额度。参见余额与额度。
额度会过期吗？
预付额度自购买之日起有一段固定的有效期，促销额度可能另有条款。参见余额与额度和可接受使用政策。
内容与审核
我的视频生成失败了，提示版权或音频敏感，该怎么办？
这通常出在音轨上，而不是画面。可选的做法：
- 如果不需要声音，就关掉音频生成——很多视频模型支持类似
generate_audio: false的开关 - 自带免版权音频作为配乐
- 改写提示词，让它生成原创音乐，而不要点名某首现有曲目或某位艺人
被审核拦截的请求不计费。
我的生成被内容审核拦截了，为什么？
描述真实人物、未成年人或其他受限内容的提示词会被拒绝。部分模型支持基于你上传素材的参考生成，这是处理人物形象类需求的合规路径。参见可接受使用政策。
我原来用的模型不见了，发生了什么？
当上游厂商下线模型或模型稳定性下降时，我们偶尔会将其下架。模型库始终反映当前可用的模型。如果你依赖的模型没了，请联系技术支持，我们可以帮你推荐替代方案。
账户与团队
我用 GitHub 登录，但充不了值。
GitHub 不一定会返回邮箱地址，而计费需要邮箱。请先在账户设置里补上邮箱，然后正常充值即可。
我登录后余额不见了。
你可能创建了第二个账户。用 Google、GitHub 和邮箱登录会产生各自独立的账户，即便邮箱地址相同，除非它们已被关联。请用你最初注册时的方式登录。如果确实存在重复账户，请联系技术支持。
团队功能能做什么？
团队账户共享同一份余额，支持多名成员并按角色划分权限，还可以创建团队范围的 API Key。支出可以按密钥和按成员拆分统计，余额也可以在个人账户和团队之间划转。参见团队账户和基于角色的访问控制。
怎么注销账户？
请用注册邮箱联系技术支持，并提供你的账户 UUID。请注意：
- 剩余余额不予退款——请先用完
- 有一段冷静期，期间你可以撤回该请求
- 账户关闭后，同一邮箱无法再次注册
如果你只是想删除生成的内容、并不想关闭账户，可以直接删除历史记录。参见数据删除政策。
数据与安全
我的数据是怎么处理的？
请求通过 TLS 传输。Atlas Cloud 仅为提供服务和计费而短暂保留请求内容，各上游厂商也有各自的保留策略。参见数据保留和隐私政策。
我的内容会被用来训练模型吗？
不会。除非你以书面形式授权，否则 Atlas Cloud 不会用通过本平台提交的内容去训练、微调、评估或跑分它托管的模型。
我能控制数据保留多久吗？
可以。媒体生成请求支持按请求设置留存策略请求头，用来缩短生成文件和请求记录的保留时长。参见数据保留。
数据保护权利方面呢？
你可以随时申请访问、删除或导出你的个人数据。请联系 [email protected]。哪些会被删除、哪些出于法律和财务原因必须保留，参见数据删除政策。
获取帮助
- 文档——浏览左侧侧边栏，或从快速开始入手
- 邮件支持——[email protected]
- 社区——Discord
- 销售与批量报价——[email protected]
- 隐私相关请求——[email protected]
反馈 API 问题时，请附上失败响应里的 X-Request-ID 响应头，生成任务则附上 prediction ID。参见错误与限流。
Last updated on