Skip to main content
Don’t know which model to pick? Use an alias. Kyma resolves it to the best model for that category — and auto-updates when better models become available.

​
Available Aliases

AliasResolves ToBest For
bestqwen-3.6-plusHighest quality overall
fastllama-3.1-8bFastest response time
codekimi-k2.5Coding agents + tool calling
cheapgpt-oss-20bLowest cost per token
long-contextgemini-2.5-flash1M token context window
visiongemma-4-31bImage input / multimodal
reasoningqwen-3-235b-cerebrasComplex reasoning tasks
agentkimi-k2.5Agentic tool use workflows
balancedllama-3.3-70bGood quality + speed balance

​
Usage

Use aliases anywhere you’d use a model ID: 
from openai import OpenAI

client = OpenAI(base_url="https://kymaapi.com/v1", api_key="YOUR_KEY")

# Instead of remembering "qwen-3.6-plus"
response = client.chat.completions.create(
    model="best",  # → resolves to qwen-3.6-plus
    messages=[{"role": "user", "content": "Hello!"}]
)

# cURL
curl https://kymaapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -d '{"model": "code", "messages": [{"role": "user", "content": "Fix this bug"}]}'

​
In Coding Agents

Set Model ID to code in Cline settings.

​
Transparency

When you use an alias, Kyma adds headers so you always know which model was used: 
X-Kyma-Model: qwen-3.6-plus    # actual model used
X-Kyma-Alias: best              # alias you sent

​
Auto-Updates

Aliases are updated when better models become available. For example, if a new model outperforms qwen-3.6-plus, the best alias will point to it automatically — no config changes needed. If you need a fixed model that never changes, use the full model ID (e.g., qwen-3.6-plus) instead of an alias.

​
Get Current Aliases

curl https://kymaapi.com/v1/models | jq '.aliases'

{
  "best": "qwen-3.6-plus",
  "fast": "llama-3.1-8b",
  "code": "kimi-k2.5",
  "cheap": "gpt-oss-20b",
  "long-context": "gemini-2.5-flash",
  "vision": "gemma-4-31b",
  "reasoning": "qwen-3-235b-cerebras",
  "agent": "kimi-k2.5",
  "balanced": "llama-3.3-70b"
}

​
Smart Recommendations

Not sure which alias fits? Use the recommend API: 
# "I use Cline, what model should I use?"
curl "https://kymaapi.com/v1/models/recommend?agent=cline"

# "I need a coding model with tool support"
curl "https://kymaapi.com/v1/models/recommend?for=coding"
Supported agents: cline, roo-code, openclaw, claude-code, aider, opencode, cursor, kilo-code. See Models for full model details.