증상
VPN 또는 프록시 클라이언트가 실행 중인 자체 컴퓨터에서 이미지 생성 앱을 개발하거나 디버깅하고 있습니다(많은 개발자가 AI 코딩 도구가 인터넷에 연결될 수 있도록 VPN 또는 프록시 클라이언트를 계속 실행해 둡니다). 다음과 같은 현상이 나타납니다.- 이미지 요청이
socket hang up,ECONNRESET,RemoteDisconnected또는Connection aborted와 같은 연결 오류로 자주 실패합니다. - 클라이언트 타임아웃이 600초 또는 900초인데도 요청이 약 90-180초 후에 중단됩니다.
- 여러 요청이 마치 함께 종료된 것처럼 동일한 순간에 실패하는 경우가 많습니다.
- 응답이 느린 모델에서 더 자주 발생합니다(예: 이미지 하나를 생성하는 데 보통 60-120초가 걸리는
gpt-image-2-vip). - 호출 로그에서 이러한 요청의 대부분이 성공하고 과금된 것으로 표시됩니다
짧은 답변
이는 동시 실행 수 제한도 아니며 APIYI의 시간 초과도 아닙니다. 컴퓨터의 프록시가 일정 시간 동안 데이터가 전혀 전송되지 않은 연결을 종료하고 있습니다.이미지가 생성되는 동안에는 연결을 통해 데이터가 전혀 흐르지 않습니다. 이미지 생성에 오래 걸릴수록 프록시가 해당 연결을 유휴 상태로 판단하여 종료할 가능성이 커집니다.
api.apiyi.com를 직접 라우팅하면(프록시 우회) 문제가 해결됩니다. 중국 본토에서는 APIYI에 직접 연결할 수 있습니다.발생 원인
비스트리밍 이미지 요청은 세 단계로 진행됩니다.- 업로드: prompt와 참조 이미지가 전송되며, 몇 초에서 수십 초가 걸립니다.
- 대기: 서버가 이미지를 생성하며, 일반적으로 60~200초가 걸립니다. 이 시간 동안 연결을 통해 어떠한 데이터도 전송되지 않습니다.
- 다운로드: 완성된 이미지가 한 번에 반환됩니다.
connIdle이며 기본값은 300초입니다. 그러나 프록시 서버 운영자는 이 값을 훨씬 더 짧게 설정할 수 있고, 사용자의 컴퓨터에서는 그 값을 확인하거나 변경할 수 없습니다. 조사한 사례에서는 이 값이 약 90초였습니다.
그 결과는 다음과 같습니다.
- 클라이언트 시간 제한으로는 해결할 수 없습니다. 시간 제한은 프로그램이 얼마나 오래 기다릴지에 대한 설정일 뿐입니다. 중간의 프록시가 먼저 연결을 종료하므로 프로그램에는 연결이 끊긴 것으로만 표시됩니다.
- 요청이 묶음으로 실패하는 이유: 프록시는 일반적으로 타이머에 따라 연결을 정리하며, 너무 오래 유휴 상태였던 모든 연결을 한꺼번에 종료합니다. 따라서 이미지 생성을 기다리던 여러 요청이 같은 순간에 실패할 수 있습니다.
- 채팅 및 코딩 도구는 정상적으로 작동하는 이유: 스트리밍 채팅은 계속 데이터를 전송하므로 연결이 유휴 상태가 되지 않습니다. 반면 이미지 생성은 수 분 동안 아무것도 전송하지 않습니다.
확인 방법
1
소요 시간을 확인합니다
오류가 발생하기 전에 각 실패한 요청이 실행된 시간을 기록합니다. 소요 시간이 특정 값(예: 90초 또는 180초)을 중심으로 몰리고 여러 요청이 자주 같은 초에 실패한다면 프록시 유휴 시간 초과가 원인일 가능성이 매우 높습니다.
2
호출 로그와 비교합니다
호출 로그에서 동일한 시간대의 기록을 조회합니다. 프로그램에서는 연결 끊김을 보고했지만 로그에 성공적으로 과금된 요청으로 표시된다면, APIYI가 이미지 생성을 완료한 후 사용자에게 돌아가는 연결이 끊긴 것입니다.
3
직접 경로로 소규모 배치를 실행합니다
아래 설명에 따라
api.apiyi.com을 직접 라우팅하고 동일한 매개변수로 이미지 10~20개를 실행합니다. 연결 끊김이 사라지면 프록시가 원인이었던 것입니다.해결 방법
- 프록시 클라이언트에서 직접 규칙 설정(권장)
- 프로그램에서 프록시 우회
- 프록시를 반드시 사용해야 하는 경우
프록시 클라이언트에 APIYI용 직접 규칙을 추가합니다. 그 외의 모든 트래픽은 계속 프록시를 통해 전달되므로 AI 코딩 도구에는 영향을 주지 않습니다.Clash / Clash Verge / mihomo의 경우 설정 파일에서 v2rayN 및 유사한 클라이언트의 경우 라우팅 설정에서 직접 목록에
rules의 맨 위에 다음을 추가합니다.apiyi.com을 추가합니다.TUN 모드 또는 전역 모드에서는 프록시가 컴퓨터의 모든 프로그램에서 발생하는 트래픽을 캡처하므로 코드에서 이를 우회할 수 없습니다. 이와 같은 직접 규칙을 설정하는 것이 유일한 해결 방법입니다.
서버에 배포한 후에도 이런 문제가 발생합니까?
대부분 발생하지 않습니다. 서버는 일반적으로 프록시 없이 실행되며 APIYI에 직접 연결하므로, 유휴 연결을 종료하는 프록시가 없습니다. 이는 권장되는 프로덕션 설정이기도 합니다. 중국 본토의 클라우드 서버는api.apiyi.com에 직접 연결할 수 있습니다.
서버와 APIYI 사이에 다른 계층이 있다면 해당 계층에도 유휴 타임아웃이 있습니다. 배포할 때 다음 항목을 확인하십시오.
이미지 하나는 일반적으로 60~200초 이내에 완료되므로 클라우드 NAT의 기본값보다 짧습니다. 자체 리버스 프록시를 추가했거나 서버도 프록시를 통해 연결되는 경우에만 추가 작업이 필요합니다.
자주 묻는 질문
TCP 킵얼라이브를 활성화하면 도움이 됩니까?
TCP 킵얼라이브를 활성화하면 도움이 됩니까?
클라우드 NAT 게이트웨이에는 도움이 됩니다. 킵얼라이브 프로브가 NAT에 연결이 여전히 활성 상태임을 알리기 때문입니다. 실제 데이터로 유휴 상태를 판단하는 프록시 클라이언트에는 거의 효과가 없으며, 킵얼라이브 프로브는 데이터로 간주되지 않습니다. 로컬 개발 환경에서는 여전히 직접 경로를 사용하는 것이 해결책입니다.
웹 콘솔과 AI 코딩 도구는 왜 정상적으로 작동합니까?
웹 콘솔과 AI 코딩 도구는 왜 정상적으로 작동합니까?
이러한 요청은 빠르게 반환되거나 출력을 계속 스트리밍하므로 연결이 90초 이상 유휴 상태로 유지되지 않습니다. 몇 분 동안 아무것도 전송하지 않다가 한 번에 모든 결과를 반환하는 이미지 생성과 같은 요청에서만 이 문제가 발생합니다.
빈 502 문제와 같은 것입니까?
빈 502 문제와 같은 것입니까?
두 문제 모두 로컬 프록시로 인해 발생하지만 증상은 다릅니다. 빈 502의 경우 프록시가 본문 없이 502 응답을 임의로 생성합니다. 이 경우에는 이미지를 기다리는 동안 연결이 끊기며, 프로그램에는 연결이 끊어진 것으로 표시됩니다. 두 경우의 해결 방법은 같습니다. APIYI 요청이 프록시를 거치지 않도록 하십시오.
연결이 끊긴 요청에 대한 요금을 환불받을 수 있습니까?
연결이 끊긴 요청에 대한 요금을 환불받을 수 있습니까?
이러한 연결 끊김은 사용자와 APIYI 사이의 프록시에서 발생하며, APIYI가 이미 이미지를 생성하고 과금한 이후에 발생합니다. 금액이 상당한 경우 시간대(예: 16:30-17:00 (UTC+8))와 사용자 이름을 지원팀에 보내 주시면 호출 로그를 함께 확인해 드리겠습니다.
이렇게 오래 기다리지 않고 호출할 방법이 있습니까?
이렇게 오래 기다리지 않고 호출할 방법이 있습니까?
이미지 엔드포인트는 현재 작업 ID 폴링 없이 동기식으로 반환됩니다. 비동기 이미지 API가 있습니까? 작업 ID로 결과를 조회할 수 있습니까?를 참조하십시오. APIYI가 직접 경로로 라우팅되면 오래 기다리는 것 자체는 문제가 되지 않습니다.
관련 문서
이미지 요청이 결과 없이 멈추지만 로그에는 쓰기 실패가 표시됩니까?
반대의 문제입니다. 직접 연결로는 대용량 이미지를 전송할 수 없으므로 프록시를 통해 라우팅합니다
스크립트에서 502가 반환되지만 호출 로그에는 아무것도 표시되지 않습니까?
로컬 프록시에서 만들어진 빈 502입니다. 시스템 프록시를 우회하면 해결됩니다
API를 사용하려면 프록시가 필요합니까?
중국 본토에서 직접 액세스할 수 있으며, 프록시나 VPN이 필요하지 않습니다
API 타임아웃을 방지하려면 어떻게 해야 합니까?
타임아웃 설정 및 계층별 문제 해결
비동기 이미지 API가 있습니까?
응답이 동기식인 이유와 이를 비동기 방식으로 래핑하는 방법