제공자(Provider) 고르기

제공자(Provider) 고르기

AI SDK는 수십 개의 모델 제공자를 지원해요. 제공자는 크게 세 종류로 나뉘는데, Vercel이 직접 만든 일급(first-party) 패키지, OpenAI 호환(OpenAI-compatible) 패키지, 그리고 커뮤니티 패키지예요. 처음 시작할 때 어떤 경로를 선택하느냐에 따라 환경 변수 하나로 끝나는 간단한 설정부터 커스텀 통합까지 갈리죠. 가장 빠른 방법부터 하나씩 짚어볼게요.

출처: 공식문서

본문

AI Gateway

Vercel AI Gateway는 AI SDK를 시작하는 가장 빠른 길이에요. OpenAI, Anthropic, Google 등 여러 제공자의 모델을 하나로 접근할 수 있고, 인증은 OIDC나 AI Gateway API 키로 해요. API 키를 받아서 환경에 넣어두면 됩니다.

AI_GATEWAY_API_KEY=your_api_key_here

AI Gateway는 기본 전역 제공자(default global provider)라서, 아래처럼 간단한 문자열로 바로 모델을 사용할 수 있어요.

import { generateText } from 'ai';

const { text } = await generateText({
  model: 'anthropic/claude-sonnet-4.5',
  prompt: 'What is love?',
});

gateway 제공자를 명시적으로 import 해서 쓸 수도 있어요.

// Option 1: 'ai' 패키지에서 import (기본 포함)
import { gateway } from 'ai';
model: gateway('anthropic/claude-sonnet-4.5');

// Option 2: '@ai-sdk/gateway' 패키지를 설치해 import
import { gateway } from '@ai-sdk/gateway';
model: gateway('anthropic/claude-sonnet-4.5');

전용 제공자(Dedicated Providers) 사용

일급·OpenAI 호환·커뮤니티 제공자 패키지를 직접 설치해서 쓸 수도 있어요. 패키지를 설치하고 제공자 인스턴스를 만들면 됩니다. 예를 들어 Anthropic을 쓴다면:

pnpm add @ai-sdk/anthropic

import { anthropic } from '@ai-sdk/anthropic';

model: anthropic('claude-sonnet-4-5');

애플리케이션 전체에서 문자열 모델 참조가 특정 제공자를 쓰도록 기본 전역 제공자를 바꿀 수도 있어요. 이 부분은 제공자 관리(Provider & Model Management) 문서에서 다룹니다.

커스텀 제공자(Custom Providers)

원하는 어떤 서비스든 AI SDK에 통합할 수 있게 직접 제공자를 만들 수도 있어요. AI SDK는 Language Model Specification을 제공해서, 제공자 간 호환성을 보장해줍니다.

import { generateText } from 'ai';
import { yourProvider } from 'your-custom-provider';

const { text } = await generateText({
  model: yourProvider('your-model-id'),
  prompt: 'What is love?',
});

완전한 가이드는 커스텀 제공자 작성 문서(Writing a Custom Provider)를 참고하세요.

더 알아보기