शुरुआत
प्रमाणीकरण
sk-api14 API कुंजी को Bearer टोकन के रूप में भेजकर api14 पर प्रमाणित करें। कुंजी बनाना, सुरक्षित रखना और त्रुटियाँ ठीक करना यहाँ जानें।
हर metered endpoint पर की गई request एक api14 API key से authenticate होती है, जो Authorization header में Bearer token के रूप में भेजी जाती है।
Authorization: Bearer sk-api14-...
OpenAI SDK यह header आपके लिए apiKey / api_key विकल्प से अपने-आप सेट कर देते हैं।
API keys
Keys को API keys में बनाएँ और मैनेज करें।
- Keys
sk-api14-से शुरू होती हैं और सिर्फ़ एक बार, बनाते समय, दिखाई जाती हैं। केवल उनका hash स्टोर होता है, इसलिए खोई हुई key वापस नहीं मिल सकती, नई key बनाएँ और पुरानी को revoke करें। - हर key की अपनी requests-per-minute सीमा, दैनिक USD खर्च सीमा और मॉडल allowlist हो सकती है। देखें Rate limits।
- आप कितनी keys रख सकते हैं, यह आपके प्लान पर निर्भर है: Free पर 1, Pro पर 10, Team और Enterprise पर इससे ज़्यादा।
- Key को revoke करना तुरंत लागू होता है; उससे की गई requests
401 invalid_api_keyलौटाती हैं।
Key का इस्तेमाल
Key को किसी environment variable में रखें और कोड में वहीं से पढ़ें:
export API14_API_KEY="sk-api14-..."
curl https://api14.com/api/v1/chat/completions \
-H "Authorization: Bearer $API14_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "openai/gpt-5-mini", "messages": [{"role": "user", "content": "Hello"}]}'
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api14.com/api/v1",
apiKey: process.env.API14_API_KEY,
});
const result = await client.chat.completions.create({
"model": "openai/gpt-5-mini",
"messages": [
{
"role": "user",
"content": "Explain vector databases in two sentences."
}
]
});
console.log(result.choices[0].message.content);
बिना key वाले endpoints
ये read-only कैटलॉग endpoints बिना authentication के काम करते हैं:
| Endpoint | विवरण |
|---|---|
GET /models | सभी उपलब्ध मॉडल |
GET /models/{id} | एक मॉडल |
GET /images/models | इमेज मॉडल, उनके अतिरिक्त पैरामीटर के साथ |
GET /videos/models | वीडियो मॉडल, resolutions और अवधियों के साथ |
GET /embeddings/models | Embedding मॉडल |
बाकी सब कुछ, generation endpoints, /credits, /key, /generation और वीडियो job का status, के लिए key ज़रूरी है।
Authentication त्रुटियाँ
गायब, गलत फ़ॉर्मैट वाली या revoke की गई key यह लौटाती है:
{
"error": {
"message": "Missing or invalid API key. Use \"Authorization: Bearer sk-api14-…\".",
"type": "authentication_error",
"code": "invalid_api_key"
}
}
HTTP status 401 के साथ। जिस key पर allowlist लगी है, वह दूसरे मॉडलों के लिए 403 model_not_allowed लौटाती है। देखें त्रुटियाँ।
Keys को सुरक्षित रखना
- Key को कभी भी ब्राउज़र या मोबाइल ऐप के कोड में न रखें, वहाँ कोई भी उसे पढ़ सकता है। api14 को अपने सर्वर से कॉल करें।
- Keys को कभी source control में commit न करें। Environment variables या किसी secret manager का इस्तेमाल करें।
- हर ऐप या environment के लिए अलग key रखें, ताकि आप एक को revoke करें तो बाकी न टूटें।
- Scripts या कम भरोसेमंद सेवाओं में इस्तेमाल होने वाली keys पर दैनिक USD सीमा लगाएँ, ताकि कोई bug आपका बैलेंस खाली न कर दे।
- अगर कोई key लीक हो जाए, तो उसे तुरंत API keys में revoke करें।