AI कोडिंग

AI APIs: Protocol, API Key और पहला अनुरोध

सही AI API protocol चुनें, key सुरक्षित रखें, minimal request भेजें और response, routing व usage record को verify करें।

BetterToken

संपादकीय टीम

5 अग॰ 20265 मिनट पढ़ने में

किसी AI API को connect करने से पहले यह पहचानें कि आपका client कौन-सा contract चाहता है: OpenAI-compatible या Anthropic-compatible। फिर provider का documented Base URL इस्तेमाल करें, API Key को source code से बाहर रखें, एक छोटी request भेजें और response के साथ उसका usage record भी verify करें। Settings screen का सफलतापूर्वक save होना यह साबित नहीं करता कि request सही endpoint तक पहुँची।

अगर आपको vendor-specific web subscription के बजाय API gateway चाहिए, तो BetterToken AI API overview से शुरू करें। BetterToken अलग OpenAI-compatible और Anthropic-compatible interfaces देता है। आप अपना BetterToken account और अपनी API Key ही इस्तेमाल करते हैं; यह key OpenAI या Anthropic Console key नहीं है।

API access, web subscription और shared account

ये अलग-अलग products हैं:

Access path	आपको क्या मिलता है	इससे क्या साबित नहीं होता
API access	अपनी key से authenticated HTTP requests	Vendor की consumer chat subscription का access
Web subscription	किसी खास product interface और उसकी included limits	Transfer की जा सकने वाली API balance या third-party API Key
Shared account	किसी और का login session	सुरक्षित या production के योग्य integration

सामान्य development में वही account और key इस्तेमाल करें जिन पर आपका control हो। खरीदे हुए या shared login पर integration न बनाएँ।

1. Client के आधार पर protocol चुनें

Model चुनने से पहले client या SDK की documentation पढ़ें। Tool अगर OpenAI SDK, Chat Completions, Responses API या OPENAI_BASE_URL जैसे field की अपेक्षा करता है, तो OpenAI-compatible protocol चुनें। अगर वह Messages requests बनाता है और ANTHROPIC_BASE_URL या x-api-key चाहता है, तो Anthropic-compatible protocol चुनें।

Model का नाम protocol तय नहीं करता। Client को वही request contract बनाना आना चाहिए जिसे endpoint स्वीकार करता है।

BetterToken के Base URLs:


OpenAI-compatible Base URL:  https://www.bettertoken.ai/v1
Anthropic-compatible Base URL: https://bettertoken.ai/

OpenAI-compatible value में /v1 पहले से शामिल है। Anthropic-compatible value में नहीं है; raw Messages request पूरा resource path /v1/messages इस्तेमाल करती है।

2. Base URL और request path में अंतर समझें

SDK या tool आम तौर पर Base URL माँगता है और resource path खुद जोड़ता है। Direct HTTP call के लिए पूरा path चाहिए।


OpenAI-compatible raw path:  https://www.bettertoken.ai/v1/chat/completions
Anthropic Messages raw path: https://www.bettertoken.ai/v1/messages

जिस field में केवल Base URL अपेक्षित हो, उसमें पूरा request path paste न करें। वरना client resource को दोबारा जोड़ सकता है और 404 लौटा सकता है।

3. API Key को code से बाहर रखें

पहले local test के लिए environment variables इस्तेमाल करें, फिर production credentials को अपनी platform के secret manager में ले जाएँ।


export BETTERTOKEN_API_KEY="your_api_key_here"
export BETTERTOKEN_MODEL_ID="your_current_model_id"

Real key को source code, .env.example, prompt, issue, screenshot या support message में कभी न डालें। Marketing name से अंदाजा लगाने के बजाय provider documentation या model catalog से current exact Model ID copy करें।

4. Minimal OpenAI-compatible request भेजें

Streaming या tools enable करने से पहले छोटी text-only request इस्तेमाल करें:


curl https://www.bettertoken.ai/v1/chat/completions \
  -H "Authorization: Bearer $BETTERTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$BETTERTOKEN_MODEL_ID"'",
    "messages": [{"role": "user", "content": "Reply with API_OK"}],
    "max_tokens": 16
  }'

दूसरों के साथ share किए जाने वाले logs में curl -v न चलाएँ, क्योंकि verbose output sensitive headers दिखा सकता है।

5. Minimal Anthropic-compatible request भेजें

Messages request में authentication header और body structure अलग होता है:


curl https://www.bettertoken.ai/v1/messages \
  -H "x-api-key: $BETTERTOKEN_API_KEY" \
  -H "anthropic-version: CURRENT_SUPPORTED_VERSION" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$BETTERTOKEN_MODEL_ID"'",
    "max_tokens": 16,
    "messages": [{"role": "user", "content": "Reply with API_OK"}]
  }'

CURRENT_SUPPORTED_VERSION एक placeholder है। Test से पहले API reference में currently supported header की पुष्टि करें। अगर आपका task खास तौर पर Claude-compatible access से जुड़ा है, तो minimal request पर लौटने से पहले Claude API setup और access boundaries पढ़ें।

6. Response और usage record verify करें

पहला test तभी पूरा है जब ये signals एक-दूसरे से मेल खाएँ:

HTTP status success दिखाए;
response में expected Model ID या उसका documented display value हो;
चुने गए contract में expected content और usage fields मिलें;
BetterToken Workspace में उसी समय का record दिखे, जिसमें model, status, लागू input/output/cache tokens और charge हों।

Workspace usage और billing record है। यह मानकर न चलें कि उसमें पूरा prompt या response body store होता है। Availability और pricing के लिए dynamic list को integration notes में copy करने के बजाय current model catalog देखें।

7. Response layer के अनुसार troubleshooting करें

401 या 403: key, key group, whitespace, Base URL और चुने गए protocol के authentication header को जाँचें।
404: Base URL को full path से compare करें। Duplicated /v1, /chat/completions या /messages खोजें।
model not found: current exact Model ID copy करें और पुष्टि करें कि वह चुने गए key group तथा protocol के लिए available है।
429: response body पढ़ें, दिए गए retry delay का पालन करें और एक और request भेजने से पहले current concurrency या rate limits जाँचें।
Timeout या TLS error: local proxy, firewall, DNS और certificate conditions को API response से अलग जाँचें। TLS verification को स्थायी रूप से disable न करें।
Workspace record नहीं मिला: सुनिश्चित करें कि कोई पुराना environment variable request को दूसरे provider पर route नहीं कर रहा था।

Configuration बदलने के बाद एक छोटी request फिर भेजें और उसे Workspace record से match करें। यह काम करने लगे तो streaming, tools, longer context या agent loop को एक-एक layer करके जोड़ें, ताकि हर नई failure का diagnostic surface छोटा रहे।

अगला कदम: OpenAI-compatible API

अपनी key और OpenAI-compatible route के साथ practical setup के लिए OpenAI API page देखें। यह BetterToken की compatible API बताती है, official OpenAI key नहीं।

अपना LLM वर्कफ़्लो बेहतर बनाना चाहते हैं?

एक API से मॉडल जोड़ें, कुंजियाँ प्रबंधित करें और AI खर्च नियंत्रित करें।