Pi Agent में third-party API: Base URL, API Key और मॉडल सेटअप

Pi Agent, terminal coding agent Pi है। यह models.json से compatible third-party API से जुड़ता है। इस गाइड में BetterToken का उदाहरण है: API Key, प्रोटोकॉल के अनुसार Base URL और Model ID सेट करें। दूसरे सेवा प्रदाता के लिए उसी सेवा का URL, credentials और मॉडल ID उपयोग करें।

मुख्य सेटिंग्स

फ़ील्ड	मान
API Key	`BETTERTOKEN_API_KEY` environment variable से BetterToken API Key
Base URL	OpenAI प्रोटोकॉल: `https://bettertoken.ai/v1`; Anthropic प्रोटोकॉल: `https://bettertoken.ai`
Model	model plaza का सटीक Model ID
कॉन्फ़िगरेशन फ़ाइल	`~/.pi/agent/models.json`

आवश्यकताएं

Node.js 22.19 या नया।
BetterToken API Key बनाएं और model plaza से tool calling वाला मॉडल चुनें।
Native Windows में Pi के Bash tool के लिए Git for Windows इंस्टॉल करें, या Pi को WSL में चलाएं।

इंस्टॉल करें

Pi का मौजूदा आधिकारिक npm कमांड चलाएं:

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version

मैन्युअल सेटअप

API Key सेट करें

Pi शुरू करने वाले terminal में YOUR_API_KEY को अपनी Key से बदलें:

macOS / Linux
Windows PowerShell

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

$env:BETTERTOKEN_API_KEY="YOUR_API_KEY"

मॉडल प्राप्त करें और कॉन्फ़िगरेशन बनाएं

मॉडल सूची प्राप्त करें पर क्लिक करके API Key दर्ज किए बिना BetterToken का वर्तमान सार्वजनिक कैटलॉग प्राप्त करें। API और टूल कॉलिंग का समर्थन करने वाले मॉडल चुनें, फिर Model ID कॉपी करें या तैयार models.json डाउनलोड करें। यदि models.json पहले से मौजूद है, तो पूरी फ़ाइल बदलने के बजाय बनाई गई bettertoken एंट्री को मौजूदा कॉन्फ़िगरेशन में मिलाएं। कॉन्फ़िगरेशन ऊपर सेट किए गए $BETTERTOKEN_API_KEY का उपयोग करता है; ज़रूरी अतिरिक्त मॉडल पैरामीटर वास्तविक क्षमताओं के अनुसार जोड़ें। Pi कई प्रोटोकॉल का समर्थन करता है; मॉडल और सर्वर द्वारा समर्थित प्रोटोकॉल चुनें। इस सेटअप में Claude के लिए Anthropic Messages, सर्वर के समर्थन पर GPT के लिए Responses, और अन्य OpenAI-संगत मॉडलों के लिए Chat Completions की सलाह है। चयनकर्ता में Chat Completions डिफ़ॉल्ट है और सूची सार्वजनिक कैटलॉग में घोषित API के अनुसार फ़िल्टर होती है। Responses में मॉडल न दिखे तो पुष्टि किए गए Responses समर्थन वाले मॉडल के लिए नीचे का मैन्युअल उदाहरण उपयोग करें।

URL और मॉडल जोड़ें

~/.pi/agent/models.json बनाएं। Windows में डिफ़ॉल्ट पथ %USERPROFILE%\.pi\agent\models.json है। फ़ाइल पहले से हो तो उसके मौजूदा providers object में bettertoken entry जोड़ें। बनाए गए कॉन्फ़िगरेशन के विकल्प के रूप में, नीचे दिया गया Responses API उदाहरण मैन्युअल रूप से भरें। YOUR_MODEL_ID को model plaza की ID से बदलें; $BETTERTOKEN_API_KEY को environment variable reference के रूप में रखें:

{
  "providers": {
    "bettertoken": {
      "baseUrl": "https://bettertoken.ai/v1",
      "api": "openai-responses",
      "apiKey": "$BETTERTOKEN_API_KEY",
      "models": [{ "id": "YOUR_MODEL_ID" }]
    }
  }
}

दूसरी API के लिए baseUrl और api दोनों को सही जोड़ी में बदलें:

API	`api`	`baseUrl`
Responses API	`openai-responses`	`https://bettertoken.ai/v1`
Chat Completions	`openai-completions`	`https://bettertoken.ai/v1`
Anthropic Messages	`anthropic-messages`	`https://bettertoken.ai`

अपने मॉडल की tool calling का समर्थन करने वाली API चुनें। उदाहरण के लिए GPT-6.1 Sol, Responses उपयोग करता है। Base URL को तालिका के अनुसार रखें; Pi request path जोड़ता है।

Pi शुरू करें

Project directory में अपना configured Model ID देकर चलाएं:

pi --provider bettertoken --model YOUR_MODEL_ID

नए terminal में variable फिर सेट करें, या shell configuration में सहेजें।

कनेक्शन सत्यापित करें

pi --list-models चलाकर देखें कि bettertoken और आपका मॉडल दिखाई दे रहे हैं। फिर Pi शुरू करके भेजें:

Reply with PI_OK only. Do not use tools.

PI_OK मिलने के बाद एक छोटा read-only कार्य देकर tool calling भी जांचें।

मॉडल बदलें

models array में entries जोड़ें और Pi में /model चलाएं। यह models.json को दोबारा पढ़ता है। मॉडल चुनकर Ctrl+S दबाएं ताकि नई sessions के लिए default बन जाए। अलग प्रोटोकॉल के endpoints के लिए अलग local names और उनके अपने api तथा baseUrl रखें।

सामान्य त्रुटियां

समस्या	समाधान
मॉडल सूची में नहीं है	JSON, Model ID और environment variable जांचें; `/model` फिर खोलें।
`401` या `Unauthorized`	Variable में valid BetterToken API Key जांचें और Pi को उसी terminal से शुरू करें।
`404` या गलत URL	तालिका से `api` और `baseUrl` मिलाएं। हाथ से जोड़े गए `/responses`, `/chat/completions` या `/v1/messages` हटाएं।
Text आता है लेकिन tools विफल होते हैं	मॉडल और API का tool support जांचें; Responses मांगने वाले मॉडल के लिए `openai-responses` उपयोग करें।
Windows में Bash नहीं मिलता	Git for Windows इंस्टॉल कर terminal दोबारा खोलें, या Pi Windows गाइड के अनुसार `shellPath` सेट करें।

उन्नत सेटअप

Images, reasoning levels या बड़े context के लिए मॉडल की वास्तविक क्षमताओं के अनुसार input, reasoning, contextWindow और maxTokens सेट करें। मॉडल चयन गाइड देखें।

तकनीकी विवरण

providers और --provider, Pi client के configuration fields हैं; bettertoken इस उदाहरण का local name है। Pi पहले --api-key, फिर auth.json में saved credentials और उसके बाद models.json का apiKey उपयोग करता है। उसी नाम के पुराने credentials हों तो Pi में /logout से संबंधित entry हटाकर फिर कनेक्ट करें।

शुरू करें

Coding Agent सेटअप

AI एप्लिकेशन प्लेटफ़ॉर्म सेटअप

उन्नत

Pi Agent में third-party API: Base URL, API Key और मॉडल सेटअप

मुख्य सेटिंग्स

आवश्यकताएं

इंस्टॉल करें

मैन्युअल सेटअप

API Key सेट करें

मॉडल प्राप्त करें और कॉन्फ़िगरेशन बनाएं

URL और मॉडल जोड़ें

Pi शुरू करें

कनेक्शन सत्यापित करें

मॉडल बदलें

सामान्य त्रुटियां

उन्नत सेटअप

तकनीकी विवरण

Pi के आधिकारिक संदर्भ

​मुख्य सेटिंग्स

​आवश्यकताएं

​इंस्टॉल करें

​मैन्युअल सेटअप

​API Key सेट करें

​मॉडल प्राप्त करें और कॉन्फ़िगरेशन बनाएं

​URL और मॉडल जोड़ें

​Pi शुरू करें

​कनेक्शन सत्यापित करें

​मॉडल बदलें

​सामान्य त्रुटियां

​उन्नत सेटअप

​तकनीकी विवरण

​Pi के आधिकारिक संदर्भ

मुख्य सेटिंग्स

आवश्यकताएं

इंस्टॉल करें

मैन्युअल सेटअप

API Key सेट करें

मॉडल प्राप्त करें और कॉन्फ़िगरेशन बनाएं

URL और मॉडल जोड़ें

Pi शुरू करें

कनेक्शन सत्यापित करें

मॉडल बदलें

सामान्य त्रुटियां

उन्नत सेटअप

तकनीकी विवरण

Pi के आधिकारिक संदर्भ