> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Pi gebruiken met CometAPI

> Gebruik deze handleiding om Pi met CometAPI te configureren door de base URL, API key en model- of provideropties in te stellen.

[Pi](https://github.com/earendil-works/pi) is het Pi Agent Harness-project. Het pakket `@earendil-works/pi-coding-agent` biedt een interactieve coding agent-CLI met bestands-, shell-, edit-, write-, session-, print-, JSON-, RPC- en SDK-workflows. Pi kan aangepaste providers laden vanuit `~/.pi/agent/models.json`, zodat je CometAPI kunt toevoegen als OpenAI-compatible provider-vermeldingen zonder de broncode van Pi te wijzigen.

Officiële referenties:

* [Pi repository](https://github.com/earendil-works/pi)
* [Pi quickstart](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/quickstart.md)
* [Pi providers](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/providers.md)
* [Pi custom models](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md)
* [Pi CLI usage](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/usage.md)

<Note>
  Beschikbaarheid van modellen verandert in de loop van de tijd. Vervang `your-model-id` door een beschikbaar model ID van de [CometAPI Models page](/nl/overview/models).
</Note>

## Vereisten

* Node.js `>=22.19.0`
* npm
* Een CometAPI-account met een actieve API key uit het [dashboard](https://www.cometapi.com/console/token)
* Pi geïnstalleerd vanuit het officiële npm-pakket

## Runtime-machtigingen begrijpen

Pi draait met de machtigingen van de gebruiker en het proces die het starten. Start Pi in de projectmap waarop het moet werken, houd een rollback-pad zoals git beschikbaar, en gebruik een container of sandbox als je sterkere grenzen nodig hebt voor bestandssysteem, processen, netwerk of credentials.

## Configureer de provider

<Steps>
  <Step title="Installeer Pi">
    Installeer Pi globaal met npm:

    ```bash theme={null}
    npm install -g --ignore-scripts @earendil-works/pi-coding-agent
    ```

    Bevestig dat de CLI beschikbaar is:

    ```bash theme={null}
    pi --version
    ```
  </Step>

  <Step title="Stel je CometAPI API-sleutel in">
    Sla je CometAPI API-sleutel op in de omgevingsvariabele `COMETAPI_KEY`:

    ```bash theme={null}
    read -rsp "CometAPI API key: " COMETAPI_KEY
    printf '\n'
    export COMETAPI_KEY
    ```

    Voeg het exportcommando toe aan je shellprofiel als je wilt dat het behouden blijft tussen terminalsessies. Commit geen API-sleutels naar versiebeheer.
  </Step>

  <Step title="Voeg CometAPI-providers toe aan models.json">
    Maak `~/.pi/agent/models.json` aan als het nog niet bestaat. Als het bestand al providers bevat, voeg dan de items `cometapi-responses` en `cometapi-chat` samen in het bestaande object `providers`:

    ```json theme={null}
    {
      "providers": {
        "cometapi-responses": {
          "name": "CometAPI Responses",
          "baseUrl": "https://api.cometapi.com/v1",
          "api": "openai-responses",
          "apiKey": "$COMETAPI_KEY",
          "models": [
            {
              "id": "your-model-id",
              "name": "CometAPI Responses model"
            }
          ]
        },
        "cometapi-chat": {
          "name": "CometAPI Chat Completions",
          "baseUrl": "https://api.cometapi.com/v1",
          "api": "openai-completions",
          "apiKey": "$COMETAPI_KEY",
          "models": [
            {
              "id": "your-model-id",
              "name": "CometAPI Chat model"
            }
          ]
        }
      }
    }
    ```

    Gebruik `cometapi-responses` voor modellen of workflows die de OpenAI Responses API vereisen. Gebruik `cometapi-chat` voor modellen die compatibel zijn met OpenAI Chat Completions. Pi verwerkt `$COMETAPI_KEY` op het moment van de request. Bewaar de API-sleutel in je omgeving of in je eigen secrets-workflow.
  </Step>

  <Step title="Verifieer beide providers">
    Geef de modellen weer die Pi kan zien voor de Responses-provider:

    ```bash theme={null}
    pi --list-models cometapi-responses
    ```

    Voer een korte eenmalige prompt uit met de Responses-provider:

    ```bash theme={null}
    pi --provider cometapi-responses --model your-model-id -p "Reply with one short sentence confirming the Responses connection."
    ```

    Geef de modellen weer die Pi kan zien voor de Chat Completions-provider:

    ```bash theme={null}
    pi --list-models cometapi-chat
    ```

    Voer een korte eenmalige prompt uit met de Chat Completions-provider:

    ```bash theme={null}
    pi --provider cometapi-chat --model your-model-id -p "Reply with one short sentence confirming the Chat Completions connection."
    ```

    Voor interactief gebruik start je Pi in je project en selecteer je de CometAPI-provider en het model met `/model`. Als je `models.json` bewerkt tijdens een interactieve sessie, open dan `/model` opnieuw zodat Pi de aangepaste modelitems opnieuw laadt.
  </Step>
</Steps>

## Probleemoplossing

<AccordionGroup>
  <Accordion title="Pi toont het CometAPI-model niet">
    Bevestig dat `~/.pi/agent/models.json` geldige JSON is en dat elke provider-vermelding zich binnen het bovenliggende object `providers` bevindt. Voer `pi --list-models cometapi-responses` of `pi --list-models cometapi-chat` uit nadat je het bestand hebt opgeslagen.
  </Accordion>

  <Accordion title="Pi meldt dat er geen API-sleutel beschikbaar is">
    Bevestig dat `COMETAPI_KEY` is ingesteld in dezelfde shellsessie waarmee Pi wordt gestart. Als je een shellprofiel gebruikt, open dan een nieuwe terminal of laad het profiel voordat je Pi uitvoert.
  </Accordion>

  <Accordion title="Verzoeken mislukken vanwege de base URL">
    Gebruik `https://api.cometapi.com/v1` als de `baseUrl` in `models.json`. Laat Pi niet verwijzen naar de dashboard-URL en laat het achtervoegsel `/v1` niet weg voor OpenAI-compatibele routes.
  </Accordion>

  <Accordion title="Pi faalt voordat een modelverzoek wordt verzonden">
    Controleer je Node.js-versie met `node --version`. Het Pi-pakket vereist Node.js `>=22.19.0`.
  </Accordion>

  <Accordion title="Het model werkt op de ene route maar niet op de andere">
    Gebruik de provider-vermelding waarvan het veld `api` overeenkomt met de route die je model ondersteunt. `openai-responses` gebruikt de Responses API, terwijl `openai-completions` Chat Completions gebruikt.
  </Accordion>

  <Accordion title="Pi heeft meer toegang dan verwacht">
    Pi draait met de rechten van de gebruiker en het proces waarmee het is gestart. Voer Pi uit binnen een container of sandbox wanneer je sterkere afbakening nodig hebt rond bestanden, processen, netwerktoegang of credentials.
  </Accordion>
</AccordionGroup>

## Gerelateerde bronnen

* [CometAPI-snelstart](/nl/overview/quick-start)
* [CometAPI Models-pagina](/nl/overview/models)
* [Pi aangepaste modellen](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md)
* [Pi CLI-gebruik](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/usage.md)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/pi#howto",
        "name": "Pi gebruiken met CometAPI",
        "description": "Gebruik deze handleiding om Pi met CometAPI te configureren door de base URL, API key en model- of provideropties in te stellen.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-1",
            "position": 1,
            "name": "Pi installeren",
            "text": "Voltooi de stap Pi installeren in de handleiding Pi gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-2",
            "position": 2,
            "name": "Stel je CometAPI API key in",
            "text": "Sla je CometAPI API key op in de omgevingsvariabele of het instellingenveld dat door de integratie wordt gebruikt."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-3",
            "position": 3,
            "name": "Voeg CometAPI-providers toe aan models.json",
            "text": "Voltooi de stap CometAPI-providers toevoegen aan models.json in de handleiding Pi gebruiken met CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/pi#step-4",
            "position": 4,
            "name": "Verifieer beide providers",
            "text": "Voltooi de stap Beide providers verifiëren in de handleiding Pi gebruiken met CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI-documentatie",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integraties",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Pi gebruiken met CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/pi"
          }
        ]
      }
    ]
    }
    `}
</script>