https://api.kazzle.app पर /ai/* के तहत रहते हैं और Authorization हेडर में kzl_ API कुंजी स्वीकार करते हैं। एक बनाने के तरीके के लिए API कुंजियाँ देखें।
जेनरेट किए गए Kazzle ऐप्स को भी इस API का उपयोग करना चाहिए। ऐप के लिए एक Kazzle API कुंजी बनाएं, इसे वॉल्ट में स्टोर करें, इसे प्रोसेस कंपोनेंट पर KAZZLE_API_KEY के रूप में वायर करें, और उस सर्वर-साइड कोड से https://api.kazzle.app/ai/* को कॉल करें। जब तक वे स्पष्ट रूप से अपना प्रदाता खाता उपयोग करना नहीं चाहते, तब तक उपयोगकर्ताओं से प्रदाता कुंजियों के लिए न पूछें।
क्षमताएं
| एंडपॉइंट | मोडैलिटी | मानकीकृत इनपुट | मानकीकृत आउटपुट |
|---|---|---|---|
POST /ai/chat/completions | चैट (टेक्स्ट, स्ट्रीमिंग) | OpenAI-संगत messages[] | OpenAI-संगत choices[] या SSE स्ट्रीम |
POST /ai/responses | Responses API | OpenAI Responses-संगत | OpenAI Responses-संगत |
POST /ai/images/generations | इमेज | { model, prompt, size?, output_format? } | { images: [{ url? | b64?, mimeType }] } |
POST /ai/audio/speech | टेक्स्ट-टू-स्पीच | { model, text, voice?, format? } | audio/* बाइट स्ट्रीम |
POST /ai/audio/transcriptions | स्पीच-टू-टेक्स्ट | multipart/form-data with file + model | { text } |
POST /ai/video/generations | वीडियो (async) | { model, prompt, ... } | { id, status, pollUrl } |
GET /ai/responses/{id} | Async पोल | response id | प्रदाता-आकार का परिणाम |
POST /ai/gateway | कच्चा पास-थ्रू | कोई भी Workers AI / प्रदाता-मूल पेलोड | कच्चा अपस्ट्रीम प्रतिक्रिया |
GET /ai/models | कैटलॉग | — | { models: [{ id, modality, pricing, ... }] } |
GET /ai/models यह सत्य का स्रोत है कि कौन सी मॉडल आईडी किस एंडपॉइंट पर काम करती है। यदि आप API के विरुद्ध निर्माण कर रहे हैं तो पहले इसे पढ़ें।
कॉल कैसे काम करता है
प्रत्येक बिल योग्य कॉल पाँच चरणों से गुजरता है। आप इनमें से अधिकांश नहीं देखते — वे सर्वर-साइड ट्रैक किए जाते हैं ताकि हम विफल कॉल को रिफंड कर सकें और सटीक उपयोग की रिपोर्ट कर सकें।| चरण | क्या हुआ |
|---|---|
open | हमने आपके अनुरोध से जुड़ी एक बिलिंग इवेंट बनाई है, लेकिन अभी तक अपस्ट्रीम को कॉल नहीं किया है। |
recorded | अपस्ट्रीम प्रदाता ने प्रतिक्रिया दी। हमारे पास Cloudflare AI Gateway से एक लॉग आईडी है। लागत अभी तक ज्ञात नहीं है। |
priced | Cloudflare ने अंतिम लागत की रिपोर्ट की। हमने अपना मार्कअप लागू किया और क्रेडिट चार्ज लिखा। टर्मिनल। |
failed | अपस्ट्रीम कॉल विफल हुई, या हम 20 पुनः प्रयासों के बाद लागत नहीं प्राप्त कर सके। ग्राहक को चार्ज नहीं किया जाता है। टर्मिनल। |
synced | मूल्य निर्धारित इवेंट हमारी मीटरिंग सिस्टम को वितरित किया गया है। |
x-kazzle-ai-billing-event-id: airesp_... शामिल है — यदि आप बाद में उपयोग निर्यात के साथ अनुरोध को सहसंबंधित करना चाहते हैं तो इसे रखें।
बिलिंग और मार्कअप
हमcloudflare_cost_usd × (1 + markup) चार्ज करते हैं। मार्कअप Settings → Billing → Pricing में प्रकाशित है। कॉल जो Cloudflare ने $0 पर मूल्य निर्धारित किए (मुफ्त Workers AI टियर, प्रोमो) priced चरण तक शून्य लागत के साथ पहुंचते हैं और कभी भी बिल नहीं किए जाते हैं।
रिजर्व: कॉल करने के लिए आपके पास कम से कम $0.50 समकक्ष क्रेडिट होना चाहिए। हम इसे कॉल समाप्त होने तक आपके बैलेंस के विरुद्ध रखते हैं, फिर वास्तविक लागत का निपटान करते हैं।
त्रुटियाँ
| स्थिति | अर्थ |
|---|---|
401 | लापता या अमान्य kzl_ API कुंजी। |
402 | रिजर्व के लिए अपर्याप्त क्रेडिट। Settings → Billing में टॉप अप करें। |
4xx अपस्ट्रीम से | जैसा है वैसा ही अग्रेषित। बॉडी में प |