簡短回答
排查介面問題時,先記錄模型名稱、介面端點和呼叫時間,再檢視 HTTP 響應頭中的x-request-id 或 request-id。如果介面返回錯誤響應,還要同時檢查 JSON 響應體中的 request_id 等標識,並以 API易 日誌中可以檢索到的欄位為準。
Wan 和 HappyHorse 影片介面還會在響應體中返回 request_id;響應體中的 task_id 用於查詢影片任務,不等同於 Request ID。Seedance、Veo 等非同步影片介面返回的 id 或 task_id 同樣是影片任務 ID。
API易後臺日誌中的「請求 ID / 上游請求 ID / Completion ID」篩選框可以搜尋使用者提供的標識。開啟控制台的「日誌」頁面後,可以按這個標識定位日誌詳情。
排查前先做三個動作
1
第一步:確認模型和介面端點
記錄完整模型名稱和實際呼叫地址。例如,文本模型通常呼叫
/v1/chat/completions,向量模型呼叫 /v1/embeddings,圖片模型可能呼叫 /v1/images/generations,影片模型則可能使用 /v1/videos 或模型專用的非同步端點。2
第二步:記錄呼叫時間
記錄請求發起時間,並註明時區,例如
2026-08-25 14:32 (UTC+8)。如果發生過重試,也請記錄每次重試的大致時間。3
第三步:儲存響應和日誌資訊
儲存 HTTP 狀態碼、完整響應頭、完整響應體和客戶端異常。然後進入 API易控制台的「日誌」頁面,使用 Request ID、上游 Request ID 或 Completion ID 搜尋對應記錄。
不同模型的 Request ID 在哪裡
如何從程式碼中讀取
Python
cURL
使用-i 同時輸出響應頭和響應體,再從響應頭中查詢 x-request-id 或 request-id:
在控制台日誌中搜索
1
開啟呼叫日誌
登入 API易控制台,進入「日誌」頁面,開啟需要排查的日誌詳情。
2
填寫可用的標識
在篩選框「請求 ID / 上游請求 ID / Completion ID」中貼上使用者提供的標識。優先貼上 API易響應頭中的 Request ID;如果沒有,再嘗試上游 Request ID 或 Completion ID。
3
核對詳情
對照日誌中的模型、呼叫時間、介面路徑、渠道、HTTP 狀態碼、錯誤碼和計費記錄,判斷請求是否到達 API易、是否進入上游,以及是否需要修改請求後重試。
為什麼有時找不到 Request ID
如果請求在收到 HTTP 響應之前就失敗,例如 DNS 解析失敗、無法建立 TCP/TLS 連線、本地代理拒絕連線或客戶端連線超時,API易還沒有機會返回響應頭,因此不會產生可供客戶端讀取的 Request ID。 這類情況請提供:- 客戶端原始異常和完整堆疊;
- 請求發起時間和時區;
- 使用的模型和介面端點;
- HTTP 客戶端、代理或網路環境;
- 如果同一請求曾成功或重試成功,也請提供對應的 Request ID。
聯絡客服時請提供什麼
- Request ID;
- 上游 Request ID 或 Completion ID(如果日誌中有);
- 模型名稱和介面端點;
- 呼叫時間(註明時區);
- HTTP 狀態碼、完整響應體和客戶端異常;
- 脫敏後的請求引數,以及控制台日誌中的錯誤碼和計費狀態。
相關文件
模型呼叫報錯怎麼排查?
按錯誤型別、引數、分組、超時和日誌記錄排查介面問題
如何檢視我的呼叫記錄?
在控制台檢視呼叫記錄、錯誤資訊和計費詳情
日誌查詢 API
按時間、模型或 request_id 程式化查詢呼叫日誌
圖片介面呼叫須知
瞭解圖片請求超時、斷連、計費和請求 ID 的排查方法