Connector docs — OpenAI
Exactly what CostMon asks for to read OpenAI
CostMon calls two OpenAI organization-level reporting endpoints and merges them per day and per model. Neither is reachable with a regular project API key.
What CostMon calls
The literal API surface, nothing more
- GET /v1/organization/usage/completions
- Per-model token usage, daily buckets.
- GET /v1/organization/costs
- Per-day cost, optionally scoped to one project.
What you supply
Credential and config fields
admin_keyAdmin API keysecretrequired
An organization Admin API key (sk-admin-...). Regular project API keys cannot read the usage/costs reports.
project_idProject IDoptional
Optionally scope reporting to a single project. Empty reports org-wide.
Minimum permission
Copy this, not a broader role
Scope of access
What OpenAI access can't reach
- Prompts, completions, or any request content
- Projects you don't scope the key to, when project_id is set
Troubleshooting
Setup errors and what they mean
- admin_key is required
- No Admin API key was supplied. A regular project key won't be accepted at sync time.
FAQ
Common questions about the OpenAI connector
Does the project_id field limit which projects OpenAI reports to CostMon?
Yes. Leave it empty for an org-wide view, or set it to scope both the usage and cost reports to one project.
Can CostMon see the content of API requests?
No. Both endpoints CostMon calls return aggregated usage and cost numbers, never request or response content.
A rate you looked up will change again.
Provider pricing pages change without notice. CostMon tracks the bill that pays for it.