---
summary: "Kimi K2 provider data sources: API key + credit endpoint."
read_when:
  - Adding or tweaking Kimi K2 usage parsing
  - Updating API key handling or config migration
  - Documenting new provider behavior
---

# Kimi K2 provider

> This is a legacy, unofficial provider for the `kimi-k2.ai` credit endpoint.
> For the official Kimi API account and billing surface, use the Moonshot / Kimi
> API provider instead.

Kimi K2 is API-only. Usage is reported by the credit counter behind
`GET https://kimi-k2.ai/api/user/credits`, so CodexBar only needs a valid API
key for that legacy endpoint to pull your remaining balance and usage.

## Data sources + fallback order

1) **API key** stored in `~/.codexbar/config.json` or supplied via `KIMI_K2_API_KEY` / `KIMI_API_KEY` / `KIMI_KEY`.
   CodexBar stores the key in config after you paste it in Preferences → Providers → Kimi K2 (unofficial).
   Surrounding whitespace is ignored before the key is sent.
2) **Credit endpoint**
   - `GET https://kimi-k2.ai/api/user/credits`
   - Request headers: `Authorization: Bearer <api key>`, `Accept: application/json`
   - HTTP 401 is shown as an invalid or expired key; other failures keep the provider's response details.
   - Response headers may include `X-Credits-Remaining`.
   - JSON payload contains total credits consumed, credits remaining, and optional usage metadata.
     CodexBar scans common keys and falls back to the remaining header when JSON omits it.

## Usage details

- Credits are the billing unit; CodexBar computes used percent as `consumed / (consumed + remaining)`.
- There is no explicit reset timestamp in the API, so the snapshot has no reset time.
- The menu's Usage Dashboard action opens the legacy service's human-facing credits page at `https://kimrel.com/my-credits`.
- A key saved in Settings takes precedence over environment variables.

## Key files

- `Sources/CodexBarCore/Providers/KimiK2/KimiK2ProviderDescriptor.swift` (descriptor + fetch strategy)
- `Sources/CodexBarCore/Providers/KimiK2/KimiK2UsageFetcher.swift` (HTTP client + parser)
- `Sources/CodexBarCore/Providers/KimiK2/KimiK2SettingsReader.swift` (env var parsing)
- `Sources/CodexBar/Providers/KimiK2/KimiK2ProviderImplementation.swift` (settings field + activation logic)
- `Sources/CodexBar/KimiK2TokenStore.swift` (legacy migration helper)