Claude API पर पहला अनुरोध: Key, Base URL और जाँच

1. अपनी BetterToken API Key बनाएँ

1. BetterToken Workspace में sign in करें।
2. Documentation में बताए Claude-compatible key group के लिए नई API Key बनाएँ।
3. Key को एक बार copy करके secret manager या Git से excluded local environment file में सुरक्षित रखें।
4. Current Model ID और availability की पुष्टि करने के लिए मौजूदा API documentation और pricing page खोलें।

Key को source code, prompt, screenshot, support message या public repository में paste न करें। BetterToken users अपने account और keys इस्तेमाल करते हैं; service Anthropic Console key जारी नहीं करती और shared Claude.ai account का access नहीं बेचती।

2. Anthropic-compatible endpoint इस्तेमाल करें

Anthropic SDK या Claude Code के लिए BetterToken Base URL है:

https://bettertoken.ai/

इस Base URL में /v1 न जोड़ें। Raw HTTP Messages request के लिए पूरा resource path अलग है:

POST https://www.bettertoken.ai/v1/messages

यह अंतर जरूरी है: SDK resource path खुद जोड़ते हैं, जबकि raw curl command को पूरा URL चाहिए। OpenAI-compatible tools दूसरा Base URL इस्तेमाल करते हैं और उन्हें अपनी setup guide का पालन करना चाहिए।

3. पहला request भेजें

BetterToken key को local environment variable में set करें। Variable का नाम Anthropic SDK convention के अनुसार है, लेकिन उसमें value आपकी BetterToken API Key ही रहती है।

export ANTHROPIC_API_KEY="your_api_key"
export ANTHROPIC_BASE_URL="https://bettertoken.ai"
export CLAUDE_MODEL_ID="YOUR_MODEL_ID"

curl --fail-with-body "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{
    \"model\": \"$CLAUDE_MODEL_ID\",
    \"max_tokens\": 64,
    \"messages\": [{\"role\": \"user\", \"content\": \"Return only the word pong.\"}]
  }"

दोनों placeholders को केवल अपनी local shell में replace करें। BetterToken Docs या pricing page से exact current Model ID लें; model names और availability बदल सकते हैं।

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

Successful request HTTP 200 और JSON message object लौटाती है। जाँचें:

• type की value message हो;
• content में model response हो;
• usage में input और output token counts हों।

Official Anthropic Messages reference protocol का shape बताती है। यह reference BetterToken की जारी key को Anthropic key नहीं बनाती; यह केवल compatible request और response format को document करती है।

इसके बाद BetterToken Workspace खोलें और request को समय के आधार पर match करें। Model, status, जहाँ लागू हो वहाँ input/output/cache tokens, और संबंधित cost की पुष्टि करें। Workspace usage metadata और billing records के लिए है; यह मानकर न चलें कि वहाँ पूरा prompt या response store होता है।

5. पहले request की आम errors ठीक करें

• 404 या गलत route: raw HTTP में /v1/messages चाहिए; केवल /messages अधूरा है।
• 400: anthropic-version, content-type, Model ID, max_tokens और messages array जाँचें।
• 401 या 403: BetterToken key, key group, Base URL और accidental whitespace जाँचें। Key support को न भेजें।
• 429: response body पढ़ें, बताए गए delay का पालन करें और retry से पहले concurrent requests तथा current limits जाँचें।
• Workspace record नहीं मिला: पुष्टि करें कि request ने environment में बचे किसी दूसरे provider के बजाय BetterToken Base URL इस्तेमाल किया था।

अगर shell में किसी दूसरे provider की values बची हैं, तो दोबारा शुरू करने से पहले उन्हें साफ करें:

unset ANTHROPIC_API_KEY
unset ANTHROPIC_BASE_URL
unset CLAUDE_MODEL_ID

फिर current BetterToken setup information से तीनों values दोबारा set करें और केवल एक request भेजें—retry loop नहीं।

अगला कदम

Minimal request सफल होने के बाद key को application के secret store में रखें, finite timeout set करें और केवल temporary failures के लिए bounded retries जोड़ें। Current BetterToken Docs देखें, फिर पहली वास्तविक integration test करते समय Workspace खुला रखें।