Google 프로바이더

Google 프로바이더

Google 프로바이더는 @ai-sdk/google 모듈로 제공되며 Google Generative AI API의 언어·임베딩 모델을 지원합니다. 기본 인스턴스 google을 import하거나 createGoogle로 커스터마이징한 인스턴스를 생성할 수 있습니다. 모델들은 도구 호출을 지원하고 일부는 멀티모달입니다.

출처: 공식문서

본문

설치

pnpm add @ai-sdk/google

프로바이더 인스턴스

기본 인스턴스:

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

커스텀 인스턴스:

import { createGoogle } from '@ai-sdk/google';

const google = createGoogle({
  // custom settings
});

인스턴스 커스터마이징 옵션:

  • baseURL — API 호출 URL 프리픽스. 기본값 https://generativelanguage.googleapis.com/v1beta.
  • apiKey — x-goog-api-key 헤더로 전송. 기본값 GOOGLE_GENERATIVE_AI_API_KEY 환경변수.
  • headers — 커스텀 헤더.
  • fetch — 커스텀 fetch 구현(기본 전역 fetch). 미들웨어·테스트용.
  • generateId — 요청별 고유 ID 생성 함수(기본 SDK 내장 생성기).
  • name — 커스텀 프로바이더 이름(기본 google.generative-ai).

언어 모델

프로바이더 인스턴스로 Google Generative AI API 모델을 만듭니다. 첫 번째 인자는 모델 ID(예: gemini-3.8-flash):

const model = google('gemini-3.8-flash');

generateText로 텍스트 생성:

import { google } from '@ai-sdk/google';
import { generateText } from 'ai';

const { text } = await generateText({
  model: google('gemini-3.8-flash'),
  prompt: 'Write a vegetarian lasagna recipe for 4 people.',
});

Google 언어 모델은 streamText에서도 사용 가능하며 AI SDK Core의 Output으로 구조화 데이터 생성을 지원합니다. 또한 .embeddingModel('model-id')로 임베딩 모델을 만들 수 있습니다.

GPT-6 및 이후 모델 주의

문서에 따르면 일부 후속 모델은 temperature·topP·logprobs·레거시 promptCacheRetention 옵션을 지원하지 않아, 프로바이더가 이 설정을 제거하고 경고를 반환할 수 있습니다.

더 알아보기