Zum Inhalt springen
APMIX.AI
DE

Doku

Zwei Zeilen. Jedes Tool.

Alle Tools weiter unten brauchen dieselben zwei Dinge: die Base-URL von apmix und deinen API-Schlüssel. Füge deinen Schlüssel einmal ein, dann sind alle Snippets auf dieser Seite kopierfertig.

Base-URLs

  • https://api.apmix.ai/v1OpenAI-kompatibel

    Chat Completions und Responses. Codex, Cursor, OpenCode, Kilo Code, Pi, Kimi, Grok, Hermes und SDKs.

  • https://api.apmix.aiAnthropic-kompatibel

    Messages-API. Claude Code und die Anthropic-SDKs.

Dein Setup

Schlüssel holen →
base_url
https://api.apmix.ai
api_key
apx_live_YOUR_KEY
model
claude-sonnet-5

Wähle dein Tool

12 Tools

  1. Installiere Claude Code

    Benötigt Node.js 18 oder neuer. Ist Claude Code schon auf deinem Rechner, überspringe diesen Schritt.

    Terminal
    npm install -g @anthropic-ai/claude-code

  2. Verbinde Claude Code mit apmix

    Claude Code spricht das Anthropic-Protokoll, deshalb kommt die Base-URL ohne /v1 aus. Setze die drei Variablen in dem Terminal, in dem du es startest.

    export ANTHROPIC_BASE_URL="https://api.apmix.ai"
export ANTHROPIC_AUTH_TOKEN="apx_live_YOUR_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

    Füge oben deinen Schlüssel ein, um ihn hier einzusetzen

  3. Speichere die Werte dauerhaft

    Trage dieselben Werte in ~/.claude/settings.json ein, damit jedes neue Terminal sofort bereit ist. Das Skript sichert eine vorhandene Datei zuerst; wenn du schon Einstellungen hast, ergänze sie um den env-Block, statt die Datei zu ersetzen.

    mkdir -p ~/.claude
[ -f ~/.claude/settings.json ] && cp ~/.claude/settings.json ~/.claude/settings.json.bak
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apmix.ai",
    "ANTHROPIC_AUTH_TOKEN": "apx_live_YOUR_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}
EOF

    Füge oben deinen Schlüssel ein, um ihn hier einzusetzen

  4. Leg los

    Starte Claude Code in deinem Projekt. Mit /model wechselst du jederzeit das Modell; jede Claude-ID aus dem Katalog funktioniert.

    Terminal
    cd your-project
claude

Test

Prüfe, ob der Schlüssel funktioniert.

Rufe die Modelle ab, auf die dein Schlüssel Zugriff hat. Kommt eine JSON-Liste zurück, stimmen Schlüssel und URL; ein 401 bedeutet, dass der Schlüssel falsch oder abgelaufen ist.

curl https://api.apmix.ai/v1/models -H "Authorization: Bearer apx_live_YOUR_KEY"

Füge oben deinen Schlüssel ein, um ihn hier einzusetzen

Dein Tool ist nicht dabei?

Jedes Tool, in dem du eine Base-URL für OpenAI oder Anthropic festlegen kannst, funktioniert mit apmix. Suche nach einem Feld wie „Base URL“ oder „Custom provider“, füge die URL und deinen Schlüssel ein und verwende eine Modell-ID aus dem Katalog.

Kommst du immer noch nicht weiter? Schreib an support@apmix.ai – mit dem Namen des Tools und deiner Anfrage-ID.

Fehler

Jeder Fehler, sein Statuscode und was du tun kannst.

Die API antwortet mit einem Standard-HTTP-Status und einem JSON-Body, der den Fehler benennt. Der code ändert sich nie, du kannst also zuverlässig darauf prüfen; die message ist für Menschen gedacht. Jede Antwort enthält außerdem den Header x-apmix-request-id – gib ihn an, wenn du an support@apmix.ai schreibst.

Zwei Formate, je nach Endpunkt

OpenAI-kompatible Endpunkte (/v1/chat/completions, /v1/responses, /v1/models, /v1/usage)
HTTP/1.1 429 Too Many Requests
x-apmix-request-id: req_5b1f…

{
  "error": {
    "message": "Your monthly allowance is used up. …",
    "type": "insufficient_quota",
    "code": "allowance_exhausted",
    "param": null
  }
}
Anthropic-kompatible Endpunkte (/v1/messages, /v1/messages/count_tokens)
HTTP/1.1 429 Too Many Requests
x-apmix-request-id: req_5b1f…

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "Your monthly allowance is used up. …",
    "code": "allowance_exhausted"
  }
}
400Ungültige Anfrage
  • invalid_json

    invalid_request_error

    Ursache: Der Body der Anfrage ließ sich nicht als JSON parsen.

    Lösung: Prüfe Anführungszeichen, Kommas und den Header Content-Type: application/json.

  • missing_model

    invalid_request_error

    Ursache: In der Anfrage fehlt das Feld model.

    Lösung: Füge eine Modell-ID aus dem Katalog hinzu, z. B. claude-sonnet-4-6.

  • bad_request

    invalid_request_error

    Ursache: Das Modell hat einen Parameter abgelehnt (falscher Typ, nicht unterstützte Option, Inhalt zu lang).

    Lösung: Lies die message; sie gibt die Begründung des Modells wieder. Korrigiere den Parameter und sende die Anfrage erneut.

401Authentifizierung
  • missing_api_key

    authentication_error

    Ursache: Es wurde kein Schlüssel gesendet. Jeder Endpunkt braucht einen, auch GET /v1/models, weil der Katalog von deinem Tarif abhängt.

    Lösung: Sende Authorization: Bearer apx_live_… (oder x-api-key bei Anthropic-Endpunkten).

  • invalid_api_key

    authentication_error

    Ursache: Der Schlüssel existiert nicht oder wurde gelöscht.

    Lösung: Kopiere ihn erneut unter Dashboard → API-Schlüssel oder erstelle einen neuen.

  • key_expired

    authentication_error

    Ursache: Der Schlüssel hat das Ablaufdatum überschritten, das du beim Erstellen festgelegt hast.

    Lösung: Erstelle einen neuen Schlüssel; die Laufzeit lässt sich nicht verlängern.

403Berechtigung
  • model_not_in_plan

    permission_error

    Ursache: Das Modell existiert, liegt aber über deinem Tarif, oder dein Konto hat noch keinen Tarif. Die message nennt das Modell, den nötigen Tarif und den Tarif deines Schlüssels.

    Lösung: Rufe GET /v1/models mit demselben Schlüssel auf – die Liste enthält nur, was dein Tarif nutzen kann – oder wechsle unter Dashboard → Abrechnung in einen höheren Tarif.

  • event_not_started

    permission_error

    Ursache: Das Modell gehört zu einem Community-Event, das noch nicht begonnen hat. Die message nennt die Startzeit.

    Lösung: Warte den Countdown auf apmix.ai/event ab oder nutze bis dahin ein anderes Modell.

  • event_ended

    permission_error

    Ursache: Der gemeinsame Token-Pool des Events ist aufgebraucht oder das Event wurde beendet.

    Lösung: Wechsle zu einem anderen Modell. Das nächste Event wird auf apmix.ai/event angekündigt.

  • account_suspended

    permission_error

    Ursache: Dein Konto wurde wegen eines Verstoßes gegen die Nutzungsbedingungen gesperrt.

    Lösung: Schreib von der E-Mail-Adresse deines Kontos an support@apmix.ai.

  • account_on_hold

    permission_error

    Ursache: Eine Zahlung für dein Konto wird geprüft; bis zur Freigabe sind Anfragen pausiert.

    Lösung: Du musst nichts tun. Achte auf eine E-Mail oder schreib an support@apmix.ai, falls es länger als einen Tag dauert.

404Nicht gefunden
  • model_not_found

    not_found_error

    Ursache: Die Modell-ID ist unbekannt oder das Modell wurde eingestellt.

    Lösung: Verwende eine ID aus /v1/models oder von der Seite „Modelle“. Anbieterpräfixe wie anthropic/ sind erlaubt.

  • not_found

    not_found_error

    Ursache: Der Pfad oder die Methode existiert nicht.

    Lösung: Verwende POST /v1/chat/completions, POST /v1/responses, POST /v1/messages, GET /v1/models oder GET /v1/usage.

429Limits
  • allowance_exhausted

    insufficient_quota · rate_limit_error

    Ursache: Dein Monatskontingent an gewichteten Tokens ist aufgebraucht. Der type ist insufficient_quota, wie bei OpenAI.

    Lösung: Wechsle unter Dashboard → Abrechnung in einen höheren Tarif oder warte bis zum Verlängerungsdatum, das auf der Seite „Übersicht“ steht.

  • daily_limit_reached

    rate_limit_error

    Ursache: Du hast das Tageslimit erreicht, das du selbst unter Einstellungen → Limits festgelegt hast.

    Lösung: Erhöhe oder entferne das Limit oder warte bis Mitternacht UTC.

  • weekly_limit_reached

    rate_limit_error

    Ursache: Du hast das Wochenlimit erreicht, das du selbst unter Einstellungen → Limits festgelegt hast.

    Lösung: Erhöhe oder entferne das Limit oder warte bis Montag, 00:00 UTC.

  • rate_limit_exceeded

    rate_limit_error

    Wiederholbar

    Ursache: Mehr als 60 Anfragen innerhalb einer Minute mit demselben Schlüssel.

    Lösung: Warte retry-after Sekunden. Verteile große Jobs auf mehrere Schlüssel.

  • upstream_rate_limited

    rate_limit_error

    Wiederholbar

    Ursache: Das Modell selbst ist gerade ausgelastet.

    Lösung: Versuche es mit Backoff erneut (1 s, 2 s, 4 s). Es wurde nichts berechnet.

502Upstream
  • upstream_error

    api_error

    Wiederholbar

    Ursache: Das Modell hat eine fehlerhafte oder unerwartete Antwort geliefert.

    Lösung: Versuche es noch einmal; tritt der Fehler erneut auf, nimm ein anderes Modell. Es wurde nichts berechnet.

503Nicht verfügbar
  • upstream_unavailable

    api_error · overloaded_error

    Wiederholbar

    Ursache: Das Modell hat nicht rechtzeitig geantwortet oder ist wegen Wartung offline.

    Lösung: Versuche es gleich noch einmal oder wechsle das Modell. Es wurde nichts berechnet.

  • no_provider

    api_error · overloaded_error

    Wiederholbar

    Ursache: Für das Modell gibt es bei uns gerade keine aktive Route (selten, bei Wartungsarbeiten).

    Lösung: Versuche es in ein paar Minuten erneut oder wähle ein anderes Modell.

Als „wiederholbar“ markierte Fehler sind vorübergehend: Warte ein, zwei Sekunden und sende dann dieselbe Anfrage erneut (die meisten SDKs machen das bei 429 und 5xx automatisch). Bei allen anderen musst du zuerst auf deiner Seite etwas ändern.

Nützliche Response-Header

x-apmix-request-id
Eindeutige ID dieser Anfrage. Gib sie an, wenn du an support@apmix.ai schreibst.
x-apmix-remaining
Gewichtete Tokens, die nach dieser Anfrage noch in deinem Monatskontingent übrig sind.
x-apmix-weighted-tokens
Was diese Anfrage gekostet hat, mit dem Multiplikator des Modells eingerechnet.
retry-after
Wartezeit in Sekunden; wird mit rate_limit_exceeded gesendet.