간단한 답변
502는 일시적입니다 — 사용자 측에서 구성 변경은 필요하지 않습니다:
- 근본 원인은 서비스 컨테이너의 자동 재시작입니다 — 재시작 기간 동안 웹 콘솔에 접속할 수 없고 API는 502를 반환합니다. 이는 동일한 이벤트입니다.
- 복구는 보통 1분 이내에 자동으로 완료됩니다 — 30~60초 기다린 뒤 요청을 다시 보내십시오.
- 실패한 호출은 절대 과금되지 않습니다 — 502가 발생하는 동안 요청은 실제로 서비스에 도달하지 않으므로 과금 기록이 생성되지 않습니다.
- 클라이언트 측에 자동 재시도를 추가하십시오 — 약 30초 후 한 번 재시도하면 전체 재시작 기간을 매끄럽게 넘길 수 있습니다.
무슨 일이 발생하고 있습니까
502 Bad Gateway 는 다음을 의미합니다: 게이트웨이 계층이 요청을 받았지만 백엔드 서비스로 전달할 때 응답을 받지 못했다는 뜻입니다.
APIYI에서는 일시적인 502의 압도적인 대부분이 백엔드 서비스 컨테이너의 자동 재시작으로 인해 발생합니다. 백엔드 프로세스가 잠시 사용할 수 없는 동안에는 다음이 발생합니다.
- 웹 콘솔(대시보드, 충전 페이지 등)이 로드되지 않거나 오류를 표시합니다
- API(
api.apiyi.com및 다른 모든 엔드포인트)이 502를 반환합니다
이런 종류의 502는 코드, Key, 잔액, 또는 네트워크 설정과는 전혀 관련이 없습니다. 처음 보시는 경우라면 클라이언트 측에서 디버깅할 것은 없습니다 — 30~60초 기다렸다가 다시 시도하십시오. 대부분의 경우 서비스는 이미 복구되어 있습니다.
수행해야 할 작업
1
1단계: 30~60초 기다린 다음 요청을 다시 보내십시오
컨테이너 재시작은 보통 1분 이내에 완료됩니다. API 호출을 다시 보내기만 하십시오 — 실패한 호출에는 과금되지 않으므로, 재시도해도 중복 과금이 발생하지 않습니다.
2
2단계: 웹 콘솔이 로드되지 않으면 페이지를 강제 새로고침하십시오
복구 후에도 브라우저에 캐시된 오류 페이지가 계속 표시될 수 있습니다. Ctrl+Shift+R(Windows) 또는 Cmd+Shift+R(Mac)을 사용하여 강제 새로고침한 뒤 정상 인터페이스를 확인하십시오.
3
3단계: 502가 5분 이상 지속되면 지원팀에 문의하십시오
일시적인 재시작은 몇 분 이상 지속되지 않습니다. 502가 5분 이상 지속되면, 이는 일반적인 자동 재시작이 아닙니다 — 이 페이지 하단의 연락 옵션을 통해 문의해 주시고, 발생한 대략적인 시각(시간대 포함, 예:
14:30 (UTC+8))을 함께 알려 주십시오.프로그래밍 방식 호출에 자동 재시도 추가
가용성에 민감한 워크로드라면, 클라이언트 측에서 502 같은 일시적 오류에 대해 자동 재시도를 추가하십시오 — 약 30초 후 한 번 재시도하면 전체 재시작 윈도우를 커버합니다.- Python
- Node.js
- cURL
자주 묻는 질문
502 발생 중 요청에도 과금되나요?
502 발생 중 요청에도 과금되나요?
아니요. 502는 요청이 실제로 백엔드 서비스에 도달하지 않았음을 의미합니다. 모델 사용이 발생하지 않았으므로 과금 기록에 아무것도 표시되지 않습니다.이는 유용한 진단 방법이기도 합니다. 실패한 요청에 호출 로그의 과금 항목이 없다면 서버 측에서 처리되지 않은 것이므로 안전하게 다시 전송할 수 있습니다.
502는 timeout, 429 또는 524와 어떻게 다른가요?
502는 timeout, 429 또는 524와 어떻게 다른가요?
502: 백엔드 서비스를 일시적으로 사용할 수 없습니다(컨테이너 재시작). 30~60초 기다린 후 재시도하십시오. 과금되지 않습니다.- Timeout / 연결 끊김: 클라이언트 timeout이 너무 짧습니다. 서버는 여전히 요청을 실행 중일 수 있으며 정상적으로 과금될 수 있습니다. API Timeout 방지 방법을 참조하십시오.
429: 동시 실행 수 또는 요청 제한에 도달한 경우이며 서비스 가용성과는 관련이 없습니다. API 동시 실행 수 제한을 참조하십시오.524: 약 100초를 초과하는 요청으로 CDN 엔드포인트(api-cf.apiyi.com)를 사용 중입니다. 엔드포인트를 전환하십시오.
웹 콘솔과 API가 동시에 실패하는 이유는 무엇인가요?
웹 콘솔과 API가 동시에 실패하는 이유는 무엇인가요?
웹 콘솔과 API는 동일한 서비스를 기반으로 합니다. 컨테이너 재시작 중에는 둘 다 함께 사용할 수 없게 되고 함께 복구됩니다. 따라서 웹사이트도 다운되었다는 현상은 클라이언트 구성 문제가 아니라 일시적인 플랫폼 측 이벤트임을 정확히 확인해 줍니다.
이 문제가 자주 발생하나요?
이 문제가 자주 발생하나요?
아니요. 정기적으로 발생하는 현상이 아닙니다. 일시적인 502는 일반적으로 갑작스러운 트래픽 급증과 관련되며 산발적으로 발생합니다.2026년 8월 기준으로 백엔드 서버를 업그레이드하고 확장하고 있으며, 이를 통해 이러한 일시적인 502의 발생 빈도가 크게 줄어들 것입니다. 플랫폼 측 장애가 발생할 때마다 실시간 상태 피드에 상태 업데이트와 복구 진행 상황을 즉시 게시합니다.
플랫폼 문제인지 자체 네트워크 문제인지 어떻게 알 수 있나요?
플랫폼 문제인지 자체 네트워크 문제인지 어떻게 알 수 있나요?
빠르게 확인하는 두 가지 방법이 있습니다.다른 네트워크에서도 5분 이상 계속 502가 반환되면 지원팀에 문의하십시오.또한 웹 콘솔은 정상적으로 작동하지만 스크립트에서 빈 본문과 함께 간헐적인 502가 발생하고 해당 요청이 호출 로그에 없다면, 502는 로컬 프록시 소프트웨어에서 발생했을 가능성이 높습니다. 스크립트에서 502가 발생하지만 호출 로그에는 아무것도 없나요?를 참조하십시오.
- 웹 콘솔 열기:
api.apiyi.com에서 502가 반환되고 콘솔도 로드되지 않으면, 거의 확실히 일시적인 플랫폼 측 재시작입니다. 1분 정도 기다리십시오. - 네트워크 전환: 모바일 데이터(다른 통신사)를 사용해 콘솔을 로드하거나 아래 명령을 실행해 보십시오. 해당 환경에서 작동한다면 문제는 로컬 네트워크 또는 프록시에 있습니다.
관련 문서
API 타임아웃을 피하는 방법
타임아웃 설정, reasoning-model 지연 시간, 524 진단
API를 사용하려면 프록시가 필요합니까?
직접 연결 관련 참고사항과 네트워크 요구사항
APIYI의 서버는 어디에 있습니까?
노드 위치, 지연 시간 테스트, 및 구매 조언
서비스 가용성 및 SLA
가용성 약속 및 장애 대응
문의하기
WeCom 지원

이메일
지원: [email protected]비즈니스: [email protected]