常見問題
我們被問得最多的那些問題——價格、協定報錯、卡住的任務、內容審核、帳戶與限流。
一般問題
Atlas Cloud 是什麼？
Atlas Cloud 是一個 AI API 聚合平台。一把 API 金鑰、一份餘額，就能呼叫來自眾多廠商的 400+ 模型——語言模型、圖像、影片、音訊與 3D，不必逐一去註冊。
該怎麼開始使用？
有哪些模型可用？
請瀏覽模型庫。模型目錄變動頻繁，因此它才是權威清單——文件刻意不寫死那些很快就會過時的模型名稱。
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 金鑰
- 金鑰的權限範圍對嗎？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 金鑰。支出可以依金鑰與成員拆分統計，餘額也可以在個人帳戶與團隊之間轉移。請見團隊帳戶與基於角色的存取控制。
該怎麼刪除帳戶？
請用註冊電子郵件聯繫技術支援，並提供您的帳戶 UUID。請注意：
- 剩餘餘額不予退款——請先用完
- 有一段冷靜期，期間您可以撤回該請求
- 帳戶關閉後，同一個電子郵件無法再次註冊
如果您只是想移除生成的內容、並不想關閉帳戶，可以直接刪除歷史紀錄。請見資料刪除政策。
資料與安全
我的資料是怎麼處理的？
請求透過 TLS 傳輸。Atlas Cloud 僅為提供服務與計費而短暫保留請求內容，各上游廠商也有各自的保留政策。請見資料保留與隱私政策。
我的內容會被拿去訓練模型嗎？
不會。除非您以書面形式授權，否則 Atlas Cloud 不會用透過本平台提交的內容去訓練、微調、評測或跑分其託管的模型。
我可以控制資料保留多久嗎？
可以。媒體生成請求支援以請求為單位設定保存期限標頭，用來縮短生成檔案與請求紀錄的保留時間。請見資料保留。
資料保護權利方面呢？
您可以隨時申請存取、刪除或匯出您的個人資料。請聯繫 [email protected]。哪些會被移除、哪些基於法律與會計原因必須保留，請見資料刪除政策。
取得協助
- 文件——瀏覽側邊欄，或從快速開始著手
- 電子郵件支援——[email protected]
- 社群——Discord
- 業務與大量採購報價——[email protected]
- 隱私相關請求——[email protected]
回報 API 問題時，請附上失敗回應中的 X-Request-ID 標頭，生成任務則附上 prediction ID。請見錯誤與限流。
Last updated on