> ## Documentation Index > Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt > Use this file to discover all available pages before exploring further. # Pi Agent : API tierce, Base URL, clé API et modèles > Connectez Pi Agent à une API tierce avec models.json, Base URL, clé API et Model ID. Choisissez le protocole, vérifiez la connexion et corrigez les erreurs. export const PiModelPicker = ({locale = "en", plazaUrl = "https://bettertoken.ai/pricing"}) => { const translations = { en: { get: "Get model list", refresh: "Refresh model list", loading: "Loading models...", api: "API", search: "Search models", models: "Models", selected: "Selected", select: "Select", copyId: "Copy Model ID", copyConfig: "Copy configuration", download: "Download models.json", copied: "Copied", copyError: "Copy failed. Select and copy the text below.", error: "Could not load models. Try again or open the model plaza.", empty: "No matching models.", plaza: "Model plaza", config: "Pi configuration", selectAll: "Select all visible models" }, zh: { get: "获取模型列表", refresh: "刷新模型列表", loading: "正在获取模型...", api: "接口", search: "搜索模型", models: "模型", selected: "已选择", select: "选择", copyId: "复制 Model ID", copyConfig: "复制配置", download: "下载 models.json", copied: "已复制", copyError: "复制失败，请选中下方文本复制。", error: "暂时无法获取模型，请重试或前往模型广场。", empty: "没有匹配的模型。", plaza: "模型广场", config: "Pi 配置", selectAll: "选择当前显示的全部模型" }, ru: { get: "Получить список моделей", refresh: "Обновить список моделей", loading: "Загрузка моделей...", api: "API", search: "Поиск моделей", models: "Модели", selected: "Выбрано", select: "Выбрать", copyId: "Скопировать Model ID", copyConfig: "Скопировать настройки", download: "Скачать models.json", copied: "Скопировано", copyError: "Не удалось скопировать. Выделите и скопируйте текст ниже.", error: "Не удалось загрузить модели. Повторите попытку или откройте каталог моделей.", empty: "Подходящих моделей нет.", plaza: "Каталог моделей", config: "Настройки Pi", selectAll: "Выбрать все показанные модели" }, hi: { get: "मॉडल सूची प्राप्त करें", refresh: "मॉडल सूची रीफ़्रेश करें", loading: "मॉडल लोड हो रहे हैं...", api: "API", search: "मॉडल खोजें", models: "मॉडल", selected: "चुने गए", select: "चुनें", copyId: "Model ID कॉपी करें", copyConfig: "कॉन्फ़िगरेशन कॉपी करें", download: "models.json डाउनलोड करें", copied: "कॉपी हो गया", copyError: "कॉपी नहीं हो सका। नीचे दिए गए टेक्स्ट को चुनकर कॉपी करें।", error: "मॉडल लोड नहीं हो सके। फिर से प्रयास करें या मॉडल कैटलॉग खोलें।", empty: "कोई मेल खाने वाला मॉडल नहीं मिला।", plaza: "मॉडल कैटलॉग", config: "Pi कॉन्फ़िगरेशन", selectAll: "दिखाए गए सभी मॉडल चुनें" }, es: { get: "Obtener lista de modelos", refresh: "Actualizar lista de modelos", loading: "Cargando modelos...", api: "API", search: "Buscar modelos", models: "Modelos", selected: "Seleccionados", select: "Seleccionar", copyId: "Copiar Model ID", copyConfig: "Copiar configuración", download: "Descargar models.json", copied: "Copiado", copyError: "No se pudo copiar. Selecciona y copia el texto de abajo.", error: "No se pudieron cargar los modelos. Inténtalo de nuevo o abre el catálogo.", empty: "No hay modelos coincidentes.", plaza: "Catálogo de modelos", config: "Configuración de Pi", selectAll: "Seleccionar todos los modelos visibles" }, "pt-br": { get: "Obter lista de modelos", refresh: "Atualizar lista de modelos", loading: "Carregando modelos...", api: "API", search: "Buscar modelos", models: "Modelos", selected: "Selecionados", select: "Selecionar", copyId: "Copiar Model ID", copyConfig: "Copiar configuração", download: "Baixar models.json", copied: "Copiado", copyError: "Não foi possível copiar. Selecione e copie o texto abaixo.", error: "Não foi possível carregar os modelos. Tente novamente ou abra o catálogo.", empty: "Nenhum modelo correspondente.", plaza: "Catálogo de modelos", config: "Configuração do Pi", selectAll: "Selecionar todos os modelos visíveis" }, ja: { get: "モデル一覧を取得", refresh: "モデル一覧を更新", loading: "モデルを取得中...", api: "API", search: "モデルを検索", models: "モデル", selected: "選択済み", select: "選択", copyId: "Model ID をコピー", copyConfig: "設定をコピー", download: "models.json をダウンロード", copied: "コピーしました", copyError: "コピーできませんでした。下のテキストを選択してコピーしてください。", error: "モデルを取得できませんでした。再試行するか、モデルカタログを開いてください。", empty: "一致するモデルがありません。", plaza: "モデルカタログ", config: "Pi の設定", selectAll: "表示中のモデルをすべて選択" }, fr: { get: "Obtenir la liste des modèles", refresh: "Actualiser les modèles", loading: "Chargement des modèles...", api: "API", search: "Rechercher des modèles", models: "Modèles", selected: "Sélectionnés", select: "Sélectionner", copyId: "Copier le Model ID", copyConfig: "Copier la configuration", download: "Télécharger models.json", copied: "Copié", copyError: "La copie a échoué. Sélectionnez et copiez le texte ci-dessous.", error: "Impossible de charger les modèles. Réessayez ou ouvrez le catalogue.", empty: "Aucun modèle correspondant.", plaza: "Catalogue de modèles", config: "Configuration de Pi", selectAll: "Sélectionner tous les modèles affichés" }, de: { get: "Modellliste abrufen", refresh: "Modellliste aktualisieren", loading: "Modelle werden geladen...", api: "API", search: "Modelle suchen", models: "Modelle", selected: "Ausgewählt", select: "Auswählen", copyId: "Model ID kopieren", copyConfig: "Konfiguration kopieren", download: "models.json herunterladen", copied: "Kopiert", copyError: "Kopieren fehlgeschlagen. Markiere und kopiere den Text unten.", error: "Modelle konnten nicht geladen werden. Versuche es erneut oder öffne den Modellkatalog.", empty: "Keine passenden Modelle.", plaza: "Modellkatalog", config: "Pi-Konfiguration", selectAll: "Alle angezeigten Modelle auswählen" }, ko: { get: "모델 목록 가져오기", refresh: "모델 목록 새로고침", loading: "모델을 가져오는 중...", api: "API", search: "모델 검색", models: "모델", selected: "선택됨", select: "선택", copyId: "Model ID 복사", copyConfig: "설정 복사", download: "models.json 다운로드", copied: "복사됨", copyError: "복사하지 못했습니다. 아래 텍스트를 선택하여 복사하세요.", error: "모델을 가져오지 못했습니다. 다시 시도하거나 모델 카탈로그를 여세요.", empty: "일치하는 모델이 없습니다.", plaza: "모델 카탈로그", config: "Pi 설정", selectAll: "표시된 모든 모델 선택" } }; const t = translations[locale] || translations.en; const protocols = { "openai-responses": { label: "Responses", endpoint: "openai-response", baseUrl: "https://bettertoken.ai/v1" }, "openai-completions": { label: "Chat Completions", endpoint: "openai", baseUrl: "https://bettertoken.ai/v1" }, "anthropic-messages": { label: "Anthropic Messages", endpoint: "anthropic", baseUrl: "https://bettertoken.ai" } }; const [models, setModels] = useState(null); const [api, setApi] = useState("openai-completions"); const [search, setSearch] = useState(""); const [selected, setSelected] = useState([]); const [loading, setLoading] = useState(false); const [error, setError] = useState(false); const [feedback, setFeedback] = useState(""); const request = useRef(null); const protocolGroup = useId(); useEffect(() => () => { request.current?.abort(); request.current = null; }, []); const eligible = (models || []).filter(model => model.endpoints.includes(protocols[api].endpoint)); const visible = eligible.filter(model => model.id.toLowerCase().includes(search.trim().toLowerCase())); const chosen = eligible.filter(model => selected.includes(model.id)); const configuration = JSON.stringify({ providers: { bettertoken: { baseUrl: protocols[api].baseUrl, api, apiKey: "$BETTERTOKEN_API_KEY", models: chosen.map(model => ({ id: model.id })) } } }, null, 2); const loadModels = async () => { if (request.current) return; const controller = new AbortController(); request.current = controller; setLoading(true); setError(false); setFeedback(""); const timer = setTimeout(() => controller.abort(), 15000); try { const response = await fetch("https://bettertoken.ai/api/pricing", { credentials: "omit", cache: "no-store", headers: { Accept: "application/json" }, signal: controller.signal }); if (!response.ok) throw new Error("Catalog request failed"); const body = await response.json(); if (body.success !== true || !Array.isArray(body.data)) throw new Error("Invalid catalog"); const catalog = new Map(); for (const entry of body.data) { if (typeof entry?.model_name !== "string" || !entry.model_name.trim() || !Array.isArray(entry.supported_endpoint_types)) continue; if ((/^(?:nano-banana-|gpt-image-)/i).test(entry.model_name)) continue; if (entry.supported_endpoint_types.some(endpoint => ["image-generation", "openai-video", "embeddings", "jina-rerank"].includes(endpoint))) continue; const endpoints = entry.supported_endpoint_types.filter(endpoint => Object.values(protocols).some(protocol => protocol.endpoint === endpoint)); if (!endpoints.length) continue; const previous = catalog.get(entry.model_name); catalog.set(entry.model_name, { id: entry.model_name, endpoints: Array.from(new Set([...previous?.endpoints || [], ...endpoints])) }); } const next = Array.from(catalog.values()).sort((a, b) => a.id.localeCompare(b.id, "en")); if (request.current !== controller) return; setModels(next); setSelected(current => current.filter(id => next.some(model => model.id === id && model.endpoints.includes(protocols[api].endpoint)))); } catch { if (request.current === controller) setError(true); } finally { clearTimeout(timer); if (request.current === controller) { request.current = null; setLoading(false); } } }; const copy = async value => { try { await navigator.clipboard.writeText(value); setFeedback(t.copied); } catch { setFeedback(t.copyError); } }; const download = () => { const url = URL.createObjectURL(new Blob([configuration + "\n"], { type: "application/json" })); const link = document.createElement("a"); link.href = url; link.download = "models.json"; link.click(); setTimeout(() => URL.revokeObjectURL(url), 1000); }; return
{t.api}
{Object.entries(protocols).map(([value, protocol]) => )}
{error &&

{t.error} {t.plaza}

} {models !== null &&

{t.models}: {visible.length} / {eligible.length} · {t.selected}: {chosen.length}

{visible.map(model => )}
0 && visible.every(model => selected.includes(model.id))} onChange={event => setSelected(current => event.target.checked ? Array.from(new Set([...current, ...visible.map(model => model.id)])) : current.filter(id => !visible.some(model => model.id === id)))} /> Model ID
setSelected(current => event.target.checked ? [...current, model.id] : current.filter(id => id !== model.id))} /> {model.id}
{!visible.length &&

{t.empty}

}
{chosen.length > 0 &&
{t.config} 
{configuration}
}
}

{feedback}

; }; Pi Agent, l’agent de développement en terminal Pi, se connecte aux API tierces compatibles via `models.json`. Cet exemple utilise BetterToken : définissez la clé, la Base URL du protocole et le Model ID. Pour un autre service, utilisez son URL, ses identifiants et ses modèles. ## Paramètres principaux | Champ | Valeur | | - | - | | API Key | BetterToken API Key via la variable `BETTERTOKEN_API_KEY` | | Base URL | Protocole OpenAI : `https://bettertoken.ai/v1` ; protocole Anthropic : `https://bettertoken.ai` | | Model | Le Model ID exact de la model plaza | | Fichier de configuration | `~/.pi/agent/models.json` | ## Prérequis * Node.js 22.19 ou une version ultérieure. * Créez une BetterToken API Key et choisissez un modèle prenant en charge les appels d’outils dans la model plaza. * Sous Windows natif, installez [Git for Windows](https://git-scm.com/downloads/win) pour l’outil Bash de Pi, ou lancez Pi dans WSL. ## Installation Utilisez la commande npm officielle actuelle de Pi : ```bash theme={null} npm install -g --ignore-scripts @earendil-works/pi-coding-agent pi --version ``` ## Configuration manuelle ### Définir la clé API Dans le terminal qui lancera Pi, remplacez `YOUR_API_KEY` par votre clé : ```bash theme={null} export BETTERTOKEN_API_KEY="YOUR_API_KEY" ``` ```powershell theme={null} $env:BETTERTOKEN_API_KEY="YOUR_API_KEY" ``` ### Obtenir les modèles et générer la configuration Cliquez sur **Obtenir la liste des modèles** pour consulter le catalogue public actuel de BetterToken sans saisir de clé API. Choisissez une API et des modèles compatibles avec les appels d’outils, puis copiez un Model ID ou téléchargez le fichier `models.json` généré. Si `models.json` existe déjà, fusionnez l’entrée `bettertoken` générée avec votre configuration au lieu de remplacer le fichier. La configuration utilise la variable `$BETTERTOKEN_API_KEY` définie ci-dessus ; ajoutez les autres paramètres selon les capacités réelles du modèle. Pi prend en charge plusieurs protocoles : choisissez celui que le modèle et le serveur acceptent. Pour cette connexion, nous recommandons **Anthropic Messages** pour Claude, **Responses** pour GPT si le serveur le permet, et **Chat Completions** pour les autres modèles compatibles OpenAI. Le sélecteur utilise Chat Completions par défaut et filtre les API déclarées dans le catalogue public. Si votre modèle ne figure pas sous Responses, utilisez l’exemple manuel ci-dessous pour les modèles dont la prise en charge de Responses est confirmée. ### Ajouter l’URL et le modèle Créez `~/.pi/agent/models.json`. Sous Windows, le chemin par défaut est `%USERPROFILE%\.pi\agent\models.json`. Si le fichier existe, ajoutez l’entrée `bettertoken` à son objet `providers` existant. Vous pouvez aussi remplir manuellement cet exemple d’API Responses au lieu d’utiliser la configuration générée. Remplacez `YOUR_MODEL_ID` par un ID de la model plaza ; conservez `$BETTERTOKEN_API_KEY` comme référence à la variable : ```json theme={null} { "providers": { "bettertoken": { "baseUrl": "https://bettertoken.ai/v1", "api": "openai-responses", "apiKey": "$BETTERTOKEN_API_KEY", "models": [{ "id": "YOUR_MODEL_ID" }] } } } ``` Pour une autre API, modifiez ensemble `baseUrl` et `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` | Choisissez une API permettant les appels d’outils pour votre modèle. Par exemple, GPT-6.1 Sol utilise Responses. Conservez la Base URL indiquée ; Pi ajoute le chemin de la requête. ### Lancer Pi Depuis le dossier du projet, utilisez le Model ID configuré : ```bash theme={null} pi --provider bettertoken --model YOUR_MODEL_ID ``` Redéfinissez la variable dans chaque nouveau terminal ou enregistrez-la dans la configuration du shell. ## Vérifier la connexion Lancez `pi --list-models` et vérifiez que `bettertoken` et votre modèle apparaissent. Démarrez ensuite Pi et envoyez : ```text theme={null} Reply with PI_OK only. Do not use tools. ``` Après réception de `PI_OK`, essayez une petite tâche en lecture seule pour vérifier les appels d’outils. ## Changer de modèle Ajoutez des entrées au tableau `models`, puis lancez `/model` dans Pi pour relire `models.json`. Sélectionnez un modèle et appuyez sur `Ctrl+S` pour le définir par défaut pour les nouvelles sessions. Utilisez des noms locaux distincts pour des protocoles différents, chacun avec ses propres `api` et `baseUrl`. ## Erreurs fréquentes | Symptôme | Solution | | - | - | | Le modèle n’apparaît pas | Vérifiez le JSON, le Model ID et la variable d’environnement ; rouvrez `/model`. | | `401` ou `Unauthorized` | Vérifiez la validité de la BetterToken API Key et lancez Pi depuis le terminal où la variable est définie. | | `404` ou URL incorrecte | Faites correspondre `api` et `baseUrl` selon le tableau. Retirez `/responses`, `/chat/completions` ou `/v1/messages` ajoutés manuellement. | | Le texte fonctionne, les outils échouent | Vérifiez les capacités du modèle et de l’API ; choisissez `openai-responses` si le modèle exige Responses. | | Bash introuvable sous Windows | Installez Git for Windows puis rouvrez le terminal, ou définissez `shellPath` selon le guide Windows de Pi. | ## Configuration avancée Pour les images, les niveaux de raisonnement ou un contexte plus long, définissez `input`, `reasoning`, `contextWindow` et `maxTokens` selon les capacités réelles du modèle. Consultez le [guide de sélection des modèles](/fr/faq/model-calling/model-selection-guide). ## Détails techniques `providers` et `--provider` sont des champs de configuration de Pi ; `bettertoken` est le nom local de cet exemple. Pi utilise d’abord `--api-key`, puis les identifiants enregistrés dans `auth.json`, puis `apiKey` dans `models.json`. Si ce nom possède d’anciens identifiants, supprimez l’entrée correspondante via `/logout` dans Pi avant de vous reconnecter. ### Références officielles de Pi * [Installation et démarrage rapide](https://pi.dev/docs/latest/quickstart) * [URL et modèles personnalisés](https://pi.dev/docs/latest/models#configure-a-compatible-endpoint) * [Référence de la ligne de commande](https://pi.dev/docs/latest/cli) * [Configuration Windows](https://pi.dev/docs/latest/windows) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.