API संदर्भ¶

Claudin.io एक OpenAI-संगत API है। यदि आपने OpenAI API का उपयोग किया है, तो यहाँ सब कुछ परिचित है — बस Claudin.io बेस URL पर इंगित करें और claudinio मॉडल का उपयोग करें।

बेस URL¶

https://api.claudin.io

OpenAI-शैली के रूट /v1 के अंतर्गत आते हैं।

प्रमाणीकरण¶

अपनी API कुंजी प्रत्येक अनुरोध के साथ भेजें, हेडर में से किसी एक के रूप में:

Authorization: Bearer YOUR_API_KEY

x-api-key: YOUR_API_KEY

मॉडल¶

मॉडल आईडी	संदर्भ विंडो
`claudinio`	256K टोकन

हर जगह claudinio का उपयोग करें। (कुछ क्लाइंट provider/model फॉर्म की अपेक्षा करते हैं — उनके लिए, claudinio/claudinio का उपयोग करें।)

एंडपॉइंट्स¶

विधि और पथ	विवरण
`POST /v1/chat/completions`	चैट पूर्णताएँ — प्राथमिक एंडपॉइंट
`POST /v1/completions`	पुरानी टेक्स्ट पूर्णताएँ
`POST /v1/messages`	Anthropic मैसेजेस फॉर्मेट
`POST /v1/responses`	प्रतिक्रिया API (Codex)
`POST /v1/embeddings`	टेक्स्ट एम्बेडिंग
`GET /v1/models`	उपलब्ध मॉडलों की सूची

चैट पूर्णताएँ¶

curl https://api.claudin.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "claudinio",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Write a haiku about proxies."}
    ],
    "temperature": 0.7
  }'

मानक OpenAI पैरामीटर समर्थित हैं: messages, temperature, top_p, max_tokens, stream, stop, tools / tool_choice (फ़ंक्शन कॉलिंग), response_format, इत्यादि।

स्ट्रीमिंग¶

"stream": true सेट करें ताकि OpenAI स्ट्रीमिंग फॉर्मेट में सर्वर-सेंट इवेंट प्राप्त हो सकें (data: {...} चंक्स data: [DONE] द्वारा समाप्त)।

टूल / फ़ंक्शन कॉलिंग¶

claudinio टूल कॉल का समर्थन करता है। tools पास करें और प्रतिक्रिया से tool_calls वापस पढ़ें, बिल्कुल OpenAI API की तरह। यही इसे Claude Code, Kilo और Cursor जैसे एजेंटिक एडिटरों के अंदर काम करने योग्य बनाता है।

मल्टीमॉडल इनपुट¶

claudinio एक टेक्स्ट मॉडल है, लेकिन Claudin.io पारदर्शी रूप से इमेज, ऑडियो और वीडियो ब्लॉक को संभालता है: यदि आप उन्हें भेजते हैं, तो प्रॉक्सी मॉडल द्वारा देखने से पहले उन्हें टेक्स्ट विवरण/प्रतिलेखन में परिवर्तित कर देता है। आपको कुछ विशेष करने की आवश्यकता नहीं है — मानक OpenAI कंटेंट ब्लॉक भेजें और यह काम करता है।

त्रुटियाँ¶

त्रुटियाँ OpenAI त्रुटि आकार का अनुसरण करती हैं:

{ "error": { "message": "…", "type": "…", "code": "…" } }

स्थिति	अर्थ	क्या करें
`401`	अमान्य या गुम API कुंजी	कुंजी और प्रमाणीकरण हेडर की जाँच करें
`403`	एंडपॉइंट की अनुमति नहीं है	समर्थित `/v1/*` पथों में से एक का उपयोग करें
`429`	बजट सीमा पूरी हुई या दर-सीमित	विंडो रीसेट की प्रतीक्षा करें या अपग्रेड करें
`400`	गलत संरचना वाला अनुरोध	अपने JSON / पैरामीटर की जाँच करें
`5xx`	अपस्ट्रीम/प्रदाता की रुकावट	बैकऑफ़ के साथ पुनः प्रयास करें

प्रदाता विवरण डिज़ाइन द्वारा छिपाए गए हैं

त्रुटि संदेशों को साफ किया जाता है ताकि वे अंतर्निहित मॉडल प्रदाता को लीक न करें। आपको हमेशा Claudin.io-ब्रांडेड, OpenAI-आकार की त्रुटियाँ दिखाई देंगी।

बजट सीमा पूरी होना¶

जब आप वर्तमान विंडो की व्यय सुरक्षा समाप्त कर देते हैं, तो अनुरोध बजट त्रुटि (आमतौर पर 429) लौटाते हैं। आपका डैशबोर्ड सटीक रीसेट समय और शेष बजट दिखाता है। विंडो कैसे काम करती हैं, इसके लिए योजनाएँ और सीमाएँ देखें।

दर सीमाएँ¶

Claudin.io सामान्य उपयोग को हार्ड-ब्लॉक नहीं करता है। दुरुपयोगकारी अनुरोध दरों को अस्वीकार करने के बजाय धीमा किया जाता है (पारदर्शी थ्रॉटल), ताकि अच्छे व्यवहार वाले क्लाइंट कभी दंडित न हों। व्यवहार में आपको कुछ करने की आवश्यकता नहीं है — बस दुर्लभ 429 पर पुनः प्रयास करें।