Authentication

Get your API key

Go to kymaapi.com and create an account with email + password, or sign in with Google.

Copy your key

Your API key starts with kyma- and is shown after registration. You can also find it on the Keys page.

Use it

Pass your key as a Bearer token in the Authorization header.

The $0.50 signup credit is added once your email is verified (Google sign-in counts as verified). It spends on free tier models only; any other model returns 402 model_requires_paid until your first top-up.

Using your API key

Include your key in every API request:

curl https://kymaapi.com/v1/chat/completions \
  -H "Authorization: Bearer kyma-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "llama-3.3-70b", "messages": [{"role": "user", "content": "Hello"}]}'

With the OpenAI SDK:

from openai import OpenAI

client = OpenAI(
    base_url="https://kymaapi.com/v1",
    api_key="kyma-your-api-key"  # or set OPENAI_API_KEY env var
)

Environment variables

Never hardcode your API key. Use environment variables instead.

export OPENAI_API_KEY="kyma-your-api-key"
export OPENAI_BASE_URL="https://kymaapi.com/v1"

Then in your code:

client = OpenAI()  # automatically reads env vars

Managing keys

Create keys: Keys page → Create Key
Multiple keys: Create separate keys for dev/staging/production
Delete keys: Remove compromised keys instantly from the Keys page
View usage: Track requests per key in Dashboard

Guides

Use Cases

Integrations

Get your API key

Using your API key

Environment variables

Managing keys

​Get your API key

​Using your API key

​Environment variables

​Managing keys

Get your API key

Using your API key

Environment variables

Managing keys