Naar hoofdinhoud gaan
De CometAPI CLI leest instellingen uit een TOML-configuratiebestand, omgevingsvariabelen en commandoregelopties. Wanneer dezelfde instelling uit meerdere bronnen beschikbaar is, is de prioriteitsvolgorde: CLI-vlaggen > configuratiebestand > omgevingsvariabelen > standaardwaarden

Configuratiebestand

Locatie: ~/.config/cometapi/config.toml Voer de installatiewizard uit om het configuratiebestand interactief aan te maken:
cometapi init
Of beheer afzonderlijke instellingen met de subopdracht config:
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

Beschikbare instellingen

Config keyEnvironment variableBeschrijving
api_keyCOMETAPI_KEYAPI-sleutel (vereist voor alle opdrachten)
access_tokenCOMETAPI_ACCESS_TOKENAccess token voor opdrachten op accountniveau
base_urlCOMETAPI_BASE_URLAPI-basis-URL (standaard: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELStandaardmodel voor chat (fallback: gpt-5.4)
output_formatStandaard uitvoerformaat: table, json, yaml, csv of markdown

Inloggegevens

De CLI gebruikt twee soorten inloggegevens:

API key

Vereist voor alle opdrachten. De API-sleutel authenticeert verzoeken naar de CometAPI-modelendpoints. Maak een API-sleutel aan via CometAPI Console → API Keys. Stel deze op een van de volgende manieren in:
export COMETAPI_KEY="<COMETAPI_KEY>"

Access token

Optioneel. De access token is vereist voor opdrachten op accountniveau: account, stats, tokens, logs en tasks. Genereer een access token via CometAPI Console → Personal Settings. Stel deze op een van de volgende manieren in:
export COMETAPI_ACCESS_TOKEN="your-access-token"

Beveiliging

De CLI past de volgende beveiligingspraktijken toe:
  • API-sleutels en access tokens worden nooit gelogd of volledig weergegeven. Alleen de laatste 4 tekens worden getoond in diagnostische uitvoer.
  • Het configuratiebestand wordt aangemaakt met beperkende machtigingen (0600) — alleen leesbaar voor de eigenaar van het bestand.
  • Inloggegevens mogen nooit in versiebeheer worden vastgelegd. Voeg het pad van het configuratiebestand toe aan je .gitignore indien van toepassing.
Je bent verantwoordelijk voor al het gebruik en alle kosten die met je API-sleutels worden gemaakt. Houd je sleutels veilig en roteer ze als je vermoedt dat er ongeautoriseerde toegang is geweest.

Probleemoplossing

ErrorSolution
API key not configuredVoer cometapi init uit of stel de omgevingsvariabele COMETAPI_KEY in
Connection failedVoer cometapi doctor uit om de connectiviteit te diagnosticeren
Access token not configuredAlleen nodig voor account/stats/tokens/logs/tasks. Voer cometapi init uit om er een toe te voegen