1 · Schlüssel holen

Hol dir einen Starter-Schlüssel oder frage einen bezahlten Plan an.

Schlüssel für 1 $

2 · Routing-Aufruf machen

Sende einen Prompt; erhalte Aufgabentyp und Komplexitätsstufe.

curl https://138.226.222.209/v1/route \
  -H 'Authorization: Bearer cortiq_your_key' \
  -H 'content-type: application/json' \
  -d '{
    "input": { "text": "Write a Python function to reverse a list" },
    "taxonomy_id": "data-assistant"
  }'

Beispielantwort

{
  "schema_version": "1.1",
  "request_id": "req_18c98f1adb897a78001871",
  "decision": {
    "task_label": "code",
    "confidence": 0.997,
    "complexity": { "tier": "low", "score": 0.27, … },
    "source": "router", …
  },
  "scores": [ { "task_label": "code", "probability": 0.997, … }, … ],
  "usage": { "billable_decisions": 1, "oracle_calls": 0 },
  "meta": { "model_version": "data-assistant@2026.08.02", "latency_ms": 0.03, … }
}

3 · Stufe → dein Modell

Einfache Prompts an ein günstiges/lokales Modell, schwere an dein Flaggschiff.

# your side — map the router's answer to your models
tier == "low"     → cheap / local  (llama.cpp, Ollama, gpt-4o-mini)
tier == "medium"  → mid
tier == "high"    → flagship       (Claude, GPT-4o, …)

Sie wollen dieses Mapping nicht selbst schreiben? Unten steht ein fertiges Open-Source-Gateway, das es für Sie erledigt.

⚡ cortiq-gateway — das fertige Open-Source-Gateway

Ein OpenAI-kompatibler Endpoint über diesem Router: Komplexitäts-Routing ab Werk, Web-Konsole unter /admin (7 Sprachen), lokale .cmf-Modelle plus Cloud-Anbieter und ein Einrichtungsassistent. Der Befehl ohne Flags erzeugt seine Konfiguration selbst und öffnet den Browser.

# crates.io
cargo install cortiq-gateway
cortiq-gateway

# Docker
docker run -p 9000:9000 -v cortiq-data:/app/data ghcr.io/infosave2007/cortiq-gateway:latest

Danach jeden OpenAI-Client auf base_url http://localhost:9000/v1 mit model "cortiq-auto" richten; den Router-Key in den Einstellungen der Konsole einfügen. Fertige Binaries für Linux, Windows und macOS liegen unter Releases auf GitHub.

GitHub → infosave2007/cortiq-gateway

4 · Aufgaben der Taxonomie auflisten — GET /v1/taxonomies

Der komplette Labelsatz Ihres Kontos in einem Aufruf — bauen Sie Routing-Einstellungen aus der Live-Liste statt aus Konstanten im Code.

curl https://138.226.222.209/v1/taxonomies \
  -H 'Authorization: Bearer cortiq_your_key'

Beispielantwort

{
  "schema_version": "1.1",
  "taxonomies": [
    {
      "taxonomy_id": "data-assistant",
      "taxonomy_version": "data-assistant@1",
      "model_version": "data-assistant@2026.08.02",
      "labels": [
        "chitchat", "code", "creative-writing",
        "extraction", "math", "qa",
        "summarization", "translation"
      ]
    }
  ]
}

Die vollständige Menge erscheint nie in einer /v1/route-Antwort (scores enthalten nur die Top-3) — dieser Endpunkt ist ihre einzige Quelle. Ein neu hinzugefügtes Label erscheint hier automatisch.

API-Referenz

Die übrigen Endpunkte — gleicher Bearer-Key, gleiche Basis-URL.

POST /v1/route:batch

Batch-Klassifikation: viele Prompts pro Aufruf; Ergebnisse in derselben Reihenfolge wie inputs.

curl https://138.226.222.209/v1/route:batch \
  -H 'Authorization: Bearer cortiq_your_key' \
  -H 'content-type: application/json' \
  -d '{
    "taxonomy_id": "data-assistant",
    "inputs": [ { "text": "Fix this bug" }, { "text": "Переведи: добрый вечер" } ]
  }'
# → { "results": [ { "request_id": …, "decision": { "task_label": "code", … } }, … ] }

POST /v1/feedback

Korrigieren Sie eine falsche Klassifikation — request_id aus der /v1/route-Antwort plus das richtige Label. Der Router lernt aus Ihren Korrekturen.

curl https://138.226.222.209/v1/feedback \
  -H 'Authorization: Bearer cortiq_your_key' \
  -H 'content-type: application/json' \
  -d '{ "request_id": "req_…", "correct_task_label": "math" }'
# → { "accepted": true, "message": "…" }

GET /v1/usage

Kontonutzung und Limits: abgerechnete Entscheidungen, Oracle-Aufrufe, Quota und Rate-Limit.

{
  "account": { "id": "acct_…", "billable_decisions": 98, "decision_quota": 0, "rate_per_min": 60 },
  "usage": { "cache_hits": 85, "oracle_calls": 58, "escalation_rate": 0.64, … }
}

GET /v1/taxonomies/{id}

Eine Taxonomie per id: Version, Modellversion und vollständige Labelliste.

GET /v1/healthz · GET /v1/readyz

Liveness- und Readiness-Checks — fürs Monitoring, ohne Auth.