Calendar page marked with a deadline beside a server rack and a swap arrow between two model cards
Cloudflare는 2026년 11월 20일에 24개의 Workers AI 모델이 응답을 중단한다고 발표했습니다. 이 목록에는 텍스트 생성 모델 16개와 이미지 생성, 음성, 전사(transcription), 비전, 임베딩을 다루는 다른 8개가 포함되어 있습니다. 폐지일 이후 해당 모델로의 요청은 HTTP 410 Gone 및 오류 코드 5028로 실패합니다. Cloudflare는 요청이 새로운 모델로 리디렉션되지 않을 것이라고 밝혔습니다.
제품에서 이 모델 ID 중 하나를 호출하는 기능은 사용자가 변경하지 않으면 11월 20일에 작동을 멈춥니다. 두 번째, 더 작은 변경 사항이 나중에 뒤따릅니다: Durable Objects는 이제 실패한 호출을 기본적으로 재시도합니다.
무슨 일이 있었나 (What Happened)
Cloudflare는 11월 5일의 변경 로그에 폐지 공지를 게시했습니다. 해당 항목은 처음에는 11월 15일을 날짜로 제시했으나, 현재는 11월 20일로 수정되었으며 이전 날짜가 이동했음을 명시하고 있습니다.
영향을 받는 텍스트 생성 모델은 다음과 같습니다:
@cf/deepseek-ai/deepseek-r1-distill-qwen-32b, @cf/deepseek-ai/deepseek-v4-pro-0813, @cf/deepseek-ai/deepseek-v4-flash-0731@cf/nvidia/nemotron-3-120b-a12b@cf/qwen/qwq-32b, @cf/qwen/qwen3-30b-a3b-fp8@cf/moonshotai/kimi-k2.6, @cf/moonshotai/kimi-k2.7-code@cf/zai-org/glm-5.2, @cf/zai-org/glm-5.3-flash@cf/meta/llama-3.1-8b-instruct-fp8, @cf/meta/llama-3.2-1b-instruct, @cf/meta/llama-3.2-3b-instruct- LoRA 베이스 모델인
@cf/meta-llama/llama-2-7b-chat-hf-lora, @cf/google/gemma-2b-it-lora, 그리고 @cf/google/gemma-7b-it-lora
이 모델들에 대해 Cloudflare는 각 모델에 대한 대체품을 하나로 매핑하지 않습니다. 최첨단(frontier-class) 작업에는 @cf/deepseek-ai/deepseek-v4.1-flash-1017 또는 @cf/zai-org/glm-5.3을, 더 작은 모델에는 @cf/google/gemma-4-26b-a4b-it 또는 @cf/qwen/qwen3.8-27b를 제안합니다.
나머지 8개 모델은 명시된 대체 모델을 가지고 있습니다:
| 폐지되는 모델 | Cloudflare의 대체 모델 |
|---|
@cf/myshell-ai/melotts | @cf/deepgram/aura-2-en |
| ... | |
이 마지막 행은 주목해야 할 부분입니다. 글을 작성하는 시점 기준으로, 변경 로그에는 embeddinggemma-2가 '곧 사용 가능(available soon)'으로 표시되어 있으며, 이는 이전 모델이 작동을 멈추기 불과 12일 전의 일입니다. | |
누가 영향을 받나요 (Who Is Affected)
만약 코드 경로(code path), 환경 변수(environment variable), 설정 파일(config file) 또는 데이터베이스 행에 위에 나열된 모델 ID 중 하나가 포함되어 있고 이를 Workers AI로 전송하는 경우 영향을 받습니다. 여기에는 Worker 내의 env.AI 바인딩을 통한 호출, REST API 및 Workers AI를 가리키는 AI Gateway 경로가 포함됩니다.
모델 ID 변경 이상의 조치가 필요한 세 그룹이 있습니다:
embeddinggemma-300m 사용 임베딩 사용자. 서로 다른 임베딩 모델에서 생성된 벡터(Vector)는 일반적으로 비교할 수 없으므로, 새 모델로 이동하는 것은 보통 저장된 문서를 재임베딩하고 인덱스(index)를 다시 구축해야 함을 의미합니다. 이는 제가 추론한 내용이며 Cloudflare의 공식 발표는 아닙니다. 대체 모델이 아직 공개되지 않았기 때문에 이 그룹은 가장 준비할 시간이 부족합니다.- 세 가지 폐지되는 기본 모델에 LoRA 어댑터를 사용하는 팀. 어댑터(adapter)는 특정 기본 모델(base model)을 기반으로 훈련되므로, 지원되는 기본 모델에서 재훈련해야 합니다. Cloudflare의 공지는 어댑터를 직접적으로 다루고 있지 않으므로, 기존 어댑터에 미치는 영향은 확정되지 않은 것으로 간주하십시오.
- 이미지, 음성 및 비전 기능. 대체 모델들은 서로 다른 모델 패밀리에서 나옵니다. 파라미터(Parameter)와 응답 형태(response shape)가 다를 수 있으므로 프롬프트 테스트와 구문 분석 코드(parsing code)를 진행해야 합니다.
오늘 해야 할 일 (What to Do Today)
- 모든 참조를 찾으세요. 설정 파일, 시드 데이터, 기능 플래그 및 관리자 설정에 포함된
@cf/ 문자열을 포함하여 저장소에서 ID를 검색하세요. 예를 들어 테넌트별 모델 선택과 같이 데이터베이스 테이블에 저장된 모델 ID는 코드 검색 결과에 나타나지 않습니다.
- 코드뿐만 아니라 트래픽도 확인하세요. AI Gateway를 사용한다면, 크론 작업(cron job)과 같이 잊힌 호출자를 포착하기 위해 지난 30일 동안 모델별로 로그를 필터링하세요.
- 기능별로 대체 모델을 선택하세요. Cloudflare가 대체 모델 이름을 명시한 위의 표를 사용하세요. 텍스트 모델의 경우, 선택하기 전에 제안된 옵션들을 자체 프롬프트 및 예상 출력물과 비교하여 테스트하세요. Workers AI 모델 카탈로그에는 현재 모델과 해당 입력 옵션이 나열되어 있습니다.
- 지금 임베딩 이동 계획을 세우세요. 만약
embeddinggemma-300m을 사용한다면, 오늘 embeddinggemma-2를 기다릴지 아니면 다른 사용 가능한 임베딩 모델로 전환하고 재색인(re-index)할지 결정하세요. 기다리는 것은 출시 날짜에 대한 베팅입니다.
410을 명시적으로 처리하세요. 모델 ID를 기록하고 알림을 보내는 HTTP 410 및 오류 코드 5028에 대한 확인 절차를 추가하세요. 이 코드는 다른 Workers AI 오류 코드와 함께 문서화되어 있습니다.- 미래를 위해 모델 별칭을 고려하세요. AI Gateway는 11월 4일에 모델 별칭을 추가했습니다: 코드는
custom/support-fast와 같은 하나의 이름을 호출하고, 게이트웨이는 순서대로 모델 목록을 시도하며 요청이 실패하면 폴백(fallback)합니다. 다음 폐지는 설정 변경 사항이 됩니다.
안전성 검증 방법
- 폐지되는 각 ID에 대한 저장소 검색은 활성 참조가 아닌 댓글이나 마이그레이션 노트만 반환합니다.
- AI Gateway 로그 또는 자체 요청 로그에서 11월 20일 이전에 폐지되는 ID로의 호출이 표시되지 않습니다.
- 변경된 각 기능은 실제 입력(샘플 프롬프트, 참조 이미지 또는 오디오)과 알려진 쿼리에 대한 임베딩 검색 테스트를 통해 검사를 통과합니다.
- 알림은 테스트
410 응답에서 발생하므로, 누락된 호출자는 지원 티켓이 아닌 20일에 나타납니다.
두 번째 변경 사항: Durable Object가 이제 호출을 재시도합니다 (Durable Objects Now Retry Calls)
Cloudflare는 또한 11월 5일부로 Durable Object 호출에 자동 재시도 기능을 활성화했습니다. Durable Object에 도달하기 전에 fetch() 또는 RPC 호출이 재시도 가능한 오류(retryable error)로 실패하는 경우, 런타임은 이제 최대 네 번까지 재시도를 수행하며, 첫 번째 시도 후 10초를 초과하여 재시도가 시작되지 않습니다. 자체 Durable Object 코드에서 발생한 오류와 .overloaded로 표시된 오류는 재시도되지 않습니다.
만약 런타임이 첫 번째 시도가 도착했는지 여부를 알 수 없다면, 그래도 재시도를 수행하지만, 해당 메서드가 retryable()로 표시되지 않은 경우 Durable Object는 중복을 거부합니다. 증분(increment)보다는 설정자(setter)와 같이 **멱등성(idempotent)**이 있는 메서드만 표시하십시오.
조치 사항: 코드가 이미 Durable Object 호출을 자체 재시도 루프로 감싸고 있다면, 시도가 중첩됩니다. 자체 재시도를 줄이거나, 코드가 재시도를 처리하는 스텁에는 retry: { maxRetries: 0 }를 전달하십시오. retryable() 헬퍼와 retry 옵션은 Wrangler 4.158.0 이상이 필요합니다. 왜 재시도된 부작용(side effects)에 멱등성이 필요한지에 대한 내용은 cron, queues 및 workflows 중 선택하는 가이드를 참조하십시오.
다음에 주목할 사항 (What to Watch Next)
embeddinggemma-2 출시. 만약 이 모델이 11월 20일 이전에 원활하게 배포되지 않으면, 임베딩(embedding) 사용자들은 Cloudflare에서 재색인(re-index)할 오버랩 영역이 거의 없거나 없을 수 있습니다.- 추가 날짜 변경 사항. 이미 날짜가 한 번 변경된 적이 있으니, 전환(cutover) 전에 다시 확인하되 11월 20일을 기준으로 계획하십시오.
- 다른 제공업체의 모델 단종. 여러 AI API가 11월 말과 12월에 모델을 단종시킵니다. 설정(config)에 모델 ID를 유지하고 자체 데이터로 대체품을 테스트하십시오. 모델 라우팅 가이드에서 모델 비교 방법을 다루고 있습니다.
다음 단계 (Next Step)
제품 내 모든 Workers AI 모델 ID가 어디에 있는지 확실하지 않다면, 오늘 리포지토리(repository) 및 게이트웨이 로그(gateway-log) 검색을 실행하십시오. 임베딩(embedding) 및 LoRA 사례는 가장 많은 준비 시간이 필요합니다. 모델 사용처 매핑, 대체품 테스트 또는 모델 선택을 설정(config)으로 옮기는 데 도움이 필요하면 AI SaaS 개발을 참조하십시오. AI 기능 목록과 각 기능이 어디에 설정되어 있는지 정리하여 가져오십시오.
