Connect OpenAI to ShipVitals
API costs and token usage by project
AvailableKey, not read-only · about 2 minutes
What it reads
- Admin key
- The only key that reads organisation costs and usage.
Not read-only at OpenAI. ShipVitals calls only the organisation costs, usage and projects endpoints. An Admin key could also manage members, projects and keys.
What ShipVitals keeps: The Admin key, encrypted.
How to connect
- Open Settings → Organization → Admin keys in OpenAI.
- Choose Create new admin key, and name it ShipVitals.
- Copy the key. It starts with sk-admin-, and OpenAI shows it once.
About 2 minutes.
How to revoke
Removing the connection in ShipVitals deletes the stored key at once.
What it powers
Dashboard tabs: Costs.
Figures it fills
- ai.tokens.input
- ai.tokens.cached
- ai.tokens.output
- ai.requests
Sync
- Free: Daily
- Indie: Hourly
- Studio: Every 15 minutes
- Agency: Every 15 minutes
Troubleshooting
Each error a connection can hit, and its fix. The connection's health page names the one it hit.
- Access refused
- OpenAI no longer accepts what ShipVitals signs in with. Create a new key, or connect again, and replace it in the connection.
- A permission is missing
- What ShipVitals has can't read everything it needs. Add the permissions under What it reads, or create a new key with them, and test again.
- Access removed
- ShipVitals' access was removed in OpenAI. Connect it again; the history it brought in is kept.
- Rate-limited
- OpenAI asked ShipVitals to slow down. Nothing to do: the sync carries on by itself and catches up.
- Quota reached
- The account used up a OpenAI quota. The sync resumes when the quota resets.
- Not found
- Something the connection reads is gone from OpenAI: renamed, moved or removed. Review the connection's resources, or connect again.
- OpenAI is unavailable
- OpenAI is having trouble on its side. Check its status page; ShipVitals retries by itself.
- Couldn't reach OpenAI
- The request didn't get through. ShipVitals retries by itself; if it keeps failing, check that OpenAI is reachable.
- An answer ShipVitals didn't expect
- OpenAI answered in a shape ShipVitals didn't expect, usually after a change on its side. We're told, and the data you have is kept.
- A setting doesn't work
- A field in the connection doesn't work with OpenAI. Check it against How to connect, and test again.