全部產品
Search
文件中心

Alibaba Cloud Model Studio:錯誤碼

更新時間:Dec 17, 2024

本文主要介紹在開發過程中接入阿里雲百鍊,出現的錯誤碼以及對應的錯誤原因。

錯誤碼列表

阿里雲百鍊模型服務的API調用將返回狀態代碼以標識調用結果。通用狀態代碼由阿里雲百鍊約定,各演算法模型還可能在通用狀態代碼的基礎上增加自訂的狀態代碼和狀態資訊。請通過返回結果中的codestatus欄位定位調用成功或失敗的詳細資料。

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參數並列。

{
    "model": "指定模型",
    "input": {
        "messages": [
            {"role": "user", "content": "你是誰"},
        ]
    },
    "parameters": {
        "result_format": "message"
    }
}

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請求的回應標頭資訊缺失Content-Length欄位。如果問題無法解決,請嘗試使用其他圖片連結。

查看Content-Length欄位

  1. 開啟瀏覽器(如Chrome或Firefox)。

  2. 開啟開發人員工具(通常按F12或右鍵選擇“檢查”)。

  3. 切換到Network標籤。

  4. 將圖片的URL輸入到地址欄並訪問。

  5. 找到對應的請求,查看Headers部分,在“回應標頭”(Response Headers)部分中尋找Content-Length欄位

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.

無許可權訪問業務空間的應用或者模型。

  • 如果調用子業務空間的模型,請參考子業務空間的模型調用

  • 您也可以改為使用主帳號的API KEY,主帳號具有所有業務空間的許可權。

403

Model.AccessDenied

Model access denied.

子帳號無許可權訪問業務空間的模型。請確認以下步驟:

  1. 調用時,是否傳入了業務空間標識(目前子帳號無法訪問預設業務空間的應用或模型)。

  2. 是否已對子帳號訪問的業務空間做了授權。

  3. 是否對訪問的業務空間做了模型的訪問授權。

具體詳情請參考文檔子業務空間的模型調用的前提條件。

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

  • Request timed out, please try again later.

  • Response timeout!

  • 請求逾時,您可嘗試再次發起請求。

  • 可能是因為輸出內容很長導致逾時,您可嘗試採用流式輸出方式發起請求。

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

如果失敗,內容為失敗詳細資料,參考錯誤碼錶“錯誤資訊”部分,需要注意的是這部分內容可能會隨著具體的情況有所不同,可能會輸出更加有針對性的內容,不一定和上述碼錶中的資訊完全一致。