Skip to main content
The AI API provides programmatic access to kombify’s AI features — chat, companions, voice, BYOK key management, cost tracking, and agent federation.
Base URL: https://api.kombify.io/v1/ai (SaaS) or http://localhost:5270/api/v1 (self-hosted)

​
Authentication

All endpoints (except health and A2A federation) require authentication via JWT token or API key through Kong Gateway. 
curl -H "Authorization: Bearer $TOKEN" \
  https://api.kombify.io/v1/ai/models
See Authentication for details on obtaining tokens.

​
Rate limiting

Authenticated /v1/ai/* routes are rate-limited. Limits vary by tier (free, pro, enterprise, self-hosted). Rate limit headers are included in responses.

​
Streaming

Chat and voice endpoints support Server-Sent Events (SSE) streaming. Set Accept: text/event-stream or "stream": true in the request body.

​
API endpoints

Chat

Chat, sessions, and companion interactions

Models & Keys

Model discovery, BYOK key management, preferences

Voice

Speech-to-text, text-to-speech, voice chat

Usage & Costs

Cost tracking, token budgets, usage aggregation