> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kazzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI API

> यूनिवर्सल AI कॉल — चैट, इमेज, स्पीच, ट्रांसक्रिप्शन, वीडियो — आपके Space के विरुद्ध बिल किए गए।

Kazzle AI API आपको किसी भी मॉडल को कॉल करने के लिए एक प्रमाणित एंडपॉइंट देता है जिसे हम सपोर्ट करते हैं। आप एक बार क्रेडिट में भुगतान करते हैं, अपने Space के विरुद्ध — OpenAI, Anthropic, Cloudflare Workers AI, या किसी और के लिए अलग खाते नहीं जिन्हें हम रूट करते हैं।

सभी एंडपॉइंट `https://api.kazzle.app` पर `/ai/*` के तहत रहते हैं और `Authorization` हेडर में `kzl_` API कुंजी स्वीकार करते हैं। एक बनाने के तरीके के लिए [API keys](/platform/api-keys) देखें।

जेनरेट किए गए Kazzle ऐप्स को भी इस API का उपयोग करना चाहिए — कंपोनेंट में कुंजी को वायर करने के लिए [AI in apps](/apps/ai-api) देखें। जब तक उपयोगकर्ता स्पष्ट रूप से अपने स्वयं के प्रदाता खाते का उपयोग करना नहीं चाहते, तब तक उनसे प्रदाता कुंजियों के लिए न पूछें।

## क्षमताएं

| एंडपॉइंट                        | मोडैलिटी                  | मानकीकृत इनपुट                              | मानकीकृत आउटपुट                                |
| ------------------------------- | ------------------------- | ------------------------------------------- | ---------------------------------------------- |
| `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`              | Raw पास-थ्रू              | कोई भी Workers AI / प्रदाता-नेटिव पेलोड     | Raw अपस्ट्रीम प्रतिक्रिया                      |
| `GET  /ai/models`               | कैटलॉग                    | —                                           | `{ models: [{ id, modality, pricing, ... }] }` |

`GET /ai/models` यह सत्य का स्रोत है कि कौन सी मॉडल ids किस एंडपॉइंट पर काम करती हैं। यदि आप API के विरुद्ध निर्माण कर रहे हैं तो पहले इसे पढ़ें।

## कॉल कैसे काम करता है

प्रत्येक बिल योग्य कॉल पाँच चरणों से गुजरता है। आप इनमें से अधिकांश नहीं देखते — वे सर्वर-साइड ट्रैक किए जाते हैं ताकि हम विफल कॉल को रिफंड कर सकें और सटीक उपयोग की रिपोर्ट कर सकें।

| चरण        | क्या हुआ                                                                                                                        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `open`     | हमने आपके अनुरोध से जुड़ी एक बिलिंग इवेंट बनाई है, लेकिन अभी तक अपस्ट्रीम को कॉल नहीं किया है।                                  |
| `recorded` | अपस्ट्रीम प्रदाता ने प्रतिक्रिया दी। हमारे पास Cloudflare AI Gateway से एक लॉग id है। लागत अभी तक ज्ञात नहीं है।                |
| `priced`   | Cloudflare ने अंतिम लागत की रिपोर्ट की। हमने अपना मार्कअप लागू किया और क्रेडिट चार्ज लिखा। टर्मिनल।                             |
| `failed`   | अपस्ट्रीम कॉल विफल हुई, या हम 20 पुनः प्रयासों के बाद लागत नहीं प्राप्त कर सके। ग्राहक को **चार्ज नहीं** किया जाता है। टर्मिनल। |
| `synced`   | priced इवेंट को हमारी मीटरिंग सिस्टम में डिलीवर किया गया है।                                                                    |

प्रत्येक सफल प्रतिक्रिया में `x-kazzle-ai-billing-event-id: airesp_...` शामिल है — यदि आप बाद में उपयोग निर्यात के साथ अनुरोध को सहसंबंधित करना चाहते हैं तो इसे रखें।

## बिलिंग और मार्कअप

हम `cloudflare_cost_usd × (1 + markup)` चार्ज करते हैं। मार्कअप [Settings → Billing → Pricing](/platform/billing#pricing) में प्रकाशित है। कॉल जो Cloudflare ने \$0 पर मूल्य निर्धारित किए (मुफ्त Workers AI टियर, प्रोमो) `priced` चरण तक शून्य लागत के साथ पहुंचते हैं और कभी बिल नहीं किए जाते हैं।

रिजर्व: कॉल करने के लिए आपके पास कम से कम **\$0.50** के बराबर क्रेडिट होने चाहिए। हम इसे आपके बैलेंस के विरुद्ध रखते हैं जब तक कॉल समाप्त नहीं हो जाता, फिर वास्तविक लागत का निपटान करते हैं।

## त्रुटियां

| स्थिति             | अर्थ                                                                                    |
| ------------------ | --------------------------------------------------------------------------------------- |
| `401`              | लापता या अमान्य `kzl_` API कुंजी।                                                       |
| `402`              | रिजर्व के लिए अपर्याप्त क्रेडिट। **Settings → Billing** में टॉप अप करें।                |
| `4xx` अपस्ट्रीम से | जैसे-तैसे फॉरवर्ड किया गया। बॉडी में प्रदाता की त्रुटि है। ग्राहक को चार्ज नहीं किया जा |