Quickstart

Step 1: Get your API key

Go to kymaapi.com and sign up with Google, or with your email and a password. You get an API key straight away. Or use the API directly:

curl -X POST https://kymaapi.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@email.com", "password": "your_password"}'

Response:

{
  "user_id": "abc123",
  "api_key": "kyma-your-api-key",
  "session_token": "ks-your-session-token"
}

Save your API key securely. You can create more keys on the Keys page.

The call answers 400 for an invalid email, a password under 6 characters, or an address that cannot receive mail; 409 if the account already exists; and 429 when sign-ups are being rate-limited, in which case wait and retry.

Step 2: Verify your email

A new email account starts with a

0 balance. We send you a verification email; open the link in it and the

0.50 signup credit is added to your account. That credit spends on the free tier. Signing up with Google skips this step, because Google has already verified the address. Until you verify, a call to any model answers 402, because the balance is $0.

Step 3: Install the SDK

pip install openai

npm install openai

Step 4: Make your first request

deepseek-v4-flash is in the free tier, so it works on the signup credit.

from openai import OpenAI

client = OpenAI(
    base_url="https://kymaapi.com/v1",
    api_key="kyma-your-api-key"
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "What is the capital of France?"}
    ]
)

print(response.choices[0].message.content)
# → "The capital of France is Paris."

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://kymaapi.com/v1",
  apiKey: "kyma-your-api-key",
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "What is the capital of France?" },
  ],
});

console.log(response.choices[0].message.content);
// → "The capital of France is Paris."

curl https://kymaapi.com/v1/chat/completions \
  -H "Authorization: Bearer kyma-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "What is the capital of France?"}
    ]
  }'

Step 5: Try the Playground

Test models interactively in the Playground before integrating into your app.

You’re ready! 🎉

Choose a model

Not sure which model to use? See our recommendation guide.

Anthropic SDK

Using Anthropic SDK? Kyma is drop-in compatible.

Python guide

Full Python integration with streaming, async, and error handling.

API Reference

Full endpoint documentation with parameters and examples.

Getting Started

More

Step 1: Get your API key

Step 2: Verify your email

Step 3: Install the SDK

Step 4: Make your first request

Step 5: Try the Playground

You’re ready! 🎉

Choose a model

Anthropic SDK

Python guide

API Reference

​Step 1: Get your API key

​Step 2: Verify your email

​Step 3: Install the SDK

​Step 4: Make your first request

​Step 5: Try the Playground

​You’re ready! 🎉

Choose a model

Anthropic SDK

Python guide

API Reference

Step 1: Get your API key

Step 2: Verify your email

Step 3: Install the SDK

Step 4: Make your first request

Step 5: Try the Playground

You’re ready! 🎉