짧은 답변
- 동기식 이미지 엔드포인트에는 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(동시 실행 수 부족)을 반환한다면 지원팀에 문의하여 쿼터를 검토해 달라고 요청하십시오.타임아웃 치트 시트
4가지 핵심 사항 상세 안내
① 동기식 이미지 엔드포인트: 타임아웃을 360초로 설정하십시오
① 동기식 이미지 엔드포인트: 타임아웃을 360초로 설정하십시오
- 2K/4K 해상도의
high품질 GPT-Image-2는 실제로 3~5분이 소요됩니다 - Nano Banana 4K 생성은 약 50초부터 시작되며, 피크 시간대에는 더 오래 걸립니다
- 다중 이미지 참조 작업은 종종 5분을 초과합니다
② 추론 / 긴 출력 모델: 비스트리밍은 버틸 수 없으므로 스트리밍을 사용하십시오
② 추론 / 긴 출력 모델: 비스트리밍은 버틸 수 없으므로 스트리밍을 사용하십시오
gemini-3.1-pro-previewgpt-5.6-solgpt-5.5-pro(더 비싸고 느림)claude-opus-5및 심층 사고(deep thinking) / 높은 노력 수준(high effort)으로 실행되는 기타 모델- 긴 출력 작업: 드라마 대본, 소설, 장문 번역, 대규모 코드 생성
- 긴 출력에는 스트리밍을 우선 사용하십시오(
stream=True). 읽기 타임아웃은 전체 생성 시간을 감당하는 거대한 단일 값이 아니라 이벤트 간 간격에 맞춰 90~120초로 설정하십시오. - 비스트리밍 방식을 반드시 사용해야 한다면 타임아웃을 300~600초로 설정하고 불안정성을 감수하십시오. 실행 시간이 길어질수록 결과가 도착하기 전에 연결이 끊어질 가능성이 높아집니다.
- 사고 계층(
reasoning_effort/thinking)을 허용된 시간에 맞추십시오. 계층이 높을수록 더 많은 여유 시간이 필요합니다.
③ Base URL 선택: CDN 노드는 긴 요청을 처리할 수 없습니다
③ Base URL 선택: CDN 노드는 긴 요청을 처리할 수 없습니다
api-cf.apiyi.com 앞단에는 Cloudflare 글로벌 CDN이 배치되어 있습니다. 전 세계 가속 및 해외에서의 낮은 지연 시간을 제공하지만, 약 100초의 요청 타임아웃이 적용되어 이 시간을 초과하면 524 오류가 발생합니다.⚠️ 이는 이미지 엔드포인트에만 국한되는 문제가 아닙니다. 다음을 포함하여 100초를 초과할 수 있는 모든 호출에는 적합하지 않습니다:- ❌ 이미지 생성 / 편집
- ❌ 동영상 생성
- ❌ 긴 텍스트 출력(장문 기사, 대규모 번역, 대형 코드 생성)
- ❌ 추론 모델에서의 심층 사고 작업
api.apiyi.com(또는 백업용 b.apiyi.com)을 사용하십시오. 전체 노드 비교는 Base URL 가이드를 참조하십시오.④ 429 동시 실행 수 제한 도달 시: 고객 지원팀에 문의하십시오
④ 429 동시 실행 수 제한 도달 시: 고객 지원팀에 문의하십시오
429 Too Many Requests 오류가 자주 발생한다면, 대개 타임아웃 설정이 아니라 동시 실행 수 쿼터가 원인입니다.동시 실행 수 제한은 전체 계정이 아닌 모델별로 적용됩니다. 특정 모델—특히 새로 출시되었거나 공급이 제한된 모델—은 쿼터가 더 낮을 수 있습니다.조치 방법:- 지수 백오프(exponential backoff)를 구현하여 일시적으로 제한에 도달하지 않도록 하십시오
- 429 오류가 계속 발생하면 APIYI 고객 지원팀에 문의하십시오 — 해당 모델의 실제 쿼터를 확인하고 조정을 도와드릴 수 있습니다
코드 예제
- Python
- Node.js
- cURL
타임아웃을 늘린 후에도 계속 타임아웃이 발생합니까? 모든 홉을 확인하십시오
1단계: SDK 타임아웃이 실제로 적용되는지 확인하십시오
2단계: 경로의 모든 홉을 확인하십시오
- 자체 호스팅 리버스 프록시: Nginx
proxy_read_timeout(기본값 60초) - 클라우드 로드 밸런서: 유휴 연결 타임아웃
- API 게이트웨이 / CDN: 오리진 타임아웃
- 서버리스 함수: 실행 제한 (기본적으로 보통 30~60초)
- 작업 큐 워커: 작업별 타임아웃
3단계: CDN 노드를 사용하고 있지 않은지 확인하십시오
api-cf.apiyi.com인지 확인하십시오. 오래 걸리는 요청의 경우 api.apiyi.com 또는 b.apiyi.com(으)로 전환하십시오.경험적 규칙: **524**은(는) 모델이 느린 것이 아니라 거의 항상 Cloudflare 계층의 타임아웃을 의미합니다.4단계: 타임아웃과 동시 실행 수 제한을 구분하십시오
524 및 연결 끊김은 타임아웃 문제입니다. 429은(는) 쿼터 문제입니다. 해결 방법은 완전히 다릅니다.5단계: 호출 로그에서 실제 지연 시간을 확인하십시오
자주 묻는 질문
이미지 타임아웃을 200초로 설정하여 보통은 충분한데, 왜 가끔씩 여전히 타임아웃이 발생합니까?
이미지 타임아웃을 200초로 설정하여 보통은 충분한데, 왜 가끔씩 여전히 타임아웃이 발생합니까?
타임아웃된 요청에 대해 환불을 받을 수 있습니까?
타임아웃된 요청에 대해 환불을 받을 수 있습니까?
연결이 끊어진 후 ID로 결과를 조회할 수 있도록 비동기 엔드포인트를 제공할 수 있습니까?
연결이 끊어진 후 ID로 결과를 조회할 수 있도록 비동기 엔드포인트를 제공할 수 있습니까?
스트리밍을 사용하면 타임아웃을 방지할 수 있습니까?
스트리밍을 사용하면 타임아웃을 방지할 수 있습니까?
타임아웃을 매우 크게 설정할 때 단점이 있습니까?
타임아웃을 매우 크게 설정할 때 단점이 있습니까?
524와 429의 차이점은 무엇입니까?
524와 429의 차이점은 무엇입니까?
524: Cloudflare 계층 타임아웃으로,api-cf.apiyi.com을(를) 사용했으며 요청이 약 100초를 초과했음을 의미합니다. 노드를 전환하십시오.429: 소요 시간과 무관한 동시 실행 수 또는 요청 제한입니다. 지수 백오프를 추가하고 문제가 지속되면 지원팀에 문의하십시오.
