# KeyVia — AI agent integration reference

KeyVia provides a high-performance unified API compatible with Anthropic, OpenAI and Gemini, with pay-as-you-go billing, subscription plans, API key management, and usage logging and queries.

Setup only configures the gateway, protocol, and API key. Do not assign a default model or add or override existing client model settings.

Portal: https://keyvia.cc
API keys: https://keyvia.cc/dashboard/keys
Model catalog and prices: https://keyvia.cc/models
API gateway: `https://api.keyvia.cc`

KeyVia provides a shared API gateway for AI coding tools and SDKs. The portal is for account management; use the API gateway for model requests.

| Client | Protocol | Base URL | Configuration |
| --- | --- | --- | --- |
| Claude Code | Anthropic Messages | `https://api.keyvia.cc` | `~/.claude/settings.json` |
| Codex CLI | OpenAI Responses | `https://api.keyvia.cc/v1` | `~/.codex/config.toml` |
| Gemini CLI | Native Gemini | `https://api.keyvia.cc` | `~/.gemini/.env` |

Choose an available model from the model catalog for the API key's group. Model availability and prices can change; do not assume that an example model is available to every key. Input, output, and supported cache charges are listed separately in the catalog.

## Rules for automated configuration

1. Back up an existing configuration before editing it. Avoid overwriting an earlier backup.
2. Merge only the KeyVia settings; preserve other providers, MCP servers, permissions, and client preferences.
3. Use the user's API key. If it has not been provided, keep a placeholder or ask for it. Never print a full key in logs or chat.
4. Check the resulting configuration, send a small test request with the user's consent, and confirm the request in dashboard usage records.

## Detailed guides

- [Claude Code](/en/docs/ai/claude-code.md)
- [Codex CLI](/en/docs/ai/codex.md)
- [Gemini CLI](/en/docs/ai/gemini-cli.md)
- [Troubleshooting](/en/docs/ai/troubleshooting.md)
- [Full reference in one file](/en/llms-full.txt)


## Chatbox

[Chatbox setup guide](https://keyvia.cc/docs/chatbox): select the existing OpenAI or Claude provider and update its API Host; no custom provider is needed. Set API Host to `https://api.keyvia.cc/v1`; enter your KeyVia key without a Bearer prefix. Select a model available to the key, preserving its full ID. Do not overwrite existing model settings automatically.

In Claude mode, set API Host to `https://api.keyvia.cc/v1`. The `/v1` suffix is required; the connection will not work without it.

For Failed to fetch or network errors, first confirm that API Host includes /v1, then check connectivity and CORS preflight. Share the app version, error and request time with support, never your key.

English website: https://keyvia.cc/en
Security reports: https://keyvia.cc/en/security
Chinese website: https://keyvia.cc/