通用約定
錯誤響應
常見 HTTP 狀態碼、OpenAI 兼容錯誤結構和異步任務錯誤結構。
TENSORAXIS 會盡量返回與當前接口格式一致的錯誤結構。OpenAI 兼容接口通常返回 error 對象；異步 task 接口通常返回 code、message 和 data。
OpenAI 兼容錯誤
{
"error": {
"message": "invalid request",
"type": "invalid_request_error",
"param": "",
"code": "invalid_request"
}
}字段說明：
| 字段 | 說明 |
|---|---|
error.message | 人類可讀的錯誤說明 |
error.type | 錯誤類型，可能來自 TENSORAXIS 或上游 |
error.param | 相關請求參數，沒有時可能為空 |
error.code | 穩定性高於 message 的錯誤碼 |
異步 task 錯誤
視頻、音樂、繪圖等異步 task 接口可能返回：
{
"code": "invalid_request",
"message": "prompt is required",
"data": null
}視頻接口最常見的參數錯誤是缺少 prompt。例如把火山官方的頂層 content[] 請求體直接發給 /v1/video/generations 時，本站入口無法讀取 prompt，會返回 400 prompt is required。
常見 HTTP 狀態碼
| 狀態碼 | 含義 | 常見處理方式 |
|---|---|---|
400 | 請求體、參數或模型格式錯誤 | 檢查 JSON、必填字段和模型名 |
401 | 鑑權失敗 | 檢查令牌是否存在、是否帶了正確請求頭 |
403 | 權限或額度不足 | 檢查令牌授權、用戶額度和分組權限 |
404 | 資源不存在 | 檢查模型名、任務 ID 或路徑 |
429 | 觸發限流 | 降低併發，稍後重試，或調整令牌/分組限流 |
5xx | 服務端或上游錯誤 | 稍後重試；持續失敗時聯繫支持 |
自動化調用時優先根據 HTTP 狀態碼和 code 分支處理，不要依賴 message 的完整文本；message 可能因上游、語言或部署配置不同而變化。