앱의 AI API

Kazzle 앱은 채팅, 이미지, 음성, 음성 인식, 비디오를 위해 Kazzle의 AI API를 사용해야 합니다. 사용자가 OpenAI, Anthropic 또는 다른 제공자에 직접 청구하기를 원하지 않는 한 해당 제공자의 키를 요청하지 마세요.

사용할 항목

모든 앱 AI 호출은 https://api.kazzle.app과 kzl_ API 키를 통해 이루어집니다:

const apiUrl = 'https://api.kazzle.app';
const apiKey = process.env.KAZZLE_API_KEY;

if (!apiKey) {
  throw new Error('KAZZLE_API_KEY is required');
}

const response = await fetch(`${apiUrl}/ai/audio/transcriptions`, {
  method: 'POST',
  headers: { Authorization: `Bearer ${apiKey}` },
  body: formData,
});

KAZZLE_API_KEY는 api_key 도구로 생성하고, 볼트에 저장하고, 앱의 프로세스 컴포넌트에 연결하는 앱 자격증명입니다.

일반적인 엔드포인트

작업	엔드포인트
채팅 또는 텍스트 생성	`POST /ai/chat/completions`
이미지	`POST /ai/images/generations`
텍스트 음성 변환	`POST /ai/audio/speech`
음성 텍스트 변환	`POST /ai/audio/transcriptions`
비디오 생성	`POST /ai/video/generations`
모델 카탈로그	`GET /ai/models`

앱이 동적으로 모델을 선택해야 할 때 먼저 /ai/models를 읽으세요.

API 키 연결

앱용 범위가 지정된 Kazzle API 키를 생성합니다.
KAZZLE_API_KEY 이름으로 시크릿 컬렉션 + 환경에 저장합니다(시크릿 이름이 환경 변수 키가 됨).
프로세스 컴포넌트가 해당 컬렉션 + 환경을 가리키도록 설정합니다.
엔드포인트가 자신의 백엔드를 통해 의도적으로 공개되지 않는 한 호출을 서버 측에 유지합니다.

export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});

서버 프로세스는 런타임에 볼트에서 확인된 process.env.KAZZLE_API_KEY를 볼 수 있습니다. env.vars 필드는 없으며, 시크릿은 가리키는 컬렉션 + 환경을 통해서만 앱 컴포넌트에 도달합니다. 프론트엔드 코드나 VITE_* 변수에 개인 API 키를 절대 넣지 마세요.

​앱의 AI API

​사용할 항목

​일반적인 엔드포인트

​API 키 연결

앱의 AI API

사용할 항목

일반적인 엔드포인트

API 키 연결