​
Hosted service overview

KV Cache Store’s hosted service gives you a dashboard, object storage, billing, and API access for the artifacts you upload with the kvcdn CLI.

​
What the hosted service provides

  • Dashboard at kvcachestore.com/app for managing artifacts, API keys, and billing.
  • Direct-to-storage uploads via presigned URLs — large artifacts never pass through the portal.
  • Per-project API keys for automation and CI.
  • Organization-level billing with Stripe-backed subscriptions.
  • Public artifact catalog for artifacts explicitly set to public visibility.

​
Typical flow

  1. Sign in at kvcachestore.com with OIDC.
  2. The first sign-in creates a default organization and project. Copy an API key from Settings > API Keys.
  3. Set the API key in the CLI: 
    kvcdn api-key set kv_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  4. Verify or quantize a local artifact, then upload it with: 
    kvcdn upload ./context.kv --name "Qwen system prompt" --visibility private
  5. View, search, and manage visibility in the dashboard.

​
Base API URL

For local development, kvcdn defaults to http://localhost:3000. For the hosted service, use: 
export KVCDN_API_URL=https://api.kvcachestore.com
You can also pass --api-url on each command.

​
Limits

Free accounts can store up to 20 artifacts. The portal returns 403 Forbidden when an upload would exceed this limit. Upgrade in the dashboard to raise the limit.

​
Next steps