本文主要介紹在開發過程中接入阿里雲百鍊,出現的錯誤碼以及對應的錯誤原因。
錯誤碼列表
阿里雲百鍊模型服務的API調用將返回狀態代碼以標識調用結果。通用狀態代碼由阿里雲百鍊約定,各演算法模型還可能在通用狀態代碼的基礎上增加自訂的狀態代碼和狀態資訊。請通過返回結果中的code
和status
欄位定位調用成功或失敗的詳細資料。
HTTP 返回碼 | 錯誤碼 Code | 錯誤資訊 Message (具體資訊內容可能跟隨情境有所變化) | 含義說明 |
400 | InvalidParameter | Required parameter(s) missing or invalid, please check the request parameters. | 介面調用參數不合法。 |
400 | InvalidParameter | Either \"prompt\" or \"messages\" must exist and cannot both be none | prompt和messages欄位不能都為空白。 原因可能是格式錯誤,例如通過HTTP調用DashScope服務(非OpenAI相容方式)時,messages需放入input對象中,而不是與model參數並列。
|
400 | InvalidParameter | 'messages' must contain the word 'json' in some form, to use 'response_format' of type 'json_object'. | 在開啟JSON結構化輸出功能時,未在System Message或User Message指引模型以JSON格式輸出,如:“請以json格式輸出。”。 |
400 | InvalidParameter | File [id:file-fe-***********] format is not supported. | Qwen-Long模型僅限於處理純文字格式檔案,包括TXT、DOCX、PDF、EPUB、MOBI及MD檔案類型。目前不支援圖片或掃描文檔(因其本質上是圖片形式,無法直接提取常值內容)的上傳。如需對圖片內容進行文本提取、分析和總結,您可以使用通義千問VL模型。 |
400 | DataInspectionFailed data_inspection_failed | Input or output data may contain inappropriate content. Input data may contain inappropriate content. Output data may contain inappropriate content. | 資料檢查錯誤,輸入或者輸出包含疑似敏感內容被綠網攔截。 |
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, please make sure your account is in good standing. | 可能原因一:阿里雲帳號因為欠費而被拒絕訪問。請前往費用與成本頁面查看是否欠費或儲值。 可能原因二:調用Batch介面返回該報錯,是因為未開通百鍊服務。請前往百鍊控制台的模型廣場,免費開通百鍊服務,然後用百鍊的API KEY進行調用。 |
400 | UnsupportedOperation | The operation is unsupported on the referee object. | 關聯的對象不支援該操作(可以根據實際情況修改)。 |
400 | FlowNotPublished | Flow has not published yet, please publish flow and try again. | 流程未發布,請發布流程後再重試。 |
400 | InvalidSchema | Database schema is invalid for text2sql. | 請輸入資料庫Schema資訊。 |
400 | InvalidSchemaFormat | Database schema format is invalid for text2sql. | 輸入資料表資訊格式異常。 |
400 | FaqRuleBlocked | Input or output data is blocked by faq rule. | 命中FAQ規則幹預模組。 |
400 | CustomRoleBlocked | Input or output data may contain inappropriate content with custom rule. | 請求或響應內容沒有通過自訂策略。 |
400 | InternalError.Algo | Missing Content-Length of multimodal url. | URL請求的回應標頭資訊缺失 |
401 | InvalidApiKey invalid_api_key | Invalid API-key provided. Incorrect API key provided. | 請求中的 ApiKey 錯誤。 |
403 | AccessDenied access_denied | Access denied. | 無權訪問此 API,比如不在邀測中。請前往百鍊控制台,在模型廣場的對應模型卡片下方單擊立即申請發起測試申請。 |
403 | Workspace.AccessDenied | Workspace access denied. | 無許可權訪問業務空間的應用或者模型。
|
403 | Model.AccessDenied | Model access denied. | 子帳號無許可權訪問業務空間的模型。請確認以下步驟:
具體詳情請參考文檔子業務空間的模型調用的前提條件。 |
403 | AccessDenied.Unpurchased | Access to model denied. Please make sure you are eligible for using the model. | 您可能還未開通百鍊服務:您需要註冊或登入阿里雲帳號,然後前往模型廣場開通模型服務。 |
404 | WorkSpaceNotFound | WorkSpace can not be found. | 使用者空間資訊不存在。 |
404 | ModelNotFound model_not_found | Model can not be found. The model xx does not exist. | 當前訪問的模型不存在。 |
404 | ModelNotFound model_not_found | The model xx does not exist or you do not have access to it. | 您還未開通百鍊服務,您需要前往模型廣場開通模型服務。 |
408 | RequestTimeOut |
|
|
413 | BadRequest.TooLarge | Payload Too Large. | 接入層網關返回請求體過大錯誤,如果錯誤是由MSE網關層直接攔截,則沒有 code,並且 message 不能自訂。如果是RESTful網關攔截,則返回code。 |
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 | LimitRequests limit_requests | You exceeded your current requests list | 超出調用限制,您需等到不滿足限流條件時才能再次調用,部分模型支援申請提高限額。 |
429 | Throttling.AllocationQuota | Free allocated quota exceeded. | 免費額度已經到期或者耗盡,並且該模型未支援計費訪問。 |
429 | PrepaidBillOverdue | The prepaid bill is overdue. | 業務空間預付費賬單到期。 |
429 | PostpaidBillOverdue | The postpaid bill is overdue. | 模型推理商品已失效。 |
429 | CommodityNotPurchased | Commodity has not purchased yet. | 業務空間未訂購。 |
500 | InternalError internal_error | 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 system_error | 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 小時,如果在這期間始終沒有結果,則逾時。 |
500 | RewriteFailed | Failed to rewrite content for prompt. | 調用改寫prompt的大模型失敗。 |
500 | RetrivalFailed | Failed to retrieve data from documents. | 文檔檢索失敗。 |
500 | AppProcessFailed | Failed to proceed application request. | 應用流程處理失敗。 |
500 | ModelServiceFailed | Failed to request model service. | 模型服務調用失敗。 |
500 | InvokePluginFailed | Failed to invoke plugin. | 外掛程式調用失敗。 |
503 | ModelUnavailable | Model is unavailable, please try again later. | 模型暫時無法提供服務。 |
NetworkError network_error | Can not find api-key. | 環境變數配置沒有生效,您可以重啟用戶端或IDE後重試。更多情況請參考常見問題。 |
返回欄位參考
阿里雲百鍊模型服務在訪問失敗的情況下,除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 | 如果失敗表示錯誤碼,參考錯誤碼錶“錯誤碼”部分。 |
message | string | 如果失敗,內容為失敗詳細資料,參考錯誤碼錶“錯誤資訊”部分,需要注意的是這部分內容可能會隨著具體的情況有所不同,可能會輸出更加有針對性的內容,不一定和上述碼錶中的資訊完全一致。 |