이번 소식
Cloudflare AI Gateway가 AI 제공업체에서 인증정보를 거절했을 때의 REST API 응답을 통일했습니다. 적용 범위는 POST /ai/run입니다. 여러 AI 제공업체를 연결한 앱에서 오류를 구분하는 코드를 관리하는 개발자가 대상입니다.
달라진 점
- ElevenLabs는 기존
UserCredentialsError와 HTTP403대신, HTTP401과 오류 코드2009를 반환합니다. - Google Vertex도 거절된 인증정보에 기존 HTTP
500대신401·2009를 반환합니다. 이 경우 제공업체에 다시 시도하지 않고 요청을 실패 처리합니다. - 다른 제공업체의 인증정보 거절도 기존
402또는 업체별 상태값에서401·2009로 바뀝니다. - Unified Billing은 예외입니다. 이 통합 결제 방식을 사용할 때 제공업체가 인증정보를 거절하면 HTTP
503을 반환합니다.
어떤 점이 달라지나요?
예를 들어 여러 모델을 연결한 앱이 500만 보고 일시적 장애로 판단하거나, 402를 결제 문제 안내에 연결했다면 해당 오류 처리 분기를 점검해야 합니다. 이번 변경 대상인 제공업체 인증정보 거절을 새 응답으로 식별하고, Unified Billing의 예외를 별도로 다룰 필요가 있습니다.
이는 공식 변경을 바탕으로 한 점검 예시입니다. 모든 401 오류가 제공업체 키 문제라는 뜻은 아니며, 다른 API 형식에도 같은 변경이 적용된다고 확대하지 않습니다. 새로운 인증 방식이나 보안 사고가 발표된 것도 아닙니다.
공식 출처·발표 시점
공식 발표일은 2026년 10월 6일이며 세부 발표 시각·시간대는 미공개입니다. 해당 공지의 공식 배포 브랜치 반영은 2026년 10월 7일 01:14:05 KST로 확인했습니다. 이는 문서 반영 시각이며 API 적용 완료 시각은 아닙니다. URL의 날짜 문자열과 달리 공지 본문·원본 문서는 10월 6일을 명시합니다.
이번 조사에서는 공식 원문과 변경 이력을 확인했으며, 실제 API 오류를 재현하지 않았습니다.
새 글 받아보기
RSS 리더에서 BlogFlow의 새 글을 확인할 수 있습니다.