Skip to main content

Provider Keys

Provider keys allow you to securely store API credentials for AI model providers (like Anthropic) in the Shinzo Platform. These keys are encrypted at rest and used by the Spotlight model proxy to make requests on your behalf.

Supported Providers

Currently supported providers:
ProviderKey FormatFeatures
Anthropicsk-ant-api03-*Claude models, streaming, token counting
Subscription-based access is not supported. Only API keys from the Anthropic Console can be used. OAuth tokens from Claude subscriptions (e.g., Claude Pro/Team subscriptions with format sk-ant-oat01-*) are not compatible with Shinzo.

Why Use Provider Keys?

Security: Store API keys encrypted in Shinzo instead of hardcoding them in your applications. Centralized Management: Manage all your AI provider credentials in one place. Analytics: When using stored provider keys with Spotlight, all API usage is automatically tracked and available in session analytics.

Endpoints

MethodEndpointDescription
POST/auth/provider_keys/testTest a provider key without storing
POST/auth/provider_keysSave an encrypted provider key
GET/auth/provider_keysList all provider keys
PUT/auth/provider_keys/{keyUuid}Update a provider key
DELETE/auth/provider_keys/{keyUuid}Delete a provider key