Raycast میں CometAPI کا استعمال — ایک عملی رہنما

Raycast کی AI خصوصیات اب آپ کو providers.yaml کسٹم پرووائیڈر کے ذریعے کسی بھی OpenAI-مطابق فراہم کنندہ کو پلگ اِن کرنے دیتی ہیں۔ CometAPI ایک گیٹ وے API ہے جو OpenAI طرز کے REST انٹرفیس کے پیچھے سینکڑوں ماڈلز فراہم کرتا ہے — لہٰذا آپ Raycast کو https://api.cometapi.com/v1 کی طرف پوائنٹ کریں، اپنا CometAPI کلید شامل کریں، اور Raycast AI کے اندر CometAPI ماڈلز استعمال کریں (chat، commands، extensions)۔

Raycast کیا ہے؟

Raycast macOS کے لیے ایک پروڈکٹوِٹی لانچر ہے جو کمانڈز، اسکرپٹس، اور — بڑھتے ہوئے طور پر — AI کو براہِ راست آپ کے آپریٹنگ سسٹم میں ضم کرتا ہے۔ اس کا AI سب سسٹم چیٹ، AI کمانڈز، ماڈل سلیکشن، ایکسٹینشنز (ایسی ٹولنگ جو LLMs کو ایکشن لینے دیتی ہے)، اور لوکل ماڈلز (Ollama کے ذریعے) یا ریموٹ ماڈل پرووائیڈرز سے جڑنے کے لیے Bring Your Own Key / Custom Providers کی اہلیت فراہم کرتا ہے۔ Raycast ایک ماڈل پکر، AI کے لیے سیٹنگز، اور ایک providers.yaml ٹیمپلیٹ فراہم کرتا ہے جسے ماہر صارفین OpenAI-مطابق بیک اینڈز شامل کرنے کے لیے حسبِ ضرورت بنا سکتے ہیں۔

Raycast نے 2025 میں BYOK (Bring Your Own Key) اور Custom Providers متعارف کروانا شروع کیا، جس نے صارفین کو اپنے API keys اور کسٹم اینڈ پوائنٹس کے ذریعے Raycast AI چلانے کی سہولت دی (جس سے لاگت کے زیادہ لچکدار انتظام اور نجی پرووائیڈر آپشنز ممکن ہوئے)۔ یہ تبدیلی وہ تکنیکی بُنیاد ہے جو end-user Raycast preferences سے CometAPI کے انضمام کو ممکن بناتی ہے۔

Raycast صارفین کو AI کیسے فراہم کرتا ہے؟

• Quick AI: لانچر سے فوری پرامپٹس۔
• AI Chat: گفتگو پر مبنی سیشنز اٹیچمنٹس/کانٹیکسٹ کے ساتھ۔
• AI Commands/Extensions: ڈیولپرز کی بنائی ہوئی کمانڈز یا ٹولز جو LLMs استعمال کرتے ہیں۔
  (آپ Settings → AI سے ماڈلز، BYOK keys اور کسٹم پرووائیڈرز مینیج کر سکتے ہیں۔)

CometAPI کیا ہے؟

CometAPI ایک API-aggregation پلیٹ فارم ہے جو مختلف اقسام کے سینکڑوں AI ماڈلز (متن، تصویر، آڈیو، ویڈیو، ایمبیڈنگز) کو ایک ہی OpenAI طرز کے REST انٹرفیس کے ذریعے سامنے لاتا ہے۔ OpenAI، Anthropic، Google، Midjourney، Runway وغیرہ کے لیے الگ الگ کلائنٹ کوڈ لکھنے اور برقرار رکھنے کے بجائے، آپ CometAPI اینڈ پوائنٹ کو کال کرتے ہیں اور جس ماڈل کو چاہیں ایک ماڈل اسٹرنگ کے ذریعے منتخب کرتے ہیں۔ یہ سادہ کاری تجربات، لاگت/فیل اوور راؤٹنگ، اور بلنگ و آبزرویبلٹی کے مرکزیت کے لیے طاقتور ہے۔

کلیدی صلاحیتیں

• متن/چیٹ تکمیلات اور assistants (OpenAI جیسے چیٹ APIs)۔
• امیج جنریشن اور امیج ایڈیٹنگ اینڈ پوائنٹس۔
• ایمبیڈنگز برائے semantic search/RAG (retrieval-augmented generation)۔
• آڈیو (TTS اور STT جب زیریں ماڈلز فراہم کریں)۔
• ویڈیو جنریشن برائے مخصوص بیک اینڈز (Sora، Veo وغیرہ)۔
  CometAPI SDK اسنیپٹس اور OpenAI طرز کی درخواست فارمیٹس بھی فراہم کرتا ہے تاکہ موجودہ کوڈ کو منتقل کرنا سیدھا ہو۔

یہ اس وقت کیوں اہم ہے: مارکیٹ گیٹ وے APIs کی طرف منتقل ہو رہی ہے (آسان سنگل اینڈ پوائنٹس، سستے آپشنز، اور ماڈل کا انتخاب)۔ CometAPI اس میدان میں ایک کمرشل پلیئر ہے، اس لیے اسے Raycast کے کسٹم پرووائیڈر سپورٹ کے ساتھ ملانے سے آپ کو اپنے macOS ورک فلو سے وسیع ماڈل کیٹلاگ تک فوری رسائی ملتی ہے۔

Raycast کے ساتھ CometAPI کا انضمام کیوں کریں؟

مختصر جواب: تاکہ آپ CometAPI کے فراہم کردہ کسی بھی ماڈل کو براہِ راست اپنے Raycast AI فلو — Quick AI، AI Chat، یا کسٹم AI کمانڈز — سے بغیر ٹولنگ بدلے چلا سکیں۔

فوائد:

• مختلف کاموں کے لیے سستے/تیز یا مخصوص ماڈلز استعمال کریں (خلاصے، کوڈ، ایمبیڈنگز، امیج جنریشن) جبکہ Raycast کے اندر رہیں۔
• ماڈل سلیکشن کو Raycast سے کنٹرول کرتے ہوئے CometAPI کے ذریعے بلنگ اور تھروٹلنگ کو مرکزیت دیں۔
• کم سے کم کوڈ تبدیلیاں: Raycast OpenAI-مطابق کسٹم پرووائیڈرز اور BYOK کو سپورٹ کرتا ہے، لہٰذا CometAPI عموماً صرف base_url اور API key بدلنے سے پلگ اِن ہو جاتا ہے۔

(یہ صلاحیتیں اس وجہ سے ممکن ہیں کہ Raycast کسٹم پرووائیڈرز اور BYOK سپورٹ کرتا ہے، اور CometAPI OpenAI-مطابق اینڈ پوائنٹس https://api.cometapi.com/v1. پر فراہم کرتا ہے۔)

اس انضمام کے اچھے استعمالات کیا ہیں؟

1. Developer helper: کوڈ کی وضاحت، ریفیکٹر تجاویز، یونٹ ٹیسٹ جنریشن، اور PR سمری — Raycast سے چلائیں اور inline جوابات حاصل کریں۔
2. Notes اور خلاصے: متن منتخب کریں، Raycast کمانڈ چلا کر خلاصہ بنائیں یا ایکشن آئٹمز نکلوائیں، CometAPI کے summarization ماڈل سے فائدہ اٹھائیں۔
3. Documentation authoring: فنکشن ڈاکس یا README اسنیپٹس Raycast AI کمانڈز کے ذریعے بنائیں اور تکراریں مقامی رکھیں۔
4. Image / ملٹی میڈیا جنریشن: اگر CometAPI امیج اینڈ پوائنٹس فراہم کرتا ہے تو آپ Raycast ایکسٹینشنز استعمال کر سکتے ہیں جو امیج اینڈ پوائنٹس کو کال کرتی ہیں (مثلاً "Generate Image from Prompt" ایکسٹینشن) — فوری موک اپس کے لیے مفید۔
5. Embeddings + semantic search: CometAPI ایمبیڈنگز کے ذریعے لوکل سرچ ورک فلو چلائیں — Raycast فرنٹ اینڈ ہو سکتا ہے جو آپ کے ایمبیڈنگ انڈیکس کو ایک چھوٹی لوکل اسکرپٹ یا کلاؤڈ فنکشن کے ذریعے کوئری کرے۔

کن ماحول اور شرائط کی تیاری ضروری ہے؟

شروع کرنے سے پہلے، درج ذیل چیزیں یقینی بنائیں:

System & Raycast

• macOS (Raycast macOS-نیٹو ہے)۔
• Raycast انسٹال کیا ہوا۔ بہتر ہے کہ جدید ورژن ہو جو Custom Providers / BYOK کو سپورٹ کرتا ہو (Raycast نے BYOK v1.100.0 میں شامل کیا اور Custom Providers جاری رکھے ہوئے ہے)۔ اگر آپ کا Raycast پرانا ہے تو اسے اپڈیٹ کریں۔

Accounts & keys

• CometAPI اکاؤنٹ اور ایک معتبر CometAPI API key (آپ اسے Raycast سیٹنگز یا ماحول کی متغیرات میں استعمال کریں گے)۔ دیکھیے CometAPI ڈیش بورڈ/ڈاکیومینٹیشن۔

اختیاری ڈویلپر ٹولز (ٹیسٹنگ یا لوکل ڈویلپمنٹ کے لیے)

• Terminal (cURL کے لیے)۔
• Python / Node / OpenAI SDKs اگر آپ Raycast میں وائر کرنے سے پہلے براہِ راست CometAPI ایکسیس ٹیسٹ کرنا چاہیں۔ CometAPI base_url اووررائیڈ کر کے اسٹینڈرڈ SDKs کے ذریعے براہِ راست استعمال کی حمایت کرتا ہے۔

Permissions & networking

• یقینی بنائیں کہ Raycast اور آپ کی macOS نیٹ ورک پالیسیاں api.cometapi.com پر HTTPS کالز کی اجازت دیتی ہیں۔
• اگر آپ کارپوریٹ ماحول میں ہیں جہاں پراکسی/فائر وال ہے تو تصدیق کریں کہ api.cometapi.com قابلِ رسائی ہو۔

Local files & locations

Raycast کا AI providers configuration providers.yaml میں ہوتا ہے جو Raycast کی کنفگ ڈائریکٹری میں موجود ہے (ایپ ایک providers ٹیمپلیٹ دکھا سکتی ہے جسے آپ کاپی کر سکتے ہیں)۔ آپ providers.yaml میں کسٹم پرووائیڈرز متعین کرنے کے لیے ترمیم کریں گے یا اسے بنائیں گے۔

میں Raycast کو CometAPI کے ساتھ کیسے ضم کروں؟

بنیادی خیال: CometAPI کو Raycast میں ایک OpenAI-مطابق کسٹم پرووائیڈر کے طور پر رجسٹر کریں، Raycast کو https://api.cometapi.com/v1 کی طرف پوائنٹ کریں، اور اپنی Comet ٹوکن کو Raycast کی کسٹم API keys میں شامل کریں۔

مرحلہ 1: اپنی CometAPI key حاصل کریں

1. CometAPI پر سائن اپ کریں اور کنسول/ڈیش بورڈ کھولیں۔
2. ایک API ٹوکن بنائیں۔ اس ٹوکن کو محفوظ جگہ کاپی کریں (یا اگلے مرحلے کے لیے سنبھال کر رکھیں)۔

مرحلہ 2: Raycast کی AI سیٹنگز کھولیں اور کسٹم پرووائیڈرز فعال کریں

1. Raycast میں: Preferences → AI۔
2. “Custom Providers” (یا “Custom OpenAI-compatible APIs”) تلاش کریں اور Reveal Providers Config پر کلک کریں۔ Raycast Finder میں کنفگ ڈائریکٹری کھولے گا اور ایک ٹیمپلیٹ فائل فراہم کرے گا (عموماً providers.template.yaml) جسے کاپی کر کے providers.yaml کے نام سے محفوظ کریں۔

مرحلہ 3: providers.yaml میں ایک CometAPI پرووائیڈر شامل کریں

providers.yaml فائل بنائیں یا ترمیم کریں۔ Raycast کے مطلوبہ اسکیمے ورژن کے لحاظ سے مختلف ہو سکتے ہیں، لیکن کمیونٹی ٹیمپلیٹس اور Raycast مینوئل عام ساخت دکھاتے ہیں: id، name، base_url اور اختیاری models بلاک کے ساتھ پرووائیڈرز کی فہرست۔ ذیل میں ایک محفوظ، کارآمد مثال ہے تاکہ CometAPI کو رجسٹر کرنا as an OpenAI-co

اہم نوٹس

• YOUR_COMETAPI_KEY کو محفوظ حوالہ سے بدلیں — ذاتی استعمال کے لیے ٹوکن چسپاں کر سکتے ہیں، بہتر یہ ہے کہ macOS Keychain / Raycast کے محفوظ فیلڈز (اگر سپورٹڈ ہوں) میں محفوظ کریں۔
• base_url اہم لائن ہے: اسے https://api.cometapi.com/v1. کی طرف پوائنٹ کریں۔ Raycast OpenAI-مطابق کالز کے لیے اسی بیس URL کو استعمال کرے گا۔
• آپ کو لازماً تمام ماڈلز پہلے سے درج کرنے کی ضرورت نہیں — اگر آپ کا پرووائیڈر ایک مناسب OpenAI طرز کے GET /v1/models اینڈ پوائنٹ فراہم کرتا ہے تو Raycast ماڈل لسٹس حاصل کر سکتا ہے۔ اگر CometAPI ماڈلز لسٹ فراہم کرتا ہے تو Raycast دستیاب ماڈلز کو ریفریش اور ڈسپلے کر سکتا ہے۔

مرحلہ 4: ماڈلز ریفریش کریں اور ٹیسٹ کریں

• واپس Raycast میں، ہوسکتا ہے آپ کو ایپ ری اسٹارٹ کرنا پڑے یا “Refresh Models” کمانڈ استعمال کرنی پڑے (ورژن پر منحصر) تاکہ Raycast نئے پرووائیڈر سے ماڈلز حاصل کرے اور ماڈل پکر میں پاپولیٹ کرے۔ اگر ماڈلز ظاہر نہیں ہوتے تو ریفریش یا ری اسٹارٹ کرنے کی سفارش کی جاتی ہے۔
• ایک سادہ Quick AI پرامپٹ استعمال کریں، CometAPI کا ماڈل ماڈل پکر سے منتخب کریں، اور ایک ٹیسٹ پرامپٹ چلائیں۔

Raycast کے اندر CometAPI استعمال کرتے وقت بہترین طریقے

سکیورٹی کے بہترین طریقے: مشترکہ providers.yaml میں کبھی ٹوکن ہارڈ کوڈ نہ کریں۔ Raycast کے محفوظ فیلڈز یا macOS Keychain کو ترجیح دیں، یا اگر آپ لوکل پراکسی استعمال کر رہے ہیں تو ماحول کی متغیرات کے ذریعے keys انجیکٹ کریں۔ حساس ڈیٹا ہو تو CometAPI اور Raycast کی پرائیویسی دستاویزات پڑھیں۔

اعتمادی و کارکردگی: لیٹنسی ٹیسٹ کریں جن ماڈلز کو آپ استعمال کرنا چاہتے ہیں — گیٹ وے APIs میں راؤنٹنگ متغیر ہو سکتی ہے۔ انٹرایکٹو ورک فلو (آٹو سمریز، فوری lookups) کے لیے چھوٹے، تیز ماڈلز کو ترجیح دیں۔ گہرے استدلال کے کاموں کے لیے ہائی-کانٹیکسٹ ماڈلز منتخب کریں۔

لاگت پر کنٹرول: ماڈل سلیکشن جارحانہ رکھیں: ہلکے کاموں کے لیے ہلکے ماڈلز، بھاری استدلال کے لیے اعلیٰ صلاحیت کے ماڈلز۔ CometAPI ڈیش بورڈ پر استعمال پر نظر رکھیں اور بجٹ الرٹس سیٹ کریں۔ پرامپٹس کو پروگراماتی طور پر مختصر رکھ کر ٹوکن استعمال کم کریں (مثلاً چھوٹے سسٹم میسجز، موثر کانٹیکسٹ مینجمنٹ)۔

پرامپٹ انجینئرنگ و UX: جب Raycast AI Commands بنائیں (بلٹ اِن کمانڈ کو ڈپلیکیٹ کر کے پرامپٹ ٹویک کریں)، یوٹیلٹی کمانڈز (خلاصہ، ٹرائیج، تلاش) کے لیے پرامپٹس کو زیادہ deterministic رکھیں اور آئیڈییشن ورک فلو کے لیے زیادہ کھلے رکھیں۔ بلٹ اِن کمانڈز کو کاپی کر کے پرامپٹس کسٹمائز کرنا ہی تجویز کردہ طریقہ ہے۔

عام مسائل کو کیسے ٹربل شوٹ کریں؟

ماڈلز Raycast میں ظاہر نہیں ہو رہے: یقینی بنائیں کہ Raycast کا providers.yaml بالکل اسی فولڈر میں ہے جو Reveal Providers Config کے ذریعے کھولا گیا تھا۔ ٹیمپلیٹ کو بنیاد بنائیں اور Raycast کو ری اسٹارٹ کریں۔ ری اسٹارٹ یا “Refresh Models” مددگار ہوتا ہے۔

401 / invalid token: تصدیق کریں کہ آپ کا CometAPI ٹوکن درست ہے اور میعاد ختم نہیں ہوئی۔ اوپر دیا گیا curl ٹیسٹ آزمائیں۔ دوبارہ چیک کریں کہ آپ نے Bearer ٹوکن استعمال کیا اور Authorization ہیڈر درست ہے۔

ماڈل ایررز یا غیر مطابقت پذیر response shapes: CometAPI OpenAI-مطابقت کا ہدف رکھتا ہے مگر کچھ edge cases موجود ہو سکتے ہیں (ماڈل IDs، اسٹریمنگ رویے)۔ اگر Raycast کسی مخصوص اسٹریمنگ فارمیٹ کی توقع کرتا ہے اور CometAPI قدرے مختلف شیپ دیتا ہے تو پہلے non-streaming کال آزمائیں اور ضرورت ہو تو CometAPI سپورٹ سے رابطہ کریں۔

نتیجہ

CometAPI آپ کو یکجا، ملٹی وینڈر رسائی دیتا ہے متعدد ماڈلز (متن، تصویر، آڈیو، ویڈیو) تک اور ٹیمز کو بلنگ اور راؤٹنگ مرکزیت دینے دیتا ہے۔ Raycast آپ کو ایک فوری، کی بورڈ-فرسٹ جگہ دیتا ہے جہاں آپ اپنے ڈیسک ٹاپ ورک فلو کے سیاق میں ان ماڈلز کو کال کریں۔ دونوں مل کر ماڈل تجربہ کاری اور ڈیسک ٹاپ آٹومیشن کو بے رگڑ بناتے ہیں — آپ لاگت یا معیار کے لیے ماڈلز بدل سکتے ہیں، اپنی keys لوکل رکھ سکتے ہیں، اور وہی مانوس OpenAI طرز کے پیٹرنز استعمال کر سکتے ہیں جو آپ پہلے سے اسکرپٹس اور ایپس میں رکھتے ہیں۔

اگر آپ فوراً آزمانا چاہتے ہیں، تو CometAPI کے Playground میں ماڈلز کی (Gemini 3 Pro Preview API وغیرہ) صلاحیتیں ایکسپلور کریں اور تفصیلی ہدایات کے لیے API گائیڈ دیکھیں۔ رسائی سے پہلے، براہِ کرم یقینی بنائیں کہ آپ نے CometAPI میں لاگ اِن کیا ہوا ہے اور API key حاصل کر لی ہے۔ CometAPI آپ کے انضمام میں مدد کے لیے آفیشل قیمت سے کہیں کم قیمت پیش کرتا ہے۔

Ready to Go?→ use CometAPI in Raycast today !

اگر آپ AI پر مزید ٹپس، گائیڈز اور خبریں جاننا چاہتے ہیں تو ہمیں VK، X اور Discord پر فالو کریں!