狀態(tài)碼參考
DashScope的API調用將返回狀態(tài)碼以標識調用結果。通用狀態(tài)碼由DashScope約定，各算法模型還可能在通用狀態(tài)碼的基礎上增加自定義的狀態(tài)碼和狀態(tài)信息。請通過返回結果中的code和status字段定位調用成功或失敗的詳細信息。
下表列出DashScope通用狀態(tài)碼信息。各算法模型自定義的狀態(tài)碼信息則可在模型詳情頁進行查找。
HTTP返回碼 | 錯誤代碼 Code | 錯誤信息 Message （具體信息內容可能跟隨場景有所變化） | 含義說明 |
400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters. | 接口調用參數不合法。 |
400 | DataInspectionFailed | Input or output data may contain inappropriate content. | 數據檢查錯誤，輸入或者輸出包含疑似敏感內容被綠網攔截。 |
400 | InvalidParameter.DataInspection | The media format is not supported or incorrect for the data inspection. | 數據檢查錯誤，媒體格式不支持或不正確（可能根據不同錯誤信息Message有不同含義）。 |
400 | BadRequest.EmptyInput | Required input parameter missing from request. | 請求的輸入不能為空。 |
400 | BadRequest.EmptyParameters | Required parameter "parameters" missing from request. | 請求的參數不能為空。 |
400 | BadRequest.EmptyModel | Required parameter "model" missing from request. | 請求輸入的模型不能為空。 |
400 | InvalidURL | Invalid URL provided in your request. | 請求的 URL 錯誤。 |
400 | Arrearage | Access denied, plesase make sure your account is in good standing. | 客戶賬戶因為欠費而被拒絕訪問。 |
400 | UnsupportedOperation | The operation is unsupported on the referee object. | 關聯(lián)的對象不支持該操作（可以根據實際情況修改）。 |
401 | InvalidApiKey | Invalid API-key provided. | 請求中的 ApiKey 錯誤。 |
403 | AccessDenied | Access denied. | 無權訪問此 API，比如不在邀測中，您調用的模型屬于邀測中的模型，需要參考調用模型的文檔申請訪問權限。 |
403 | AccessDenied.Unpurchased | Access to model denied. Please make sure you are eligible for using the model. | 客戶沒有開通此商品。 |
408 | RequestTimeOut | Request timed out, please try again later. | 請求超時。 |
413 | BadRequest.TooLarge | Payload Too Large | 接入層網關返回請求體過大錯誤。特別針對qwen-long等支持超長上下文的模型，建議超過1M Tokens的上下文內容通過文件方式提交，否則請求內容放在API請求結構體中可能會導致請求報文超過接口允許的長度限制，導致此錯誤。 |
415 | BadRequest.InputDownloadFailed | Failed to download the input file: xxx | 下載輸入文件失敗，可能是下載超時，失敗或者文件超過限額大小，錯誤信息可以指出更細節(jié)內容。 |
415 | BadRequest.UnsupportedFileFormat | Input file format is not supported. | 輸入文件的格式不支持。 |
429 | Throttling | Requests throttling triggered. | 接口調用觸發(fā)限流。 |
429 | Throttling.RateQuota | Requests rate limit exceeded, please try again later. | 調用頻次觸發(fā)限流，比如每秒鐘請求數。 |
429 | Throttling.AllocationQuota | Allocated quota exceeded, please increase your quota limit. | 一段時間調用量觸發(fā)限流，比如每分鐘生成Token數。 |
429 | Throttling.AllocationQuota | Free allocated quota exceeded. | 免費額度已經耗盡，并且模型未開通計費訪問。 |
500 | InternalError | An internal error has occured, please try again later or contact service support. | 內部錯誤。 |
500 | InternalError.Algo | An internal error has occured during execution, please try again later or contact service support. | 內部算法錯誤。 |
500 | SystemError | An system error has occured, please try again later. | 系統(tǒng)錯誤。 |
500 | InternalError.Timeout | An internal timeout error has occured during execution, please try again later or contact service support. | 異步任務從網關提交給算法服務層之后等待時間3小時，如果3小時始終沒有結果，則超時。 |
500 | InternalError.DataInspection | An internal error has occurred during the data inspection process, please try again later. | 數據檢查內部錯誤。 |
HTTP返回碼在某些特定協(xié)議之下可能不存在。
返回字段參考
DashScope在訪問失敗的情況下，除HTTP狀態(tài)碼外還會返回錯誤的細節(jié)信息，一個訪問失敗示例的調用可能有如下所示返回：
{
"request_id": "54dc32fd-968b-4aed-b6a8-ae63d6fda4d5",
"code": "InvalidApiKey",
"message": "The API key in your request is invalid."
}返回參數說明如下：
返回參數 | 類型 | 說明 |
HTTP請求返回碼 | integer | 200（HTTPStatus.OK）表示請求成功，否則表示請求失敗，可以通過code獲取錯誤碼，通過message字段獲取錯誤詳細信息。 |
request_id | string | 系統(tǒng)對一次API調用賦予的唯一標識。當排查問題的時候，開發(fā)者可以將request_id進行反饋以定位某次調用。 |
code | string | 如果請求失敗，code表示錯誤碼。更多信息，請參見狀態(tài)碼參考的錯誤代碼部分。 |
message | string | 如果失敗，內容為失敗詳細信息，參考錯誤碼表“錯誤信息”部分，需要注意的是這部分內容可能會隨著具體的情況有所不同，可能會輸出更加有針對性的內容，不一定和上述碼表中的信息完全一致。 |