Clarifai Provider

Clarifai Provider

Clarifai는 AI 기반 애플리케이션을 구축, 배포, 확장하기 위한 플랫폼이에요. 컴퓨터 비전, 자연어 처리, 생성형 AI를 위한 도구와 API 모음을 제공해요. Clarifai는 풀스택 AI 개발 플랫폼을 통해 OpenAI 호환 API를 제공하므로, AI SDK를 사용해 강력한 AI 기능을 쉽게 통합할 수 있어요.

출처: 문서

본문

설정

Clarifai 프로바이더는 OpenAI API와 호환되므로 @ai-sdk/openai-compatible 모듈을 통해 사용할 수 있어요. 다음과 같이 설치할 수 있어요:

npm install @ai-sdk/openai-compatible

프로바이더 인스턴스

Clarifai를 사용하려면 @ai-sdk/openai-compatible의 createOpenAICompatible 함수로 커스텀 프로바이더 인스턴스를 만들 수 있어요:

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';

const clarifai = createOpenAICompatible({
  name: 'clarifai',
  baseURL: 'https://api.clarifai.com/v2/ext/openai/v1',
  apiKey: proces...PAT,
});

Clarifai 계정 설정에서 Personal Access Token(PAT)을 만들어 API 키를 얻을 수 있어요. CLARIFAI_PAT 환경 변수에 PAT를 설정하세요.

신규 사용자는 Clarifai에서 무료 계정으로 가입해 시작할 수 있어요.

언어 모델

프로바이더 인스턴스를 사용해 Clarifai에서 사용 가능한 다양한 대형 언어 모델(LLM)과 상호작용할 수 있어요. 예를 들어 강력한 오픈소스 언어 모델인 DeepSeek-R1을 사용하려면:

const model = clarifai.chatModel(
  'https://clarifai.com/deepseek-ai/deepseek-chat/models/DeepSeek-R1-0528-Qwen3-8B',
);

예시 - 텍스트 생성

generateText 함수로 Clarifai 언어 모델을 사용해 텍스트를 생성할 수 있어요:

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
import { generateText } from 'ai';

const clarifai = createOpenAICompatible({
  name: 'clarifai',
  baseURL: 'https://api.clarifai.com/v2/ext/openai/v1',
  apiKey: proces...PAT,
});

const model = clarifai.chatModel(
  'https://clarifai.com/deepseek-ai/deepseek-chat/models/DeepSeek-R1-0528-Qwen3-8B',
);

const { text, usage, finishReason } = await generateText({
  model,
  prompt: 'What is photosynthesis?',
});

console.log(text);
console.log('Token usage:', usage);
console.log('Finish reason:', finishReason);

예시 - 스트리밍 텍스트

streamText 함수로 Clarifai 모델의 텍스트 응답을 스트리밍할 수도 있어요:

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
import { streamText } from 'ai';

const clarifai = createOpenAICompatible({
  name: 'clarifai',
  baseURL: 'https://api.clarifai.com/v2/ext/openai/v1',
  apiKey: proces...PAT,
});

const model = clarifai.chatModel(
  'https://clarifai.com/deepseek-ai/deepseek-chat/models/DeepSeek-R1-0528-Qwen3-8B',
);

const result = streamText({
  model,
  prompt: 'What is photosynthesis?',
});

for await (const message of result.textStream) {
  console.log(message);
}

사용 가능한 전체 모델 목록은 Clarifai Model Gallery에서 참고할 수 있어요.

더 알아보기 (Learn more)