CheapTokens के साथ आपका पहला API अनुरोध

यह गाइड आपको एक नए खाते से एक काम करने वाले अनुरोध तक ले जाती है। आपको एक ईमेल पता, थोड़ा बैलेंस और एक टर्मिनल चाहिए। API OpenAI-संगत है, इसलिए यदि आपने पहले OpenAI को कॉल किया है, तो केवल दो चीज़ें बदलती हैं: बेस URL और कुंजी।

आपको क्या चाहिए#

• एक खाता। साइन-अप ईमेल से होता है — कोई पासवर्ड नहीं, हम आपको एक साइन-इन लिंक भेजते हैं।
• एक बैलेंस। कोई सदस्यता नहीं है: आप USD बैलेंस टॉप अप करते हैं और हर अनुरोध मॉडल की निश्चित दर पर प्रति टोकन शुल्क लिया जाता है।
• आपके डैशबोर्ड से एक API कुंजी।

चरण 1. खाता बनाएं और टॉप अप करें#

साइन-अप पृष्ठ खोलें, अपना ईमेल दर्ज करें और पत्र से लिंक का पालन करें। डैशबोर्ड में Top up दबाएं और भुगतान का तरीका चुनें:

• क्रिप्टो — $5 से; 5% जमा शुल्क लागू होता है।
• कार्ड — एक साझेदार के माध्यम से, जो अपना शुल्क लेता है।

चरण 2. अपनी API कुंजी कॉपी करें#

जैसे ही आपका बैलेंस शून्य से अधिक होता है — टॉप-अप या रेफ़रल बोनस के बाद — डैशबोर्ड आपकी API कुंजी बनाता है और उसे एक बार दिखाता है। इसे तुरंत कॉपी करें और अपने कोड से बाहर रखें, उदाहरण के लिए एक पर्यावरण चर में:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

यदि कुंजी लीक हो जाती है, तो Rotate दबाएं: आपको एक नई कुंजी मिलती है और पुरानी काम करना बंद कर देती है।

चरण 3. एक मॉडल चुनें#

अनुरोधों को पूर्ण मॉडल ID की आवश्यकता होती है — स्लैश से पहले उपसर्ग के साथ, ठीक वैसे ही जैसे API इसे सूचीबद्ध करता है। लेखन के समय कैटलॉग (अक्टूबर 2026):

कैटलॉग बदल सकता है, इसलिए सत्य का स्रोत API ही है। इस अनुरोध को किसी कुंजी की आवश्यकता नहीं है:

curl https://api.cheaptokens.dev/v1/models

चरण 4. अनुरोध भेजें#

curl#

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "messages": [{"role": "user", "content": "Say hello in three languages"}]
  }'

एक सफल उत्तर मानक Chat Completions प्रारूप में वापस आता है। एक संक्षिप्त उदाहरण — आपका टेक्स्ट, ID और संख्याएं भिन्न होंगी, और प्रतिक्रिया में अतिरिक्त सेवा फ़ील्ड हो सकते हैं:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• टेक्स्ट choices[0].message.content में है।
• टोकन उपयोग usage में है: prompt_tokens — इनपुट, completion_tokens — आउटपुट। ये दो संख्याएं वही हैं जिनके लिए अनुरोध से शुल्क लिया जाता है।

Python#

आधिकारिक SDK को pip install openai के साथ इंस्टॉल करें और इसे हमारे बेस URL पर इंगित करें:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

SDK को npm install openai के साथ इंस्टॉल करें:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Anthropic-शैली के क्लाइंट#

Anthropic Messages API के लिए बनाए गए क्लाइंट /v1 के बिना रूट पते का उपयोग करते हैं — https://api.cheaptokens.dev — और कुंजी को x-api-key हेडर में भेजते हैं। Anthropic SDKs स्वयं पथ और हेडर जोड़ते हैं; आप केवल बेस URL और कुंजी सेट करते हैं।

यदि कुछ गलत हो जाए#

• 401 Invalid API key — कुंजी गलत टाइप की गई है या रोटेट की गई थी। जांचें कि आपने इसे पूरा पेस्ट किया है; डैशबोर्ड एक कुंजी केवल एक बार दिखाता है, इसलिए यदि यह खो जाती है, तो नई प्राप्त करने के लिए Rotate दबाएं।
• 402 — बैलेंस खत्म हो गया है, या अनुरोध Authorization हेडर के बिना चला गया।
• 400 Model "…" not found — /v1/models से पूर्ण मॉडल ID का उपयोग करें, जिसमें स्लैश से पहले उपसर्ग शामिल है।
• 404 — पता जांचें: OpenAI-शैली के क्लाइंट को बेस URL के अंत में /v1 की आवश्यकता होती है।

अधिक मामले और समाधान: सामान्य कनेक्शन त्रुटियां और उन्हें कैसे ठीक करें।

इसकी लागत क्या है#

प्रत्येक अनुरोध इनपुट और आउटपुट टोकन के लिए अलग-अलग शुल्क लिया जाता है, मॉडल की प्रति मिलियन टोकन दर पर। वर्तमान कीमतें — मूल्य निर्धारण पृष्ठ पर समान डेटा:

अगला कदम: एक कोडिंग एजेंट कनेक्ट करें, उदाहरण के लिए Cline, या अनुमान लगाना सीखें कि एक AI एजेंट की लागत क्या होगी।

क्या आप दूसरे डेवलपर्स को CheapTokens सुझाते हैं? रेफ़रल प्रोग्राम में आपको उनके टॉप-अप का एक प्रतिशत मिलता है।