API रेफरेंस
apikey.sh OpenAI प्रोटोकॉल पर चलता है। जो भी SDK, फ्रेमवर्क या टूल पहले से OpenAI के साथ काम करता है, वह यहाँ base_url बदलते ही काम करेगा।क्विकस्टार्ट
डैशबोर्ड में key बनाएँ, उसे एनवायरनमेंट वेरिएबल में रखें, फिर base URL सेट करें:from openai import OpenAI
client = OpenAI(
api_key="sk-ak-...", # your key from apikey.sh
base_url="https://apikey.sh/v1", # change only this line
)
resp = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)Base URL
नीचे दिए हर डोमेन पर एक ही API key चलती है — जो पसंद हो चुनें।Anthropic SDK बिना /v1 वाला base URL इस्तेमाल करता है (जैसे https://apikey.sh)।
https://apikey.sh/v1लाइवhttps://api.onie.net/v1लाइवऑथेंटिकेशन
अपनी key हेडर में भेजें:
Authorization: Bearer sk-ak-... # or, with the Anthropic SDK: x-api-key: sk-ak-...key सिर्फ बनाते समय एक बार दिखती है। खो जाए तो नई बनाएँ और पुरानी रिवोक करें — रिवोक तुरंत लागू होता है।
Endpoints
| POST | /v1/chat/completions | Completions जनरेट करें (SSE streaming और tool calling सपोर्टेड) |
| POST | /v1/embeddings | RAG और सिमैंटिक सर्च के लिए embeddings बनाएँ |
| POST | /v1/images/generations | इमेज जनरेट करें (gpt-image-* मॉडल) |
| GET | /v1/models | मौजूदा key के लिए उपलब्ध मॉडल लिस्ट करें |
Streaming
SSE पर रियल-टाइम token पाने के लिए stream: true जोड़ें:
stream = client.chat.completions.create(
model="claude-sonnet-5",
messages=[{"role": "user", "content": "Write a short poem"}],
stream=True,
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")Prompt caching
सपोर्टेड मॉडल (GPT-5.x सीरीज़) पर आपके prompt का दोहराया गया prefix अपने आप कैश होता है और कैश रेट पर बिल होता है — नए token से करीब 90% सस्ता। कोड में कुछ बदलने की ज़रूरत नहीं; कैश किए गए token डैशबोर्ड में Usage के नीचे दिखते हैं।रिस्पॉन्स में usage.prompt_tokens_details.cached_tokens आता है, ताकि आप खुद मिलान कर सकें।
प्रति key लिमिट
हर key की अपनी खर्च सीमा और अनुमत मॉडल लिस्ट हो सकती है। प्रोजेक्ट या टीम में key शेयर करने का यही सुरक्षित तरीका है, ताकि कोई एक पूरा बजट खत्म न कर दे। इसे Dashboard → API keys में सेट करें।
एरर कोड
401 | अमान्य key, रिवोक की गई key, या अकाउंट सस्पेंड |
402 | क्रेडिट खत्म — डैशबोर्ड में टॉप-अप करें |
403 | यह मॉडल इस key की अनुमत लिस्ट में नहीं है |
429 | key की रेट लिमिट पार हो गई |
5xx | अपस्ट्रीम प्रोवाइडर एरर — कुछ सेकंड बाद फिर कोशिश करें |