Koveh API

Koveh API Documentation

Complete documentation for all Koveh API services

Koveh API Documentation

Welcome to the comprehensive documentation for all Koveh API services. All services are accessible via api.koveh.com with clean, intuitive URLs.

Quick Start: All API services require authentication using Bearer tokens. See the examples below for usage.

Quick Start

All API services require authentication using Bearer tokens:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "api.koveh.com/qwen3/chat"

Getting Started

Quick Start

Available Services

Core AI Services

Financial Services

Utility Services

Health Checks

Check the status of all services:

# Core Services
curl api.koveh.com/translation/health
curl api.koveh.com/qwen3/health
curl api.koveh.com/fastvlm/health
curl api.koveh.com/web-search/health

# Financial Services
curl api.koveh.com/t/health

# Utility Services
curl api.koveh.com/speech-to-text/health

Integration Examples

Perplexity-like Search with AI Response

Combine web search with AI to create intelligent responses:

import requests

# 1. Search for information
search_response = requests.post(
    "http://api.koveh.com/web-search/search",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"query": "Python FastAPI tutorial"}
)

# 2. Generate response with context
chat_response = requests.post(
    "http://api.koveh.com/qwen3/chat",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "messages": [
            {"role": "user", "content": f"Based on this search: {search_response.json()}, explain Python FastAPI"}
        ]
    }
)

Multi-language Translation

Translate text using multiple providers for better accuracy:

# Translate text using multiple providers
providers = ["helsinki", "google", "deepl"]

for provider in providers:
    response = requests.post(
        "http://api.koveh.com/translation/translate",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={
            "text": "Hello, world!",
            "source_language": "en",
            "target_language": "de",
            "provider": provider
        }
    )
    print(f"{provider}: {response.json()['translated_text']}")

Error Handling

All APIs return consistent error responses:

{
  "error": "Error message",
  "status_code": 400,
  "timestamp": "2025-08-30T09:19:31.245295"
}

Rate Limiting

Each service has its own rate limiting:

  • Translation: 100 requests/minute
  • Qwen3: 50 requests/minute
  • FastVLM: 30 requests/minute
  • Web Search: 60 requests/minute
  • Tinkoff: 100 requests/minute

Support

For support and questions:

  • API Access & Technical Support: studio@koveh.com
  • General Inquiries: info@koveh.com
  • Check individual service health endpoints
  • View service logs: docker logs [container-name]
  • Contact the development team

API Access Required: To use any of our APIs, you must first apply for access by emailing studio@koveh.com with your use case and requirements.

Note: This documentation is actively maintained. For the latest updates, check our GitHub repository.

AI Services (Legacy)

OpenAI, Claude, Mistral, Llama, DeepSeek APIs