연결 중단 문제 해결

이미지 생성은 장시간 요청(10–60초)이며, 연결 중단의 대부분은 클라이언트 또는 중간 계층의 타임아웃으로 인해 발생합니다. 아래 순서대로 문제를 해결하세요.

문제 해결 체크리스트

1. HTTP 클라이언트 타임아웃: requests / axios / fetch의 기본 타임아웃은 일반적으로 30초로, 생성 소요 시간보다 짧으면 반드시 중단됩니다. ≥120초로 통일하여 변경하세요:

   client = OpenAI(base_url="...", api_key="...", timeout=180)

2. 자체 구축 리버스 프록시 타임아웃: nginx의 기본값은 proxy_read_timeout 60s이므로, 마찬가지로 늘려야 합니다:

   proxy_read_timeout 180s;
   proxy_send_timeout 180s;

3. 응답 본문 크기 제한: base64로 반환 시 응답이 수 MB에 달할 수 있으므로, 프록시 및 게이트웨이의 client_max_body_size / body 상한을 확인하세요;

4. 회사 네트워크 / 프록시: 일부 기업 프록시는 장시간 연결을 차단하므로, 직접 연결 네트워크로 전환하여 비교 테스트하세요;

5. 과도한 동시 요청: 대량의 동시 요청 시 일부 요청이 대기열에 쌓여 총 소요 시간이 길어지면서 타임아웃이 발생합니다 — 동시 요청 수를 줄이거나 큐를 추가하세요.

중단 후 올바른 처리 방법

• 실패한 요청은 요금이 차감되지 않으며(선차감 금액은 자동 반환), 안전하게 재시도할 수 있습니다;
• 지수 백오프 방식으로 재시도하세요(5초 → 15초 → 45초), 즉시 연속으로 재전송하지 마세요;
• 피크 시간대의 간헐적인 5xx는 업스트림 불안정으로 인한 것이며, 1–2회 재시도하면 보통 복구됩니다. 오류 코드 및 재시도를 참고하세요.

여전히 해결되지 않는 경우

콘솔의 “로그”에서 해당 요청의 상태를 확인하세요. 요청 시간과 모델명을 첨부하여 고객 지원 채널을 통해 서버 측 문제를 문의하세요.