Skip to main content

간단한 답변

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를 찾는 위치

HTTP 헤더 이름은 대소문자를 구분하지 않지만 필드 이름의 구분자는 중요합니다. x-request-id, request-idrequest_id은 서로 다른 표기입니다. 하나의 필드 이름만 검색하지 말고 응답 헤더와 오류 본문을 모두 확인하십시오.

코드에서 확인하기

Python

cURL

-i을 사용하여 응답 헤더와 응답 본문을 모두 출력합니다. 헤더에서 x-request-id 또는 request-id를 확인합니다.
Wan 또는 HappyHorse 동영상 호출의 경우 본문 필드 두 개도 저장합니다.

콘솔 로그 검색

1

호출 로그 열기

APIYI 콘솔에 로그인하고 “로그”를 연 다음, 조사하려는 호출의 세부 정보를 엽니다.
2

사용 가능한 식별자 입력

식별자를 “Request ID / Upstream Request ID / Completion ID” 필터에 붙여 넣습니다. APIYI 응답 헤더의 Request ID를 우선 사용하고, 사용할 수 없는 경우 Upstream Request ID 또는 Completion ID를 시도합니다.
3

세부 정보 비교

모델, 호출 시간, 엔드포인트, 채널, HTTP 상태, 오류 코드 및 과금 기록을 비교하여 요청이 APIYI에 도달했는지, 업스트림 제공업체에 도달했는지, 요청을 변경한 후 재시도해야 하는지를 판단합니다.
사용자가 대략적인 실패 시간만 알고 있더라도 모델, 엔드포인트 및 시간으로 검색 범위를 좁힐 수 있습니다. Request ID를 사용하면 일반적으로 단일 호출을 훨씬 빠르게 식별할 수 있습니다.

Request ID가 없을 수 있는 이유는 무엇인가요?

HTTP 응답을 받기 전에 요청이 실패하는 경우(예: DNS 확인, TCP/TLS 연결 설정, 로컬 프록시 거부 또는 클라이언트 측 연결 시간 초과) APIYI는 응답 헤더를 반환할 기회가 없습니다. 이 경우 클라이언트에서 사용할 수 있는 Request ID가 없습니다. 대신 다음 정보를 제공해 주세요:
  • 원본 클라이언트 예외와 전체 스택 트레이스;
  • 요청 시간과 시간대;
  • 모델과 엔드포인트;
  • HTTP 클라이언트, 프록시 또는 네트워크 환경;
  • 가능한 경우 성공했거나 재시도한 호출의 Request ID.
문제 해결 자료에 전체 API 키를 전송하지 마세요. 키 중간 부분을 마스킹하고, 전체 비즈니스 콘텐츠나 이미지가 포함된 비공개 데이터 또는 요청 본문을 노출하지 마세요.

고객 지원팀에 제공할 정보

  • 요청 ID
  • 로그에 표시되는 경우 업스트림 요청 ID 또는 완료 ID
  • 모델 이름 및 엔드포인트
  • 시간대를 포함한 호출 시간
  • HTTP 상태, 전체 응답 본문 및 클라이언트 예외
  • 마스킹한 요청과 콘솔 로그에 표시된 오류 코드 및 과금 상태

관련 문서

모델 오류를 어떻게 해결합니까?

매개변수, 그룹, 시간 초과 및 모델 오류 해결

호출 로그를 어떻게 확인합니까?

콘솔에서 API 호출, 오류 및 과금 세부 정보 확인

로그 쿼리 API

시간, 모델 또는 request_id로 호출 로그 쿼리

이미지 API 모범 사례

이미지 시간 초과, 연결 끊김, 과금 및 요청 ID 문제 해결