Vercel AI SDK 연동
Vercel AI SDK(
ai 패키지)에서 베이즈 Gateway의 AI 모델을 사용하는 방법을 안내합니다.@ai-sdk/openai-compatible 프로바이더에 Gateway Base URL과 API 키를 넣으면 generateText, streamText, 도구 호출을 그대로 쓸 수 있습니다. Claude 모델은 @ai-sdk/anthropic 프로바이더로 연결하면 프롬프트 캐시까지 동작합니다.- 공식 레퍼런스: AI SDK 문서 · OpenAI Compatible Providers
시작하기 전에 베이즈 API 키가 필요합니다. 인증 가이드에서 발급 방법을 확인해주세요.
설치
API 키를 설정합니다:
이 문서의 예제는
ai 7 버전 기준입니다.기본 사용법
baze('...')에는 GET /v1/gateway/models/가 반환하는 모델 ID를 그대로 넣습니다. gpt-6-sol, gemini-3.5-flash처럼 다른 계열 모델도 같은 프로바이더로 호출합니다.스트리밍
도구 호출
tool()에 zod 스키마로 입력을 정의합니다. stopWhen을 지정하면 도구 결과를 받아 최종 답변까지 이어서 생성합니다.Claude 모델: Anthropic 프로바이더
OpenAI 호환 경로로 Claude를 호출하면 프롬프트 캐시가 적용되지 않습니다. 같은 시스템 프롬프트나 긴 문서를 반복해서 보낸다면
@ai-sdk/anthropic으로 Gateway의 Anthropic 형식 경로를 사용하세요.cacheControl을 붙인 블록은 두 번째 호출부터 캐시 읽기로 처리됩니다. result.usage.inputTokenDetails의 cacheReadTokens에서 확인할 수 있습니다. streamText와 도구 호출도 이 프로바이더에서 동일하게 동작합니다.baseURL은 /v1/gateway/claude/v1까지 적어야 합니다. 프로바이더가 뒤에 /messages를 붙이므로, /v1/gateway/claude에서 끝나면 404 Not Found가 반환됩니다.주요 형식 세부사항
| 필드 | 값 |
|---|---|
createOpenAICompatible({ name }) | 프로바이더 이름. providerOptions의 키로 쓰입니다 (예: { baze: { ... } }) |
createOpenAICompatible({ baseURL }) | Gateway Base URL https://api.baze.co/v1/gateway (후행 슬래시 없음) |
createAnthropic({ baseURL }) | https://api.baze.co/v1/gateway/claude/v1 |
apiKey | 베이즈 API 키 |
참고
- 전체 오류 목록은 에러 레퍼런스를 참고하세요
- 일부 GPT 모델(예:
gpt-5.6-sol)은 OpenAI 호환 경로에서 도구 호출과reasoningEffort를 함께 받지 않아400 invalid_request_error가 반환됩니다. 두 기능을 함께 쓰려면 아래처럼@ai-sdk/openai를 설치하고createOpenAI로 연결하세요. 이 프로바이더는 Responses API(/v1/gateway/responses)를 호출합니다
마지막 수정 날짜: Oct 07, 2026