狀態碼參考
DashScope的API調用將返回狀態碼以標識調用結果。通用狀態碼由DashScope約定，各算法模型還可能在通用狀態碼的基礎上增加自定義的狀態碼和狀態信息。請通過返回結果中的code和status字段定位調用成功或失敗的詳細信息。
下表列出DashScope通用狀態碼信息。各算法模型自定義的狀態碼信息則可在模型詳情頁進行查找。
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. | 關聯的對象不支持該操作（可以根據實際情況修改）。 |
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 | 下載輸入文件失敗，可能是下載超時，失敗或者文件超過限額大小，錯誤信息可以指出更細節內容。 |
415 | BadRequest.UnsupportedFileFormat | Input file format is not supported. | 輸入文件的格式不支持。 |
429 | Throttling | Requests throttling triggered. | 接口調用觸發限流。 |
429 | Throttling.RateQuota | Requests rate limit exceeded, please try again later. | 調用頻次觸發限流，比如每秒鐘請求數。 |
429 | Throttling.AllocationQuota | Allocated quota exceeded, please increase your quota limit. | 一段時間調用量觸發限流，比如每分鐘生成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. | 系統錯誤。 |
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返回碼在某些特定協議之下可能不存在。
返回字段參考
DashScope在訪問失敗的情況下，除HTTP狀態碼外還會返回錯誤的細節信息，一個訪問失敗示例的調用可能有如下所示返回：
{
"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 | 系統對一次API調用賦予的唯一標識。當排查問題的時候，開發者可以將request_id進行反饋以定位某次調用。 |
code | string | 如果請求失敗，code表示錯誤碼。更多信息，請參見狀態碼參考的錯誤代碼部分。 |
message | string | 如果失敗，內容為失敗詳細信息，參考錯誤碼表“錯誤信息”部分，需要注意的是這部分內容可能會隨著具體的情況有所不同，可能會輸出更加有針對性的內容，不一定和上述碼表中的信息完全一致。 |