짧은 답변
타임아웃 문제의 90%를 커버하는 세 가지 황금 규칙입니다:
- 동기식 이미지 엔드포인트에는 360초 타임아웃을 설정하십시오. 이미지 생성에는 비동기 작업 ID가 없습니다. 너무 일찍 연결이 끊기면 과금은 되지만 이미지는 받지 못합니다.
- 추론 모델에는 충분한 시간을 주십시오.
gemini-3.1-pro-preview,gpt-5.6-sol,gpt-5.5-pro는 stream 여부와 상관없이 몇 분이 걸릴 수 있습니다. - 긴 요청은 절대 CDN 노드를 통해 실행하지 마십시오.
api-cf.apiyi.com는 Cloudflare 뒤에 있으며 약 100초가 지나면524를 반환합니다. 빠른 텍스트 호출에만 적합합니다.
429(동시 실행 수 부족)을 반환한다면 지원팀에 문의하여 쿼터를 검토해 달라고 요청하십시오.타임아웃 치트시트
네 가지 핵심을 자세히
① 동기식 이미지 엔드포인트: 타임아웃을 360초로 설정하십시오
① 동기식 이미지 엔드포인트: 타임아웃을 360초로 설정하십시오
APIYI의 모든 이미지 모델은 동기식입니다. 요청을 보내고 연결을 유지하면 결과가 응답 본문으로 돌아옵니다. 비동기 작업 ID도 없고 폴링 엔드포인트도 없습니다. 연결이 끊기면 결과도 사라집니다.기본값이 발목을 잡는 이유: 주류 HTTP 클라이언트의 기본 타임아웃은 30~60초이지만, 이미지 생성은 실제로 매우 긴 요청입니다.
- GPT-Image-2를
high품질로 2K/4K에서 사용하면 실제로 3~5분이 걸립니다 - Nano Banana 4K 생성은 대략 50초부터 시작하며, 혼잡할 때는 더 오래 걸립니다
- 다중 이미지 레퍼런스 작업은 5분을 넘는 경우가 많습니다
② 추론 모델: 스트리밍 여부와 관계없이 느립니다
② 추론 모델: 스트리밍 여부와 관계없이 느립니다
일반 텍스트 모델은 몇 초 만에 응답하므로, 텍스트 호출에는 타임아웃 조정이 필요 없다고 생각하기 쉽습니다. 추론 모델은 예외입니다:
gemini-3.1-pro-previewgpt-5.6-solgpt-5.5-pro(더 비싸고 더 느립니다)- 높은 thinking budget(높은 reasoning_effort)으로 실행 중인 모든 모델
stream=True이면 데이터가 즉시 도착한다고 생각하지만, 추론 모델은 생각하는 단계 동안 token을 전혀 내보내지 않을 수 있으므로 읽기 타임아웃이 여전히 발생합니다. 그리고 첫 token부터 마지막 token까지의 총 시간도 여전히 깁니다.권장 사항: 추론 모델에는 타임아웃을 300~600초로 설정하고, 허용한 시간에 맞추어 추론 단계(reasoning_effort / thinking)를 조정하십시오. 더 높은 단계일수록 여유 시간이 더 필요합니다.③ Base URL 선택: CDN 노드는 긴 요청을 처리할 수 없습니다
③ Base URL 선택: CDN 노드는 긴 요청을 처리할 수 없습니다
APIYI의
api-cf.apiyi.com은 Cloudflare 글로벌 CDN으로 앞단이 구성되어 있습니다. 전 세계 가속과 해외에서의 낮은 지연 시간을 제공하지만, 요청 타임아웃이 약 100초이므로 그 시간을 넘기면 524 오류가 발생합니다.⚠️ 이는 이미지 엔드포인트에만 영향을 주는 것이 아닙니다. 100초를 넘길 수 있는 호출은 모두 적합하지 않으며, 예를 들면 다음과 같습니다.- ❌ 이미지 생성 / 편집
- ❌ 동영상 생성
- ❌ 긴 텍스트 출력(긴 기사, 대규모 번역, 대형 코드 생성)
- ❌ 추론 모델의 깊은 추론 작업
api.apiyi.com(중국 본토에서 권장) 또는 vip.apiyi.com(해외에서 권장)을 사용하십시오. 전체 노드 비교는 Base URL 가이드를 보십시오.④ 429 동시 실행 수 제한에 걸리면: 지원팀에 문의하십시오
④ 429 동시 실행 수 제한에 걸리면: 지원팀에 문의하십시오
타임아웃과 함께
429 Too Many Requests가 자주 발생한다면, 문제는 대개 동시 실행 수 쿼터이며 타임아웃이 아닙니다.동시 실행 수 제한은 계정 전체가 아니라 모델별로 적용됩니다. 특정 모델, 특히 새로 출시되었거나 공급이 제한된 모델은 더 낮은 쿼터를 가질 수 있습니다.조치 방법:- 버스트로 제한을 포화시키지 않도록 지수 백오프를 구현하십시오
- 429가 계속되면 APIYI 지원팀에 문의하십시오 — 해당 모델의 실제 쿼터를 확인하고 조정하는 데 도움을 드릴 수 있습니다
코드 예제
- Python
- Node.js
- cURL
타임아웃을 늘린 뒤에도 여전히 시간 초과가 발생합니까? 모든 홉을 확인하십시오
1
Step 1: SDK 타임아웃이 실제로 적용되는지 확인하십시오
일부 프레임워크는 HTTP 클라이언트 위에 다른 타임아웃을 감쌉니다. 실제 적용 구성을 출력하고, 변경한 매개변수가 실제로 사용되는지 확인하십시오.
2
Step 2: 경로의 모든 홉을 확인하십시오
생성 시간보다 짧은 타임아웃을 가진 모든 계층은 클라이언트보다 먼저 연결을 끊습니다:
- 자체 호스팅 역방향 프록시: Nginx
proxy_read_timeout(기본값은 60초) - 클라우드 로드 밸런서: 유휴 연결 타임아웃
- API 게이트웨이 / CDN: 오리진 타임아웃
- 서버리스 함수: 실행 제한(기본값은 보통 30~60초)
- 태스크 큐 워커: 작업별 타임아웃
3
Step 3: CDN 노드에 있지 않은지 확인하십시오
Base URL이
api-cf.apiyi.com인지 확인하십시오. 긴 요청의 경우 api.apiyi.com 또는 vip.apiyi.com로 전환하십시오.경험칙으로는 **524**은 거의 항상 Cloudflare 계층 타임아웃을 의미하며, 느린 모델을 의미하지는 않습니다.4
Step 4: 타임아웃과 동시 실행 수 제한을 구분하십시오
상태 코드를 읽으십시오:
524와 연결 끊김은 타임아웃 문제이며, 429는 쿼터 문제입니다. 해결 방법은 완전히 다릅니다.5
Step 5: 실제 지연 시간은 호출 로그에서 확인하십시오
콘솔의 호출 로그에서 요청의 실제 소요 시간과 과금을 확인한 뒤, 그 값을 바탕으로 적절한 타임아웃을 산정하십시오.
자주 묻는 질문
타임아웃된 요청에 대해 환불받을 수 있습니까?
타임아웃된 요청에 대해 환불받을 수 있습니까?
아닙니다. 클라이언트가 연결을 끊은 뒤에도 서버와 upstream은 작업을 계속 완료하므로, 비용이 실제로 발생합니다.올바른 방법은 작은 값을 두고 재시도에 의존하는 대신, 타임아웃을 한 번에 안전한 상한선으로 설정하는 것입니다. 재시도는 과금만 늘릴 뿐입니다.
연결이 끊긴 뒤 ID로 결과를 가져올 수 있도록 비동기 엔드포인트를 제공할 수 있습니까?
연결이 끊긴 뒤 ID로 결과를 가져올 수 있도록 비동기 엔드포인트를 제공할 수 있습니까?
이미지 엔드포인트는 현재 동기 패스스루 모드로 실행되며, 고객 비즈니스 데이터를 저장하지 않으므로 “연결 해제 후 ID로 가져오기”는 사용할 수 없습니다.권장 패턴은 동기 호출 + 넉넉한 타임아웃 + 자체 작업 상태 테이블입니다. 이는 사실상 가벼운 비동기 큐와 같습니다. 이미지 엔드포인트는 동기식입니까, 비동기식입니까?를 참고하십시오.동영상 모델은 기본적으로 비동기이며, 이는 영향을 받지 않습니다.
스트리밍이 타임아웃을 방지합니까?
스트리밍이 타임아웃을 방지합니까?
부분적으로는 그렇지만, 여기에 의존해서는 안 됩니다.스트리밍은 첫 token을 더 빨리 전달하므로 전체 무응답 위험을 줄여 줍니다. 그러나 추론 모델은 사고 단계 동안 아무것도 출력하지 않을 수 있으므로 읽기 타임아웃은 여전히 발생하며, 전체 출력 시간은 결국 여전히 오래 걸립니다.올바른 방법은 스트리밍 + 넉넉한 타임아웃입니다.
매우 큰 타임아웃을 설정하면 단점이 있습니까?
매우 큰 타임아웃을 설정하면 단점이 있습니까?
과금 영향은 없습니다 — 기다린 시간과는 무관하게 소비한 token과 호출에 대해서만 과금됩니다.유일한 우려는 사용자 측의 리소스 사용입니다. 긴 연결은 워커 또는 커넥션 풀 슬롯을 점유합니다. 높은 동시 실행 수에서는 이미지와 추론 요청을 비동기 I/O 또는 전용 장기 작업 큐로 처리하십시오.
524와 429의 차이점은 무엇입니까?
524와 429의 차이점은 무엇입니까?
524: Cloudflare 계층 타임아웃으로,api-cf.apiyi.com를 사용했고 요청이 약 100초를 초과했다는 뜻입니다. 노드를 전환하십시오.429: 지속 시간과는 무관한 동시 실행 수 또는 요청 제한입니다. 지수 백오프를 추가하고, 문제가 계속되면 지원팀에 문의하십시오.
관련 문서
이미지 API 모범 사례
모델별 타임아웃 표와 출력 형식 참고
Base URL은 어떻게 설정합니까?
네 개 노드의 차이점과 선택 방법
이미지 엔드포인트는 동기식입니까, 비동기식입니까?
동기식 모드와 클라이언트 측 작업 관리
사용할 수 있는 동시 실행 수는 얼마입니까?
모델 유형별 동시 실행 수 제한과 쿼터 요청
문의하기
WeCom 지원
이메일
지원: [email protected]비즈니스: [email protected]
