星算API錯誤排查
下載 Markdown ↓先核對位址、驗證、模型與餘額，再判斷上游狀態。
HTTP 狀態#
| 狀態 | 優先檢查 |
|---|---|
400 |
JSON、必要欄位、參數範圍及素材 |
401 |
金鑰有效性及 Bearer 標頭 |
403 |
權限、IP、模型及群組 |
404 |
端點、模型/任務 ID、歸屬及 /v1/v1 |
429 |
頻率、併發、token 或上游限流 |
5xx |
平台/上游可用性、渠道及逾時 |
餘額不足可能使用不同狀態或業務碼，請看回應體。SSE 開始後仍可能報錯，初始 200 不是完整成功證據。
模型無法呼叫#
檢查金鑰群組、模型限制、有效期及額度；使用完整 API ID，不要用顯示別名。
遲遲沒有輸出#
檢查串流與代理緩衝。長上下文及推理可能延後首字；合理設定逾時、保留請求 ID，避免無限重試。
素材讀取失敗#
檢查公網存取、有效期、權限及大小。已登入瀏覽器能開啟，不保證上游能下載；分享頁不一定是原始檔。
影片未立即回傳#
依影片任務使用原任務 ID 查詢，不要重新生成來刷新進度。
提供客服的資訊#
- 時間、時區及請求、訂單或任務 ID。
- 模型、端點、HTTP 狀態及錯誤碼。
- 脫敏參數與截圖。
勿提供密碼、驗證碼、完整金鑰、雲端密鑰或仍有效的私有素材簽名 URL。