Opdrachtreferentie

Gebruik cometapi -h of cometapi <command> -h om de exacte argumenten en opties voor de geïnstalleerde versie te bekijken.

Overzicht van opdrachten

Command	Description	Auth
`chat [MESSAGE]`	Verzend een chatbericht of start de chat REPL	API key
`models`	Toon en filter metadata van de modelcatalogus	API key
`model info <id>`	Bekijk de openbare metadata van één model	API key
`run [MODEL]`	Verzend één request via chat-, responses-, anthropic- of gemini-formaten	API key
`balance`	Toon het accountsaldo of het saldo van de huidige API key	API key or access token
`account`	Toon het accountprofiel	Access token
`stats`	Toon gebruiksstatistieken	Access token
`tokens`	Toon en doorzoek API keys	Access token
`logs`	Blader door gebruikslogs met filters	Access token
`tasks`	Toon logs van async taken	Access token
`init`	Voer de installatiewizard uit	None
`doctor`	Voer diagnostiek uit	API key
`config`	Beheer lokale configuratie	None
`repl`	Start een interactieve opdrachtshell	Depends on command used

Opdrachten gemarkeerd met Access token vereisen de omgevingsvariabele COMETAPI_ACCESS_TOKEN of de configuratiesleutel access_token. Zie de configuratiegids voor details.

Chat

Verzend één bericht of start de chat REPL met meerdere beurten.

cometapi chat "Explain CometAPI in one sentence."
cometapi chat "Summarize this" --model your-model-id --system "Be concise."
cometapi chat "Hello" --no-stream
cometapi chat "Hello" --json
cometapi chat

Option	Short	Description
`--model`	`-m`	Te gebruiken model
`--system`	`-s`	Systeemprompt
`--temperature`	`-t`	Sampling temperature
`--max-tokens`		Maximum response tokens
`--stream/--no-stream`		Streaming in- of uitschakelen
`--format`	`-f`	Uitvoerformaat
`--json`		Uitvoer als JSON

Models

Toon standaard modellen uit de openbare catalogus. De catalogusuitvoer bevat model ID, provider, modeltype, features, endpoints, prijzen, contextlengte en maximale completion tokens.

cometapi models
cometapi models --search gpt --limit 10
cometapi models --provider openai --type chat --limit 10
cometapi models --feature image --endpoint responses --json
cometapi models --refresh
cometapi models --source openai --search gpt

Option	Short	Description
`--search`	`-s`	Filter op ID, code, naam, beschrijving of provider
`--provider`		Filter op providernaam of -code
`--type`, `--modality`		Filter op modeltype of modaliteit
`--feature`, `--capability`		Filter op feature of capability
`--endpoint`		Filter op endpointnaam, methode of pad
`--limit`	`-l`	Maximum aantal resultaten
`--source`		Gebruik `catalog`-metadata of OpenAI-compatibele `openai`-lijst
`--refresh`		Vernieuw de cataloguscache van één uur
`--no-cache`		Omzeil de cataloguscache voor deze opdracht
`--format`	`-f`	Uitvoerformaat
`--json`		Uitvoer als JSON

De cataloguscache wordt opgeslagen in ~/.cache/cometapi/models.json.

Model info

Inspecteer openbare metadata voor één model. Het commando resolveert het model via de openbare catalogus en laadt vervolgens detailmetadata voor de cataloguscode.

cometapi model info your-model-id
cometapi model info your-model-id --json
cometapi model info your-model-id --refresh

Option	Short	Description
`--refresh`		Vernieuw de cataloguscache vóór het opzoeken
`--no-cache`		Omzeil de cataloguscache voor dit commando
`--format`	`-f`	Uitvoerformaat
`--json`		Geef ruwe modeldetail-JSON weer

De tabeluitvoer bevat provider, modeltype, features, endpoints, prijzen, contextlengte, maximum completion tokens, documentatie-URL en overzicht.

Run

Verstuur één request via een geselecteerd endpoint-formaat. Gebruik --input-file voor een JSON-body, herhaalde -i key=value-waarden voor overschrijvingen en -p/--prompt voor een prompt-snelkoppeling.

cometapi run your-model-id -p "Write one sentence about CometAPI."
cometapi run your-model-id --endpoint responses -p "Reply with OK only." -i max_output_tokens=32 --json
cometapi run your-model-id --endpoint anthropic -p "Reply with OK only." -i max_tokens=32
cometapi run your-model-id --endpoint gemini -p "Reply with OK only." -i generationConfig.maxOutputTokens=32
cometapi run your-model-id --endpoint responses --input-file body.json -i temperature=0.2 --json

Option	Short	Description
`--endpoint`	`-e`	Endpoint-formaat: `chat`, `responses`, `anthropic` of `gemini`
`--input-file`		JSON-object request-body
`--input`	`-i`	Request-invoer als `key=value`; herhaal voor meerdere waarden
`--prompt`	`-p`	Prompt-snelkoppeling
`--json`		Geef ruwe JSON-response weer

Endpoint-mapping:

Endpoint	Request path	Auth
`chat`	`POST /v1/chat/completions`	Bearer API key
`responses`	`POST /v1/responses`	Bearer API key
`anthropic`	`POST /v1/messages`	`x-api-key` API key en Anthropic-versieheader
`gemini`	Gemini Generate Content-modelpad	`x-goog-api-key` API key

De body-samenvoegvolgorde is --input-file, herhaalde -i key=value, prompt-snelkoppeling en daarna positionele MODEL. Inline waarden worden waar mogelijk als JSON geparseerd. Dotted keys maken geneste objecten.

Balance

Toon het saldo van je CometAPI-account of de huidige factureringsweergave van de API key.

cometapi balance
cometapi balance --source account
cometapi balance --source key
cometapi balance --json

Option	Short	Description
`--source`	`-s`	Gegevensbron: `account` of `key`
`--format`	`-f`	Uitvoerformaat
`--json`		Geef uit als JSON

Account

Toon je accountprofiel. Vereist een access token.

cometapi account
cometapi account --json

Stats

Toon gebruiksstatistieken. Vereist een access token.

cometapi stats
cometapi stats --json

Tokens

Lijst API keys en doorzoek ze. Vereist een access token.

cometapi tokens
cometapi tokens --search project
cometapi tokens --json

Option	Short	Description
`--search`	`-s`	Zoekterm
`--page`	`-p`	Paginanummer
`--limit`	`-l`	Resultaten per pagina
`--format`	`-f`	Uitvoerformaat
`--json`		Geef uit als JSON

Logs

Bekijk gebruikslogs met filters. Vereist een access token.

cometapi logs
cometapi logs --model your-model-id
cometapi logs --start 2026-04-01 --end 2026-04-14
cometapi logs --type consume
cometapi logs --export > usage.csv
cometapi logs --limit 50 --json
cometapi logs --request-id 20260617165550885561292gJBlzjtp

Option	Short	Description
`--model`	`-m`	Filter op model ID
`--token-name`	`-t`	Filter op API-sleutelnaam
`--type`		Logtype
`--search`	`-s`	Zoekterm
`--start`		Startdatum
`--end`		Einddatum
`--group`	`-g`	Filter op API-sleutelgroep
`--request-id`		Zoek één request op via `X-Cometapi-Request-Id`
`--page`	`-p`	Paginanummer
`--limit`	`-l`	Resultaten per pagina
`--export`		Server-side CSV uitvoeren naar stdout
`--format`	`-f`	Uitvoerformaat
`--json`		Uitvoer als JSON

logs --request-id voert één geïndexeerde lookup uit op het operator-logendpoint en accepteert alleen een exacte overeenkomst met request_id. De CLI scant geen fallback-logpagina’s, omdat het self-logendpoint geen filtering op request_id toepast.

Tasks

Toon asynchrone taaklogs. Vereist een access token.

cometapi tasks
cometapi tasks --platform kling
cometapi tasks --status SUCCESS
cometapi tasks --json

Option	Short	Description
`--platform`	`-p`	Filter op platform
`--task-id`		Filter op task ID
`--status`	`-s`	Filter op status
`--action`	`-a`	Filter op actietype
`--start`		Startdatum
`--end`		Einddatum
`--page`		Paginanummer
`--limit`	`-l`	Resultaten per pagina
`--format`	`-f`	Uitvoerformaat
`--json`		Uitvoer als JSON

Doctor

Voer diagnostiek uit om de configuratie en API-connectiviteit te controleren.

cometapi doctor
cometapi doctor --json

Config

Beheer de CLI-configuratie die is opgeslagen in ~/.config/cometapi/config.toml.

cometapi config show
cometapi config set api_key "$COMETAPI_KEY"
cometapi config set default_model your-model-id
cometapi config unset api_key
cometapi config path

Zie de configuratiegids voor alle beschikbare sleutels.

Init

Voer de interactieve installatiewizard uit:

cometapi init

Repl

Start een volledige interactieve command shell:

cometapi repl

Output formats

De meeste datacommand’s ondersteunen --json of --format:

cometapi models --json
cometapi models --format yaml
cometapi stats --format csv
cometapi account --format markdown

Format	Description
`table`	Uitgebreide tabel in de terminal
`json`	JSON-uitvoer
`yaml`	YAML-uitvoer
`csv`	Door komma’s gescheiden waarden
`markdown`	Markdown-tabel

Begin hier

Snelstarts voor model-API's

Kernhandleidingen voor de API

Bibliotheken

Fouten

Prijzen en facturering

Ondersteuning

Overzicht van opdrachten

Chat

Models

Model info

Run

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats

​Overzicht van opdrachten

​Chat

​Models

​Model info

​Run

​Balance

​Account

​Stats

​Tokens

​Logs

​Tasks

​Doctor

​Config

​Init

​Repl

​Output formats

Overzicht van opdrachten

Chat

Models

Model info

Run

Balance

Account

Stats

Tokens

Logs

Tasks

Doctor

Config

Init

Repl

Output formats