ایک providers.yaml کے ذریعے کیٹلاگ models کو Raycast AI میں شامل کریں۔

فوری جواب: Custom Providers فعال کریں، ایک فائل ایڈٹ کریں۔

OpenAI-compatible endpoints کے لیے Raycast کا راستہ Custom Providers feature ہے، جو advanced users کے لیے ہے اور by default disabled ہوتا ہے۔ اسے Raycast Settings میں AI section کے نیچے enable کریں، config folder کھولنے کے لیے Reveal Providers Config استعمال کریں، اور shipped providers.template.yaml کو providers.yaml میں copy کریں۔ فائل ~/.config/raycast/ai/providers.yaml پر رہتی ہے۔ ہر provider entry ایک id، ایک display name، ایک base_url، اور ایک api_keys block لیتی ہے؛ picker میں چاہیے ہر model اپنی id، display name، اور context window کے ساتھ واضح طور پر declare کی جاتی ہے، ساتھ ہی ایک abilities block جو بتاتا ہے کہ Raycast اس سے کیا مانگ سکتا ہے۔ base_url کی شکل انہی built-in local-model examples کے convention کی پیروی کرتی ہے، جو ایک /v1 root کی طرف اشارہ کرتے ہیں، تو APIsRouter کی value ہے https://api.apisrouter.com/v1۔ فائل credentials رکھتی ہے، تو اسے کسی بھی secrets file کی طرح treat کریں۔

providers:
  - id: apisrouter
    name: APIsRouter
    base_url: https://api.apisrouter.com/v1
    api_keys:
      default: sk-APIsRouter-...
    models:
      - id: claude-sonnet-4-6
        name: Claude Sonnet 4.6
        context: 200000
        abilities:
          temperature:
            supported: true
          tools:
            supported: true
      - id: claude-haiku-4-5-20251001
        name: Claude Haiku 4.5
        context: 200000
        abilities:
          temperature:
            supported: true

دو Raycast features جو ملتے جلتے لگتے ہیں، مگر ہیں نہیں۔

Raycast اپنی AI access لانے کے دو طریقے document کرتا ہے، اور ایک کو تلاش کرنا قابلِ اعتماد طور پر دوسرا سامنے لے آتا ہے، تو یہ فرق واضح طور پر بیان کرنے کے قابل ہے۔ Bring Your Own Keys، Raycast manual میں BYOK page، آپ کی ذاتی Anthropic، Google، یا OpenAI key (iOS پر OpenRouter) کو Raycast AI سے جوڑتا ہے۔ یہ زیادہ سادہ feature ہے، جو Pro subscription کے بغیر کام کرتا ہوا document ہے، مگر یہ custom endpoint نہیں: requests API unification کے لیے Raycast کے servers سے route ہوتی ہیں، اور manual صاف کہتا ہے کہ صرف وہ models قابلِ رسائی ہیں جو پہلے سے Raycast AI میں موجود ہیں۔ ایک gateway key وہاں plug نہیں ہوتی، کیونکہ BYOK کبھی URL نہیں مانگتا۔ Custom Providers وہ feature ہے جسے یہ صفحہ configure کرتا ہے: آپ کا اپنا base_url، آپ کی اپنی key، آپ کے اپنے declared models، اور requests وہیں جاتی ہیں جہاں آپ انہیں point کریں۔ یہ multi-vendor gateway کے لیے، local servers کے لیے، اور کسی بھی ایسے model کے لیے راستہ ہے جسے Raycast کی built-in list نہیں رکھتی۔ قیمت explicitness ہے: Raycast آپ کے لیے endpoint کی model list fetch نہیں کرتا (وہ سہولت ایک standing feature request ہے)، تو picker بالکل وہی دکھاتا ہے جو آپ کا YAML declare کرے، نہ کم نہ زیادہ۔

Models کو ایمانداری سے declare کرنا: ids، context، abilities۔

چونکہ کوئی autodiscovery موجود نہیں، YAML ایک contract ہے، اور اس میں ہر field اصل کام کرتی ہے۔ model id کو gateway کی /v1/models listing سے حرف بہ حرف میچ ہونا چاہیے؛ یہی وہ چیز ہے جو request میں سفر کرتی ہے۔ name صرف وہ label ہے جو Raycast دکھاتا ہے۔ context value Raycast کو بتاتی ہے کہ وہ ایک request میں کتنی conversation history pack کر سکتا ہے، تو اسے کم بتانا capability ضائع کرتا ہے اور زیادہ بتانا ایسی requests پیدا کرتا ہے جنہیں model رد کر دے؛ جس id کو آپ declare کر رہے ہیں اس کی documented window استعمال کریں۔ abilities block وہ چیز ہے جس میں لوگ غلطی کرتے ہیں۔ یہ بتاتا ہے کہ Raycast کس چیز پر انحصار کر سکتا ہے: temperature control، vision input، system messages، tool use، reasoning effort۔ کوئی ایسی ability declare کرنا جو model کے پاس نہ ہو صاف errors کی بجائے Raycast کے features کے اندر confusing runtime failures پیدا کرتی ہے، اور کوئی ایسی ability چھوڑ دینا جو model رکھتا ہے خاموشی سے متعلقہ Raycast behavior کو disable کر دیتا ہے۔ کم سے کم سے شروع کریں، AI extensions کے ساتھ استعمال ہونے والے models کے لیے temperature اور tools، اور abilities تب شامل کریں جب انہیں model کی documentation کے خلاف confirm کر لیں۔ ایک community-maintained Raycast extension خاص طور پر اس فائل کو ایک UI سے manage کرنے کے لیے موجود ہے، ہر تبدیلی سے پہلے automatic backups کے ساتھ، جاننے کے قابل اگر ہاتھ سے YAML لکھنا آپ کی ترجیح نہ ہو۔ بہرحال، Raycast فائل کو disk سے پڑھتا ہے، تو edit کرنے کے بعد، AI settings کو ایک لمحہ دیں یا feature toggle کریں تاکہ یقینی بنے کہ picker موجودہ فائل کی عکاسی کر رہا ہے۔

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# declare these ids verbatim in providers.yaml

launcher کے لیے models چننا۔

چونکہ ہر declared model اسی key کے ذریعے bill ہوتا ہے، comparison loop ایک picker switch ہے: ایک دن کے لیے دو ids پر وہی quick commands چلائیں، پھر console میں per-model spend پڑھیں اور وہی رکھیں جس نے اپنی جگہ کمائی۔

• Launcher AI burst work ہے: یہ summarize کرو، وہ rewrite کرو، selection explain کرو۔ claude-haiku-4-5-20251001 اور gemini-3.5-flash window animation ختم ہونے سے پہلے جواب دے دیتے ہیں، جو وہی احساس ہے جس کی Raycast users توقع رکھتے ہیں۔
• AI Chat sessions اور لمبی drafting claude-sonnet-4-6 یا gpt-5.5 کی حق دار ہیں؛ انہیں fast tier کے ساتھ declare کریں اور picker میں فی-task switch کریں۔
• AI extensions جو tools کال کرتی ہیں انہیں ایک قابلِ بھروسہ tool use والا model چاہیے، اور اس کے مطابق declare کیا گیا abilities block؛ claude-sonnet-4-6 وہاں محفوظ پہلا انتخاب ہے۔
• deepseek-v4-flash ان users کے لیے volume pick ہے جو ہر text field میں AI wire کر دیتے ہیں جسے وہ چھوتے ہیں؛ مسلسل چھوٹی completions جمع ہوتی رہتی ہیں، اور fast tier اس عادت کو balance پر invisible رکھتی ہے۔
• قیاسی طور پر بہت سے models کی بجائے جان بوجھ کر چند models declare کریں: ہر entry picker کی ایک row ہے جسے آپ scroll کر کے گزرتے ہیں، اور جس دن آپ کو ایک اور id چاہیے YAML کو extend کرنا آسان ہے۔

استعمال کے مطابق ادائیگی · سرکاری قیمت سے کم

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Raycast سے مخصوص failure modes۔

BYOK configure کرنا جبکہ آپ کا مطلب Custom Providers تھا سب سے اوپر کی غلطی ہے، اور یہ آپ کی غلطی نہیں: دونوں features ایک search space share کرتی ہیں۔ اگر آپ جس flow میں ہیں وہ vendor key مانگے مگر کبھی URL نہ مانگے، تو آپ BYOK میں ہیں، اور gateway وہاں fit نہیں ہوتا۔ Settings، AI، اور نیچے موجود Custom Providers toggle پر واپس جائیں۔ فائل کا نظر انداز ہونا عموماً مطلب ہے کہ feature toggle off ہے، فائل ابھی بھی providers.template.yaml نام کی ہے، یا YAML میں syntax error ہے، جس صورت میں Raycast کے پاس load کرنے کو کچھ valid نہیں ہوتا اور picker بس کوئی custom models نہیں دکھاتا۔ کسی گہری چیز پر شک کرنے سے پہلے YAML validate کریں۔ کوئی model جو کچھ Raycast features پر error دے مگر باقی پر نہ دے وہ abilities mismatch ہے: tool استعمال کرنے والی AI extensions فیل ہوتی ہیں جبکہ plain chat کام کرتا ہے جب tools ایسے model پر declare کیا گیا ہو جس کے پاس یہ نہ ہو، یا کبھی declare نہ کیا گیا ہو ایسے model پر جس کے پاس یہ ہو۔ size کی بنا پر رد ہونے والی requests ایک overstated context value کی طرف اشارہ کرتی ہیں۔ اور platform کی حد کو ایمانداری سے نوٹ کریں: Custom Providers Mac پر، ایک local config file میں configure ہوتا ہے۔ اگر آپ کے Raycast استعمال کا کچھ حصہ کہیں اور ہے، تو parity فرض کرنے سے پہلے manual میں دیکھیں کہ وہاں feature کیا سپورٹ کرتا ہے۔

Raycast AI کو gateway کے ذریعے کون route کرتا ہے۔

• وہ power users جو launcher میں رہتے ہیں اور تیز کیٹلاگ ids پر quick AI commands چاہتے ہیں بغیر کسی subscription کے یہ فیصلہ کیے کہ وہ کون سے models چھو سکتے ہیں۔
• وہ لوگ جو پہلے سے اپنے editor اور terminal tools کو gateway کے ذریعے route کرتے ہیں اور launcher کو بھی اسی key پر چاہتے ہیں، ہر surface پر ایک ہی usage log۔
• وہ users جو ایسے models چاہتے ہیں جو Raycast کی built-in list نہیں رکھتی، DeepSeek اور GLM ids سمیت، جو ایک بار YAML میں declare ہوں اور app میں ہر جگہ available ہوں۔
• وہ AI-extension builders جنہیں اپنی extension کے پیچھے کوئی مخصوص tool-capable model چاہیے، id سے pin کیا گیا نہ کہ کسی hosted list کا محتاج۔
• وہ developers جن کے پاس کسی مخصوص vendor کی billing تک رسائی نہیں۔ Top-up پر مبنی رسائی بغیر کارڈ کی شرط کے فی-provider sign-up کا انحصار ختم کر دیتی ہے۔

Endpoint verify کریں اور پہلی command debug کریں۔

پہلے models curl چلائیں اور اس کے output سے ids کو YAML میں copy کریں؛ یاد سے ids ٹائپ کرنا یہاں model-not-found errors کی سب سے بڑی وجہ ہے، کیونکہ فائل ہی وہ واحد model source ہے جو Raycast رکھتا ہے۔ پھر toggle enable کریں، تصدیق کریں کہ picker آپ کے declared names دکھا رہا ہے، اور fast model پر ایک quick AI command چلائیں۔ خالی picker toggle، filename، یا YAML syntax کی طرف اشارہ ہے۔ authentication error api_keys block کی طرف اشارہ ہے۔ not-found error ابھی curl کی گئی listing کے خلاف id mismatch ہے۔ ایسی command جو chat میں کام کرے مگر AI extension میں فیل ہو جائے اس model پر abilities declaration کا مسئلہ ہے۔ جب commands چلنے لگیں، APIsRouter console per-request model، token counts، اور spend دکھاتا ہے۔ Launcher AI چند بڑی requests کی بجائے سینکڑوں چھوٹی requests ہے، اور usage log وہی جگہ ہے جہاں یہ pattern ایک number بنتا ہے، فی model، فی دن، اسی صفحے پر جہاں ہر دوسرا tool ہے جسے آپ gateway کے ذریعے route کرتے ہیں۔

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

عمومی سوالات