Unsupported model version 오류

Unsupported model version 오류

AI SDK 5로 마이그레이션하다 보면 모델이 지원되지 않는 버전을 사용한다는 오류를 만날 수 있어요. 여기서 원인과 해결책을 정리해 드릴게요.

출처: 문서

본문

문제 (Issue)

AI SDK 5로 마이그레이션할 때 모델이 지원되지 않는 버전을 사용한다는 오류가 발생할 수 있습니다.

AI_UnsupportedModelVersionError: Unsupported model version v1 for provider "ollama.chat" and model "gamma3:4b".
AI SDK 5 only supports models that implement specification version "v2".

이 오류는 사용 중인 프로바이더 패키지의 버전이 이전(v1) 모델 스펙을 구현하고 있기 때문에 발생합니다.

배경 (Background)

AI SDK 5는 모든 프로바이더 패키지가 스펙 버전 "v2"를 구현하도록 요구합니다. AI SDK 5로 업그레이드하면서 프로바이더 패키지를 호환 버전으로 업데이트하지 않으면 계속 이전 "v1" 스펙을 사용하게 되어 이 오류가 발생합니다.

해결책 (Solution)

프로바이더 패키지를 AI SDK 5 호환 버전으로 업데이트

모든 @ai-sdk/* 프로바이더 패키지를 호환 버전인 2.0.0 이상으로 업데이트하세요. 이 버전들은 AI SDK 5가 요구하는 v2 스펙을 구현합니다.

pnpm install ai@latest @ai-sdk/openai@latest @ai-sdk/anthropic@latest

AI SDK 5 호환성을 위해 필요한 버전은 다음과 같습니다.

  • ai 패키지: 5.0.0 이상
  • @ai-sdk/* 패키지: 2.0.0 이상 (예: @ai-sdk/openai, @ai-sdk/anthropic, @ai-sdk/google)
  • @ai-sdk/provider 패키지: 2.0.0 이상
  • zod 패키지: 4.1.8 이상

프로바이더 호환성 확인

써드파티나 커스텀 프로바이더를 사용한다면 AI SDK 5를 지원하도록 업데이트되었는지 확인하세요. 모든 프로바이더가 아직 v2 호환 버전을 제공하지 않을 수도 있습니다.

프로바이더가 AI SDK 5를 지원하는지 확인하려면:

  1. 프로바이더의 package.json에서 @ai-sdk/provider peer dependency 버전이 2.0.0 이상인지 확인
  2. 프로바이더의 changelog나 마이그레이션 가이드 검토
  3. 프로바이더 저장소에서 AI SDK 5 지원 여부 확인

AI SDK 5 마이그레이션에 대한 자세한 내용은 AI SDK 5.0 마이그레이션 가이드를 참고하세요.

더 알아보기 (Learn more)