मुख्य सामग्री पर जाएं

ऐप्स में 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 टूल से बनाते हैं, Vault में स्टोर करते हैं, और ऐप के प्रोसेस कंपोनेंट में जोड़ते हैं।

सामान्य एंडपॉइंट्स

कार्यएंडपॉइंट
चैट या टेक्स्ट जनरेशन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 कुंजी को जोड़ना

  1. ऐप के लिए एक स्कोप्ड Kazzle API कुंजी बनाएँ।
  2. इसे एक सीक्रेट कलेक्शन + एनवायरनमेंट में KAZZLE_API_KEY नाम से स्टोर करें (सीक्रेट नाम env var कुंजी बन जाता है)।
  3. प्रोसेस कंपोनेंट को उस कलेक्शन + एनवायरनमेंट की ओर इंगित करें।
  4. कॉल्स को सर्वर-साइड रखें जब तक एंडपॉइंट आपके अपने बैकएंड के माध्यम से जानबूझकर सार्वजनिक न हो।
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
सर्वर प्रोसेस रनटाइम पर Vault से process.env.KAZZLE_API_KEY को रिज़ॉल्व देखेगा। कोई env.vars फील्ड नहीं है — सीक्रेट्स केवल उस कलेक्शन + एनवायरनमेंट के माध्यम से ऐप कंपोनेंट्स तक पहुँचते हैं जिसकी ओर वे इंगित करते हैं। कभी भी एक निजी API कुंजी को फ्रंटएंड कोड या VITE_* वेरिएबल में न रखें।