Model Aliases

Use simple aliases like ‘best’, ‘fast’, ‘code’ instead of memorizing model IDs.

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

Alias	Resolves To	Best For
best	qwen-3.6-plus	Highest quality overall
fast	qwen-3-32b	Fastest active coding / response path
code	qwen-3-coder	Code-focused tasks
cheap	gemini-2.5-flash	Lowest-cost active alias
long-context	gemini-2.5-flash	1M token context window
vision	gemma-4-31b	Image input / multimodal
reasoning	deepseek-r1	Complex reasoning tasks
agent	kimi-k2.6	Agentic tool use workflows
best-agent	kimi-k2.6	Agentic tool use workflows (explicit alias)
balanced	llama-3.3-70b	Good quality + speed balance
glm-flagship	glm-5.1	Long-running coding agents, repo-scale engineering
search	sonar	Live web search with citations (current events, research)

Audio Aliases

Kyma also exposes shortcuts for the audio stack. Use them with /v1/audio/transcriptions or /v1/audio/understand instead of memorising provider model IDs.

Alias	Resolves To	Best For
transcribe	whisper-v3-turbo	Speech-to-text, captions, voice agents (228× realtime)
transcribe-quality	gpt-4o-mini-transcribe-2025-12-15	High-accuracy transcription, multilingual code-switching (Vi/En), conversational audio
audio-understand	gemini-3-flash-audio	Scene/tone/music recognition beyond transcription

# Transcribe with the alias
curl https://kymaapi.com/v1/audio/transcriptions \
  -H "Authorization: Bearer $KYMA_KEY" \
  -F "file=@meeting.mp3" \
  -F "model=transcribe"

# Audio scene understanding
curl https://kymaapi.com/v1/audio/understand \
  -H "Authorization: Bearer $KYMA_KEY" \
  -F "file=@clip.mp3" \
  -F "question=What instruments and mood?" \
  -F "model=audio-understand"

For TTS (/v1/audio/speech), music (/v1/audio/music), SFX (/v1/audio/sfx), and voice ops (/v1/audio/voice-clone, /v1/audio/voice-design), pass the explicit model id (e.g. eleven-multilingual-v2, minimax-music-pro). Aliases for those will land once we settle on canonical defaults.

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

Cline

Set Model ID to code in Cline settings.

OpenClaw

{ "primary": "kyma/code" }

Aider

aider --model openai/best --openai-api-base https://kymaapi.com/v1

Cursor

Set model to best in Cursor’s OpenAI-compatible provider 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": "qwen-3-32b",
  "code": "qwen-3-coder",
  "cheap": "gemini-2.5-flash",
  "long-context": "gemini-2.5-flash",
  "vision": "gemma-4-31b",
  "reasoning": "deepseek-r1",
  "agent": "kimi-k2.6",
  "best-agent": "kimi-k2.6",
  "balanced": "llama-3.3-70b",
  "glm-flagship": "glm-5.1",
  "search": "sonar",
  "transcribe": "whisper-v3-turbo",
  "transcribe-quality": "gpt-4o-mini-transcribe-2025-12-15",
  "audio-understand": "gemini-3-flash-audio"
}

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.