← Back to Home

Getting Started with AIKit

AIKit을 사용하여 단 몇 줄의 코드로 여러 AI 제공자를 통합할 수 있습니다.

설치

CDN 사용 (가장 빠름)

<script src="https://cdn.jsdelivr.net/gh/lukaPlayground/aikit@latest/dist/aikit.min.js"></script>

NPM 설치

npm install @lukaplayground/aikit

직접 다운로드

GitHub Releases에서 최신 버전을 다운로드하세요.

기본 사용법

1. 간단한 예제

<!DOCTYPE html>
<html>
<head>
    <script src="https://cdn.jsdelivr.net/gh/lukaPlayground/aikit@latest/dist/aikit.min.js"></script>
</head>
<body>
    <script>
        const ai = new AIKit({
            provider: 'openai',
            apiKey: 'your-openai-api-key'
        });

        ai.chat('Hello, AI!').then(response => {
            console.log(response.text);
        });
    </script>
</body>
</html>

2. 멀티 프로바이더 설정

여러 AI 제공자를 설정하고 자동 폴백을 활성화할 수 있습니다:

const ai = new AIKit({
    providers: [
        { name: 'openai', apiKey: 'key1', priority: 1 },
        { name: 'claude', apiKey: 'key2', priority: 2 },
        { name: 'gemini', apiKey: 'key3', priority: 3 }
    ],
    autoFallback: true  // 자동으로 다음 제공자로 전환
});

3. 응답 검증

QA 기능을 활용한 응답 검증:

const response = await ai.chat('파이썬에 대해 설명해주세요', {
    validate: {
        minLength: 100,
        maxLength: 1000,
        mustInclude: ['파이썬', '프로그래밍'],
        language: 'korean'
    }
});

4. 비용 추적

API 사용 비용을 실시간으로 추적:

const ai = new AIKit({
    provider: 'openai',
    apiKey: 'your-key',
    enableCostTracking: true
});

await ai.chat('Hello');

const report = ai.getCostReport();
console.log(report);
// {
//   total: "0.0023",
//   totalUSD: "$0.0023",
//   byProvider: { openai: "$0.0023" },
//   ...
// }

5. 캐싱 활용

중복 요청을 방지하여 비용 절감:

const ai = new AIKit({
    provider: 'openai',
    apiKey: 'your-key',
    enableCache: true
});

// 첫 번째 요청 - API 호출
await ai.chat('2+2는?');

// 같은 질문 - 캐시에서 반환 (비용 없음)
await ai.chat('2+2는?');

주요 옵션

AIKit 생성자 옵션

new AIKit({
    // 필수
    provider: 'openai',
    apiKey: 'your-key',

    // 선택사항
    enableCache: true,
    enableCostTracking: true,
    maxRetries: 3,
    timeout: 30000,
    autoFallback: false,

    // 멀티 프로바이더
    providers: [...]
});

chat() 메서드 옵션

ai.chat('your message', {
    model: 'gpt-4',
    temperature: 0.7,
    maxTokens: 1000,
    
    validate: {
        minLength: 10,
        maxLength: 1000,
        mustInclude: ['keyword'],
        format: 'json',
        language: 'korean'
    },
    
    skipCache: false
});
💡 Tip: 인터랙티브 플레이그라운드에서 직접 테스트해보세요!

제공자별 특징

OpenAI (GPT)

Claude (Anthropic)

Gemini (Google)

유틸리티 메서드

// 통계 확인
const stats = ai.getStats();

// 비용 리포트
const cost = ai.getCostReport();

// 캐시 초기화
ai.clearCache();

// 설정 업데이트
ai.updateConfig({ provider: 'claude' });

문제 해결

API 키 오류

Error: API key is required
해결: API 키가 올바르게 설정되었는지 확인하세요.

네트워크 오류

Error: Network error: Unable to reach API endpoint
해결: 인터넷 연결을 확인하세요. CORS 문제일 수도 있습니다.

검증 실패

Error: Validation failed
해결: validate 옵션의 제약 조건을 조정하세요.

다음 단계