Skip to main content

​
驗證方式

所有公開介面預設使用 Bearer Token：
基礎位址：
部分原生格式或模型專用介面雖然路徑不同，但仍沿用同一套 API Key 驗證方式。

​
錯誤結構

排查失敗請求時，優先關注：
  • HTTP 狀態碼
  • error.code
  • error.message
典型結構：

​
常見狀態碼

​
常用狀態列舉

常見角色列舉：
  • system
  • user
  • assistant
常見長任務狀態：
  • queued
  • running
  • succeeded
  • failed
  • in_progress
  • completed
不同影片介面回傳的狀態欄位可能略有差異，但語義皆圍繞「排隊中 / 執行中 / 已完成 / 失敗」。

​
非同步任務查詢

目前公開文件以「主動查詢任務結果」為主，常見方式包括：
  • GET /v1/videos/{task_id}
  • GET /v1/responses/{response_id}
  • GET /api/v3/contents/generations/tasks/{task_id}
  • GET /suno/fetch/{task_id}
  • GET /ent/v2/tasks/{task_id}/creations
  • GET /v1beta/{operation_name}
串接端建議：
  • 對任務查詢進行重試與退避 (Exponential Backoff)
  • 持久化儲存 task_id 或 operation_name
  • 結果查詢作為非同步任務回傳檢查的保底機制