Overview

KOPRouter is a unified model gateway compatible with the OpenAI and Anthropic protocols. One API key unlocks chat, embeddings, image, audio, moderation, rerank, and video models, billed consistently by model and usage.

What is KOPRouter?

KOPRouter aggregates many upstream AI providers behind a single OpenAI-compatible API, with native support for the Anthropic Messages API. You only need one Base URL and one API key to call every model enabled for your account; model routing, failover, rate limiting, and billing are all handled by the gateway.

Core Capabilities

A single Base URL — switch models by changing only the `model` field, no per-provider setup. Priority-weighted routing that fails over to backup channels automatically when a provider is down. Billed per token, image, character, second, or request — all in one place, visible in the console.

Base URL & Authentication

The Base URL is <your-base-url>/v1. Authenticate with a Bearer token:

Authorization: Bearer sk-...

The Base URL is <your-base-url>; the SDK appends /v1/messages automatically. Authenticate with:

x-api-key: sk-...

Supported Endpoints

Category Endpoint Billing
Text /v1/chat/completions Per token
Text /v1/completions Per token
Text /v1/responses Per token
Text /v1/embeddings Per token
Text /v1/rerank Per request
Text /v1/moderations Per request
Image /v1/images/generations Per image
Image /v1/images/edits Per image
Image /v1/images/variations Per image
Audio /v1/audio/speech Per synthesized character
Audio /v1/audio/transcriptions Per request
Audio /v1/audio/translations Per request
Video /v1/videos Per completed result

Before You Call

List the models actually available to your account — the id in the response is exactly what the model field should contain:

curl https://koprouter.kopglobal.com/v1/models \
  -H "Authorization: Bearer sk-..."
Use the `id` returned by `/v1/models` exactly as-is. A model outside the list returns `404 model_not_found`.

Next Steps

Make your first API call in three steps. Start here for 401 / 402 / 429 and other common issues.