CheapTokens کے ساتھ آپ کی پہلی API درخواست

یہ گائیڈ آپ کو نئے اکاؤنٹ سے کام کرنے والی درخواست تک لے جاتی ہے۔ آپ کو ایک ای میل ایڈریس، تھوڑا بیلنس اور ایک ٹرمینل کی ضرورت ہے۔ API اوپن اے آئی کے ساتھ مطابقت رکھتی ہے، لہذا اگر آپ پہلے اوپن اے آئی کو کال کر چکے ہیں، تو صرف دو چیزیں بدلتی ہیں: بیس 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 فارمیٹ میں واپس آتا ہے۔ ایک مختصر مثال — آپ کا متن، IDs اور نمبر مختلف ہوں گے، اور جواب میں اضافی سروس فیلڈز ہو سکتے ہیں:

{
  "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 تجویز کرتے ہیں؟ ریفرل پروگرام کے تحت آپ کو ان کے ٹاپ اپس کا ایک فیصد ملتا ہے۔