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

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

Raycast کیا ہے؟

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

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

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

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

CometAPI کیا ہے؟

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

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

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

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

Raycast کے ساتھ CometAPI انٹیگریٹ کیوں کریں؟

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

فوائد:

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

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

اس انٹیگریشن کے لیے اچھے use cases کیا ہیں؟

1. ڈیولپر ہیلپر: کوڈ کی وضاحت، ریفیکٹر تجاویز، یونٹ ٹیسٹ جنریشن، اور PR سمریز — Raycast سے کال کریں اور اِن لائن جواب پائیں۔
2. نوٹس اور سمریز: متن سلیکٹ کریں، Raycast کمانڈ سے سمریز یا ایکشن آئٹمز نکلوائیں، CometAPI کے سمرائزیشن ماڈل سے۔
3. ڈاکیومنٹیشن آتھرنگ: Raycast AI کمانڈز کے ذریعے فنکشن ڈاکس یا README اسنیپٹس بنائیں اور لوکل ہی تیز رفتاری سے اِٹرشنز کریں۔
4. امیج/ملٹی میڈیا جنریشن: اگر CometAPI امیج اینڈ پوائنٹس ایکسپوز کرتا ہے، تو آپ ایسی Raycast ایکسٹینشنز استعمال کر سکتے ہیں جو امیج اینڈ پوائنٹس کال کرتی ہیں (مثلاً "Generate Image from Prompt" ایکسٹینشن) — تیز موک اَپس کے لیے مفید۔
5. ایمبیڈنگز + سیمنٹک سرچ: CometAPI ایمبیڈنگز سے لوکل سرچ ورک فلو چلائیں — Raycast فرنٹ اینڈ بن سکتا ہے جو ایک چھوٹی لوکل اسکرپٹ یا کلاؤڈ فنکشن کے ذریعے آپ کے ایمبیڈنگ انڈیکس سے پوچھ گچھ کرے۔

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

سسٹم اور Raycast

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

اکاؤنٹس اور کلیدیں

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

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

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

اجازتیں اور نیٹ ورکنگ

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

لوکل فائلیں اور مقامات

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

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

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

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

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

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

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

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

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

اہم نکات

• YOUR_COMETAPI_KEY کو ایک محفوظ حوالہ سے بدلیں — یا تو ذاتی استعمال کے لیے ٹوکن پیسٹ کریں، یا بہتر ہے: اگر سپورٹڈ ہو تو macOS Keychain / Raycast کی محفوظ فیلڈز میں اسٹور کریں۔
• base_url اہم لائن ہے: اسے https://api.cometapi.com/v1. پر پوائنٹ کریں۔ Raycast OpenAI-compatible کالز کے لیے اسی base URL کو استعمال کرے گا۔
• آپ کو لازماً تمام ماڈلز پہلے سے فہرست بند کرنے کی ضرورت نہیں — اگر آپ کا پرووائیڈر OpenAI-style 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 میں روٹنگ متغیر ہو سکتی ہے۔ انٹرایکٹو ورک فلو (آٹو سمریز، فوری تلاش) کے لیے چھوٹے، تیز ماڈلز کو ترجیح دیں۔ گہری ریزننگ کے کاموں کے لیے ہائی-کانٹیکسٹ ماڈلز منتخب کریں۔

لاگت پر کنٹرول: ماڈل سلیکشن کو مؤثر طریقے سے استعمال کریں: مختصر کاموں کے لیے ہلکے ماڈلز، بھاری ریزننگ کے لیے ہائی-کیپیسٹی ماڈلز۔ CometAPI کے ڈیش بورڈ پر یوزج ٹریک کریں اور بجٹ الرٹس سیٹ کریں۔ ٹوکن استعمال کم کرنے کے لیے پروگراماتی پرامپٹس پر غور کریں (مثلاً مختصر سسٹم میسجز، مؤثر کانٹیکسٹ مینجمنٹ)۔

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

عام مسائل کا ازالہ کیسے کریں؟

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

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

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

نتیجہ

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

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

تیار ہیں؟→ use CometAPI in Raycast today !

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