간단한 답변
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는 타임아웃, 429 또는 524와 어떻게 다릅니까?
502는 타임아웃, 429 또는 524와 어떻게 다릅니까?
502: 백엔드 서비스가 잠시 사용할 수 없습니다(컨테이너 재시작 중입니다). 30~60초 기다린 뒤 다시 시도하세요. 과금되지 않습니다.- 타임아웃 / 연결 끊김: 클라이언트 타임아웃이 너무 짧습니다 — 서버는 여전히 요청을 처리하고 정상적으로 과금하고 있을 수 있습니다. API 타임아웃을 방지하는 방법을 참고하세요.
429: 동시 실행 수 또는 요청 제한에 도달했습니다. 서비스 가용성과는 무관합니다. API 동시 실행 수 제한을 참고하세요.524: 약 100초를 초과하는 요청으로 CDN 엔드포인트(api-cf.apiyi.com)를 사용 중입니다 — 엔드포인트를 전환하세요.
웹 콘솔과 API가 동시에 실패하는 이유는 무엇입니까?
웹 콘솔과 API가 동시에 실패하는 이유는 무엇입니까?
웹 콘솔과 API는 동일한 서비스에서 구동됩니다. 컨테이너 재시작 중에는 둘 다 함께 사용할 수 없게 되고 함께 복구됩니다 — 따라서 “웹사이트도 다운됐다”는 것은 이것이 클라이언트 설정 문제가 아니라 일시적인 플랫폼 측 이벤트임을 정확히 확인해 줍니다.
이런 일이 자주 발생합니까?
이런 일이 자주 발생합니까?
아닙니다 — 정기적으로 발생하는 일은 아닙니다. 일시적인 502는 대개 갑작스러운 트래픽 급증과 관련이 있으며 산발적으로 발생합니다.2026년 8월 기준으로 백엔드 서버를 업그레이드하고 확장 중이며, 이로 인해 이러한 일시적인 502의 빈도가 크게 줄어들 것입니다. 플랫폼 측 사고가 발생할 때마다 실시간 상태 피드에 상태 업데이트와 복구 진행 상황을 즉시 게시합니다.
플랫폼 문제인지 제 네트워크 문제인지 어떻게 구분합니까?
플랫폼 문제인지 제 네트워크 문제인지 어떻게 구분합니까?
두 가지 빠른 확인 방법이 있습니다:다른 네트워크에서도 5분 이상 계속 502가 반환되면 지원팀에 문의하세요.
- 웹 콘솔을 여세요:
api.apiyi.com가 502를 반환하고 콘솔도 로드되지 않으면, 거의 확실히 일시적인 플랫폼 측 재시작입니다 — 1분 정도 기다리세요. - 네트워크를 전환하세요: 모바일 데이터(다른 통신사)를 사용해 콘솔을 불러오거나, 아래 명령을 실행해 보세요. 그곳에서는 작동한다면 문제는 로컬 네트워크나 프록시입니다.
관련 문서
API 타임아웃을 피하는 방법
타임아웃 설정, reasoning-model 지연 시간, 524 진단
API를 사용하려면 프록시가 필요합니까?
직접 연결 관련 참고사항과 네트워크 요구사항
APIYI의 서버는 어디에 있습니까?
노드 위치, 지연 시간 테스트, 및 구매 조언
서비스 가용성 및 SLA
가용성 약속 및 장애 대응
문의하기
WeCom 지원

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