간단한 답변
API 호출을 문제 해결할 때는 먼저 모델 이름, 엔드포인트 및 호출 시간을 기록합니다. 그런 다음 HTTP 응답 헤더에서x-request-id 또는 request-id을 확인합니다. 엔드포인트에서 오류 응답을 반환하는 경우에는 JSON 본문에서 request_id와 같은 식별자도 확인하고, APIYI 로그에서 찾을 수 있는 필드를 사용합니다.
Wan 및 HappyHorse 동영상 엔드포인트는 응답 본문에 request_id도 반환합니다. 동일한 응답의 task_id은 동영상 작업을 조회하는 데 사용되며 Request ID와는 다릅니다. Seedance 및 Veo와 같은 비동기 엔드포인트에서 반환되는 id 또는 task_id도 동영상 작업 ID입니다.
APIYI 로그 페이지에서는 “요청 ID / 업스트림 요청 ID / 완료 ID” 필터에 표시되는 식별자를 검색할 수 있습니다. 콘솔에서 로그 세부 정보를 열고 사용자가 제공한 식별자로 검색합니다.
다음 세 단계로 시작합니다
1
1단계: 모델과 엔드포인트를 확인합니다
전체 모델 이름과 실제 URL을 기록합니다. 텍스트 모델은 일반적으로
/v1/chat/completions을 사용하고, 임베딩 모델은 /v1/embeddings를 사용하며, 이미지 모델은 /v1/images/generations을 사용할 수 있고, 동영상 모델은 /v1/videos 또는 모델별 비동기 엔드포인트를 사용할 수 있습니다.2
2단계: 호출 시간을 기록합니다
요청을 보낸 시간을 기록하고 시간대를 포함합니다. 예: 2026-08-25 14:32 (UTC+8). 요청을 재시도한 경우 각 재시도의 대략적인 시간을 기록합니다.
3
3단계: 응답과 로그 세부 정보를 저장합니다
HTTP 상태 코드, 전체 응답 헤더, 전체 응답 본문 및 클라이언트 예외를 저장합니다. 그런 다음 APIYI “로그” 페이지를 열고 요청 ID, 업스트림 요청 ID 또는 완료 ID로 검색합니다.
API 유형별 요청 ID를 찾는 위치
코드에서 확인하기
Python
cURL
-i을 사용하여 응답 헤더와 응답 본문을 모두 출력합니다. 헤더에서 x-request-id 또는 request-id를 확인합니다.
콘솔 로그 검색
1
호출 로그 열기
APIYI 콘솔에 로그인하고 “로그”를 연 다음, 조사하려는 호출의 세부 정보를 엽니다.
2
사용 가능한 식별자 입력
식별자를 “Request ID / Upstream Request ID / Completion ID” 필터에 붙여 넣습니다. APIYI 응답 헤더의 Request ID를 우선 사용하고, 사용할 수 없는 경우 Upstream Request ID 또는 Completion ID를 시도합니다.
3
세부 정보 비교
모델, 호출 시간, 엔드포인트, 채널, HTTP 상태, 오류 코드 및 과금 기록을 비교하여 요청이 APIYI에 도달했는지, 업스트림 제공업체에 도달했는지, 요청을 변경한 후 재시도해야 하는지를 판단합니다.
Request ID가 없을 수 있는 이유는 무엇인가요?
HTTP 응답을 받기 전에 요청이 실패하는 경우(예: DNS 확인, TCP/TLS 연결 설정, 로컬 프록시 거부 또는 클라이언트 측 연결 시간 초과) APIYI는 응답 헤더를 반환할 기회가 없습니다. 이 경우 클라이언트에서 사용할 수 있는 Request ID가 없습니다. 대신 다음 정보를 제공해 주세요:- 원본 클라이언트 예외와 전체 스택 트레이스;
- 요청 시간과 시간대;
- 모델과 엔드포인트;
- HTTP 클라이언트, 프록시 또는 네트워크 환경;
- 가능한 경우 성공했거나 재시도한 호출의 Request ID.
고객 지원팀에 제공할 정보
- 요청 ID
- 로그에 표시되는 경우 업스트림 요청 ID 또는 완료 ID
- 모델 이름 및 엔드포인트
- 시간대를 포함한 호출 시간
- HTTP 상태, 전체 응답 본문 및 클라이언트 예외
- 마스킹한 요청과 콘솔 로그에 표시된 오류 코드 및 과금 상태
관련 문서
모델 오류를 어떻게 해결합니까?
매개변수, 그룹, 시간 초과 및 모델 오류 해결
호출 로그를 어떻게 확인합니까?
콘솔에서 API 호출, 오류 및 과금 세부 정보 확인
로그 쿼리 API
시간, 모델 또는 request_id로 호출 로그 쿼리
이미지 API 모범 사례
이미지 시간 초과, 연결 끊김, 과금 및 요청 ID 문제 해결