AI API کا استعمال کیسے کریں۔

AI API (ایپلی کیشن پروگرامنگ انٹرفیس) کا استعمال ڈویلپرز کے لیے طاقتور AI صلاحیتوں کو ضم کرنے کا معیاری طریقہ ہے، جیسے ٹیکسٹ جنریشن، تصویری تجزیہ، یا زبان کا ترجمہ، ان کی اپنی ایپلی کیشنز میں پیچیدہ ماڈلز بنائے بغیر۔

یہ ایک زیادہ گہرائی سے قدم بہ قدم واک تھرو ہے کہ واقف OpenAI درخواست کے نمونوں کا استعمال کرتے ہوئے کسی بھی AI ماڈل کو کیسے کال کرنا ہے۔

مرحلہ 1: ایک AI فراہم کنندہ اور API کا انتخاب کریں۔

پہلا قدم ایک ایسی AI سروس کا انتخاب کرنا ہے جو آپ کی ضروریات کے مطابق ہو۔ مختلف فراہم کنندگان مختلف شعبوں میں مہارت رکھتے ہیں، جیسے:

• OpenAI: اس کے لیے مشہور ہے۔ جی پی ٹی سیریز (مثال کے طور پر، O4-منی) ایڈوانس ٹیکسٹ جنریشن، استدلال، اور چیٹ (Chat Completions API) کے ساتھ ساتھ ڈیل ای تصویر بنانے کے لیے اور کسبی آڈیو ٹرانسکرپشن کے لیے۔
• گوگل اے آئی (جیمنی): طاقتور پیش کرتا ہے۔ ماڈلز کا جیمنی خاندان (مثال کے طور پر، جیمنی 2.5 پرو پیش نظارہ) ایک ہی درخواست میں ملٹی موڈل تفہیم، معاون متن، تصاویر اور ویڈیو کے لیے۔
• انتھروپک (کلاڈ): اس کے لیے جانا جاتا ہے۔ کلاڈ ماڈلز (مثال کے طور پر، کلاڈ سونیٹ 4)، جو ان کے بڑے سیاق و سباق کی ونڈوز، نفیس استدلال، اور AI حفاظت اور آئینی AI پر مضبوط توجہ کے لیے سراہا جاتا ہے۔

اس گائیڈ کے لیے، ہم OpenAI API کو CometAPI پلیٹ فارم کے ذریعے اپنی بنیادی مثال کے طور پر استعمال کریں گے۔

CometAPI ایک متحد API پلیٹ فارم ہے جو سرکردہ فراہم کنندگان سے 500 سے زیادہ AI ماڈلز کو اکٹھا کرتا ہے — جیسے OpenAI کی GPT سیریز، Google کی Gemini، Anthropic's Claude، Midjourney، Suno، اور مزید — ایک واحد، ڈویلپر کے موافق انٹرفیس میں۔ مسلسل تصدیق، درخواست کی فارمیٹنگ، اور رسپانس ہینڈلنگ کی پیشکش کرکے، CometAPI ڈرامائی طور پر آپ کی ایپلی کیشنز میں AI صلاحیتوں کے انضمام کو آسان بناتا ہے۔

مرحلہ 2: اپنی API کلید حاصل کریں۔

ایک بار جب آپ نے ایک فراہم کنندہ کا انتخاب کیا ہے، تو آپ کو ان کے پلیٹ فارم پر ایک اکاؤنٹ کے لیے سائن اپ کرنے کی ضرورت ہے (مثال کے طور پر، CometAPI)۔ رجسٹر کرنے کے بعد، آپ کو ایک حاصل کرنا ضروری ہے API کلید.

• API کلید کیا ہے؟ ایک API کلید حروف کی ایک منفرد تار ہے جو آپ کی درخواستوں کی تصدیق کرتی ہے۔ یہ آپ کی درخواست کے لیے ایک خفیہ پاس ورڈ کی طرح ہے۔ اپنی API کلید کا عوامی طور پر کبھی اشتراک نہ کریں۔ یا اسے Git جیسے ورژن کنٹرول سسٹم سے کمٹ کریں۔
• اسے کیسے حاصل کرنا اپنے اکاؤنٹ کے ڈیش بورڈ میں "API کیز" سیکشن پر جائیں اور ایک نئی کلید بنائیں۔
• اچھی مشق: اپنی API کلید کو بطور ایک اسٹور کریں۔ ماحول متغیر آپ کے منصوبے میں. یہ اسے آپ کے کوڈ میں حادثاتی طور پر بے نقاب ہونے سے روکتا ہے۔ مثال کے طور پر، آپ متغیر کا نام دیں گے۔ CometAPI_API_KEYایک پاس ورڈ کی طرح اس کا علاج کریں! کرو نوٹ اسے عوامی ریپوز میں بھیجیں۔

کیوں؟
کلید منفرد طور پر آپ کی درخواستوں کی شناخت اور تصدیق کرتی ہے، لہذا CometAPI جانتا ہے کہ کس اکاؤنٹ کو بل دینا ہے اور کون سی حدود لاگو کرنی ہیں۔

مرحلہ 3: API دستاویزات پڑھیں

یہ انتہائی اہم اقدام ہے۔ سرکاری دستاویزات آپ کی سچائی کا حتمی ذریعہ ہے۔ یہ آپ کو وہ سب کچھ بتائے گا جس کی آپ کو جاننے کی ضرورت ہے، بشمول:

• توثیق: ہر درخواست کے ساتھ اپنی API کلید کو صحیح طریقے سے کیسے بھیجیں (عام طور پر درخواست کے ہیڈر میں)۔
• اختتامی نکات: مخصوص URLs جن پر آپ کو مختلف کاموں کے لیے درخواستیں بھیجنے کی ضرورت ہے۔ مثال کے طور پر، https://api.cometapi.com/v1/chat/completions چیٹ ماڈلز کے ساتھ ٹیکسٹ جنریشن کا اختتامی نقطہ ہے۔
• درخواست کے پیرامیٹرز: وہ ڈیٹا جو آپ کو اپنی درخواست کے ساتھ بھیجنے کی ضرورت ہے۔ یہ عام طور پر ایک JSON آبجیکٹ ہے جس میں تفصیلات شامل ہیں جیسے:
• model: کون سا AI ماڈل استعمال کرنا ہے (مثال کے طور پر، "gpt-4o").
• messages or prompt: وہ ان پٹ جس پر آپ AI سے کارروائی کرنا چاہتے ہیں۔
• max_tokens: پیدا کردہ جواب کی زیادہ سے زیادہ لمبائی۔
• temperature: ایک قدر (مثال کے طور پر، 0.0 سے 2.0) جو "تخلیقیت" یا آؤٹ پٹ کی بے ترتیب پن کو کنٹرول کرتی ہے۔ نچلا زیادہ عزم پسند ہے، اعلی زیادہ تخلیقی ہے۔
• ردعمل کی ساخت: ڈیٹا کا فارمیٹ آپ کو API سے واپس ملے گا، لہذا آپ جانتے ہیں کہ اسے کیسے پارس کرنا ہے۔
• شرح کی حدیں اور قیمتیں: اس بارے میں معلومات کہ آپ فی منٹ کتنی درخواستیں کر سکتے ہیں اور ہر درخواست پر کتنا خرچ آئے گا۔

مرحلہ 4: اپنے ترقیاتی ماحول کو ترتیب دیں۔

CometAPI OpenAI کے API کے ساتھ پروٹوکول سے مطابقت رکھتا ہے۔ اس کا مطلب ہے کہ کوئی بھی OpenAI طرز کی کلائنٹ لائبریری جو آپ پہلے سے استعمال کرتے ہیں کام کرے گی۔ آپ کو ایک پروگرامنگ زبان اور HTTP درخواستیں کرنے کا طریقہ درکار ہوگا۔ اس کے لیے ازگر بہت مقبول ہے، لیکن آپ کوئی بھی زبان (جاوا اسکرپٹ، جاوا، گو، وغیرہ) استعمال کرسکتے ہیں۔

1. Python انسٹال کریں: اگر آپ کے پاس یہ نہیں ہے تو ازگر سے ڈاؤن لوڈ اور انسٹال کریں۔ python.org.
2. ایک HTTP لائبریری انسٹال کریں: ازگر کے لیے، requests لائبریری ایک سادہ اور طاقتور انتخاب ہے۔ متبادل طور پر، بہت سے API فراہم کنندگان اپنی سرکاری لائبریریاں پیش کرتے ہیں جو بات چیت کو اور بھی آسان بنا دیتے ہیں۔

bash# Using the official OpenAI Python library is recommended

pip install openai

# For making generic HTTP requests, you could use:

pip install requests

Node.js: npm install openai

کیوں؟
یہ کلائنٹ لائبریریاں HTTP، JSON انکوڈنگ، شرح کی حد کے لیے دوبارہ کوشش کرنے کی منطق اور مزید بہت کچھ کرتی ہیں — جو آپ کو بوائلر پلیٹ لکھنے سے بچاتی ہیں۔

مرحلہ 5: اپنے کلائنٹ کو CometAPI کی طرف اشارہ کریں۔

پہلے سے طے شدہ طور پر، OpenAI کلائنٹس کی طرف اشارہ کرتے ہیں۔ api.openai.com. آپ کو اس بنیادی URL کو اوور رائڈ کرنے اور اپنی CometAPI کلید میں تبدیل کرنے کی ضرورت ہے:

1. ماحولیاتی متغیرات (تجویز کردہ)

انہیں اپنے شیل میں سیٹ کریں (bash/zsh/fish/PowerShell):

export OPENAI_API_BASE="https://www.cometapi.com/console/"
export OPENAI_API_KEY="sk-YOUR_COMETAPI_KEY"

• OPENAI_API_BASE کلائنٹ کو بتاتا ہے کہ درخواستیں کہاں بھیجنی ہیں۔
• OPENAI_API_KEY آپ کا CometAPI راز ہے۔

2. ان کوڈ کنفیگریشن

متبادل طور پر، آپ ان کو اپنے کوڈ میں سیٹ کر سکتے ہیں:

import openai, os

openai.api_base = "https://www.cometapi.com/console/"
openai.api_key  = "sk-YOUR_COMETAPI_KEY"

کیوں؟
HTTP کلائنٹ کی سطح پر ری ڈائریکٹ کرنے کا مطلب ہے۔ ہر OpenAI طرز کی کال جو آپ کرتے ہیں — چیٹ، تصاویر، ایمبیڈنگ وغیرہ — اس کے بجائے CometAPI کے ذریعے جاتی ہے۔

---

مرحلہ 6: اپنی پہلی چیٹ مکمل کرنے والی کال کرنا

یہاں ایک مکمل تشریح شدہ ازگر کی مثال ہے۔ پیرامیٹرز اور رسپانس ہینڈلنگ پر توجہ مرکوز کریں:

import openai

# 1. Point at CometAPI (if not using env vars)

openai.api_base = "https://www.cometapi.com/console/"
openai.api_key  = "sk-YOUR_COMETAPI_KEY"

# 2. Build your prompt sequence

messages = [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user",   "content": "Explain the advantages of using CometAPI."}
]

# 3. Call the chat completion endpoint

response = openai.ChatCompletion.create(
    model="gpt-4o",      # pick any supported model name

    messages=messages,
    temperature=0.5,     # controls creativity: 0 = deterministic, 1 = very creative

    max_tokens=500,      # cap on how long the reply can be

)

# 4. Extract and print the assistant’s reply

reply = response.choices.message.content
print("Assistant:", reply)

---

مرحلہ 7: براہ راست cURL استعمال کرنا

اگر آپ خام HTTP کو ترجیح دیتے ہیں تو، یہاں مساوی cURL کمانڈ ہے:

curl https://api.cometapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role":"system","content":"You are a helpful assistant."},
      {"role":"user","content":"How do I use CometAPI?"}
    ],
    "temperature": 0.5,
    "max_tokens": 500
  }'

cURL کیوں استعمال کریں؟
فوری ٹیسٹ، اسکرپٹنگ، یا اگر آپ SDK انسٹال نہیں کرنا چاہتے ہیں تو بہت اچھا ہے۔

---

مرحلہ 8: دوسرے اختتامی مقامات کو تلاش کرنا

ایک بار جب آپ کا بنیادی URL اور کلید سیٹ ہو جاتی ہے، ہر OpenAI طرز کا اختتامی نقطہ دستیاب ہے، مخصوص حوالہ API دستاویز.

1. تصویری جنریشن
2. سرایت
3. آڈیو (ٹیکسٹ ٹو اسپیچ)
4. عمدہ ٹیوننگ

سبھی ایک ہی HTTP پاتھ ڈھانچہ استعمال کرتے ہیں (مثال کے طور پر /v1/<service>/<action>) اور JSON اسکیما جو آپ پہلے ہی جانتے ہیں۔

مرحلہ 9: بہترین طرز عمل اور تجاویز

1. چھوٹا شروع کرو: اعلیٰ قیمت والے ماڈلز تک پیمانہ کرنے سے پہلے سستے ماڈل کے ساتھ پروٹو ٹائپ۔
2. کیشے کے جوابات: دوبارہ سوالات کے لیے (مثلاً ایمبیڈنگز)، غیر ضروری API کالوں سے بچنے کے لیے مقامی طور پر اسٹور کریں۔
3. ٹوکن بجٹنگ: خیال رکھنا max_tokens اور اخراجات کو کنٹرول کرنے کے لیے پیغام کی تاریخ کی لمبائی۔
4. سلامتی: اپنی API کلید کو وقفے وقفے سے گھمائیں اور اسے کلائنٹ سائڈ کوڈ میں ظاہر نہ کریں۔
5. ہم آہنگی: CometAPI ہائی تھرو پٹ کو سپورٹ کرتا ہے، لیکن ہر ماڈل کی اپنی شرح کی حدیں ہو سکتی ہیں — مانیٹر اور ضرورت کے مطابق شارڈ درخواستیں۔
6. اغلاط کی درستگی: اپنی API کالز کو ہمیشہ لپیٹ کر رکھیں try...except بلاکس جواب کا HTTP اسٹیٹس کوڈ چیک کریں۔ اے 200 OK کامیابی کا مطلب ہے، جبکہ کوڈ پسند کرتے ہیں 401 (غیر مجاز) 429 (بہت زیادہ درخواستیں)، یا 500 (اندرونی سرور کی خرابی) مسائل کی نشاندہی کرتی ہے۔

---

خلاصہ

1. اپنی چابی حاصل کریں۔ CometAPI سے۔
2. انسٹال آپ کا OpenAI سے ہم آہنگ SDK۔
3. منسوخ کریں بنیادی URL https://api.cometapi.com.
4. استعمال وہی پیٹرن جو آپ چیٹ، امیجز، ایمبیڈنگ وغیرہ کے لیے پہلے سے جانتے ہیں۔
5. کی نگرانی استعمال، غلطیوں کو احسن طریقے سے ہینڈل کریں، اور لاگت کے لیے بہتر بنائیں۔

ان تفصیلی اقدامات کے ساتھ، آپ منٹوں میں سیکڑوں مختلف AI ماڈلز کو ضم کر سکتے ہیں — سیکھنے کے لیے کوئی نئی کلائنٹ لائبریری نہیں، بس آپ کی انگلیوں پر انتخاب کی طاقت۔