@kyma-api/ai-sdk

@kyma-api/ai-sdk

Kyma API provider for the Vercel AI SDK. Access 16 open-source LLMs through one endpoint with automatic failover.

Install

npm install @kyma-api/ai-sdk @ai-sdk/openai-compatible

Setup

Get your API key at kymaapi.com (free $0.50 credit).

export KYMA_API_KEY="ky-your-api-key"

Usage

import { kyma } from "@kyma-api/ai-sdk";
import { generateText, streamText } from "ai";

// Use model aliases
const { text } = await generateText({
  model: kyma("best"),
  prompt: "What is quantum computing?",
});

// Stream responses
const result = streamText({
  model: kyma("code"),
  prompt: "Write a React hook for dark mode",
});

// Use specific models
const { text: analysis } = await generateText({
  model: kyma("deepseek-r1"),
  prompt: "Analyze this algorithm's time complexity...",
});

Model Aliases

Use aliases instead of memorizing model IDs:

Alias	Best For
best	Highest quality overall
fast	Fastest response
code	Code generation
cheap	Lowest cost
reasoning	Complex reasoning
agent	Agentic tool use
vision	Image input
long-context	1M token context
balanced	Quality + speed balance

Custom Configuration

import { createKyma } from "@kyma-api/ai-sdk";

const kyma = createKyma({
  apiKey: "ky-your-api-key",
  baseURL: "https://kymaapi.com/v1", // default
});

Links

• Kyma API Docs
• Model Catalog
• Pricing
• AI SDK Docs