Keys / Jina AI
JINA_API_KEY
The Jina AI API key your app calls the Reader, Embeddings and Reranker APIs with. One key works for all of them and holds their shared token balance.
- Expires
- never
- API
- none; dashboard only
Get it
Create one on jina.ai/api-dashboard/key-manager. The steps aren't recorded yet.
Set it
JINA_API_KEY=...
The Jina CLI (jina-cli) reads it from this variable when you don't pass a key. For the HTTP APIs, your app sends it as a Bearer token. Or keep it out of .env with keypin: keypin run -- npm run dev
Replace it
- Sign in and create a new key under the same account in the key manager.
- Balance and rate limits belong to each key, not the account. On a paid key, top up the new key and check its balance and tier on the API Key & Billing tab. Don't transfer tokens yet: a transfer moves all of the old key's paid tokens.
- Deploy the new key everywhere that reads
JINA_API_KEY, and check that requests succeed. - Revoke the old key. It stops at once, and revoking can't be undone. Its remaining balance is lost, so transfer it to the new key first, or tick the transfer option when you revoke.
Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.