Die Claude API aus dem eigenen Code aufrufen
Ändern Sie zwei Dinge in Ihrem Code: die Base URL auf https://api.relayswitch.io/v1 und den API-Key auf einen RelaySwitch-Key. Das Anthropic SDK und das OpenAI SDK laufen ohne weitere Änderung, mit 13 Claude-Modellen, deren Preise direkt aus dem Katalog gelesen werden.
01Was sich gegenüber dem direkten Aufruf bei Anthropic ändert
Wer die Claude API direkt nutzt, eröffnet ein Konto in der Anthropic Console, lädt dort Guthaben auf und ruft die API mit einem Key von dort auf. Hier wird dieser Teil ersetzt: Sie laden Guthaben bei RelaySwitch auf, verwenden einen RelaySwitch-Key, und der Request geht an ein Gateway, das ihn an das Modell weiterleitet. Für Ihren Code ändern sich nur Base URL und Key; Request-Body, Modell-ID, Streaming und Tool Calling bleiben gleich.
Abgerechnet wird pro Token mit drei Preisen: Input, Cached Input und Output. Der Preis in der Tabelle ist der Preis, der vom Guthaben abgezogen wird.
Jede Antwort trägt im Header eine Request-ID. Mit dieser ID rufen Sie den signierten Beleg ab, der Modell-ID, abgerechnete Token und Kosten festhält.
02Der erste Request mit curl
Prüfen Sie Key und Adresse zuerst mit curl, bevor Sie beides ins SDK übernehmen.
Der Key darf im Header x-api-key oder als Authorization: Bearer gesendet werden, ein Request darf aber nur einen Key tragen. Für Streaming setzen Sie stream auf true; die Antwort kommt dann als Server-Sent Events.
curl -i https://api.relayswitch.io/v1/messages \ -H "Authorization: Bearer sk-relay-..." \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'03Anthropic SDK für Python
Für neuen Code und für Code, der Claude-eigene Funktionen wie das Feld system, die native Tool-Use-Struktur und Prompt-Cache-Markierungen nutzt, passt das Anthropic SDK über /messages am besten. Sie setzen nur base_url und api_key.
Das Anthropic SDK hängt /v1/messages selbst an die Base URL an. Das Gateway akzeptiert ein doppeltes /v1, deshalb verwenden alle Beispiele https://api.relayswitch.io/v1.
import anthropic client = anthropic.Anthropic(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.messages.create( model="claude-fable-5.1", max_tokens=300, messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.content[0].text)print(reply.usage)04OpenAI SDK: bestehender Code bleibt, wie er ist
Ist Ihre Anwendung bereits im OpenAI-Format geschrieben oder ruft derselbe Code auch Modelle anderer Entwickler auf, verwenden Sie /chat/completions und setzen in model eine Claude-ID ein. Beide Formate nutzen denselben Key, dasselbe Guthaben und dieselben Preise.
Beispiele für weitere SDKs und Frameworks stehen in der Dokumentation und in den Anleitungen pro Tool, beide auf Englisch. Für Claude Code siehe die Claude-Code-Seite.
from openai import OpenAI client = OpenAI(base_url="https://api.relayswitch.io/v1", api_key="sk-relay-...")reply = client.chat.completions.create( model="claude-fable-5.1", messages=[{"role": "user", "content": "Reply with ok"}],)print(reply.choices[0].message.content)05Aktuelle Preise der Claude-Modelle
In USD pro Million Token, beim Rendern der Seite aus dem Katalog gelesen. Token, die den Prompt Cache treffen, etwa ein langer System-Prompt, wiederholt gesendete Dokumente oder der Verlauf einer Unterhaltung über mehrere Turns, werden zum Preis für Cached Input abgerechnet, der unter dem Input-Preis liegt. Der Beleg jedes Requests weist Input-, Cached-Input- und Output-Token getrennt aus, sodass sich jede Position nachrechnen lässt.
| Modell | Entwickler | Input | Output | Kontext |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
USD pro Million Token
06Die häufigsten Fehlercodes
Die Status 401 bis 404 werden zurückgegeben, bevor der Request das Modell erreicht, und 429, 502 und 503 enthalten keine Antwort; nichts davon wird abgerechnet. Der Fehler-Body folgt der Fehlerstruktur des Formats, das Sie verwenden.
401 invalid_api_key | Der Key wurde nicht gesendet, ist falsch oder wurde widerrufen. |
402 insufficient_balance | Das Guthaben reicht nicht. Ein aufgebrauchtes Budget oder Ausgabenlimit eines Keys hat einen eigenen Fehlercode. |
403 scope_denied | Die Modell-ID steht nicht auf der Allowlist dieses Keys. |
404 model_not_found | Die Modell-ID gibt es im Katalog nicht; meist ein Tippfehler. |
429 rate_limited | Das Rate Limit des Keys ist erreicht; der Header retry-after nennt die Wartezeit in Sekunden. |
| 502 / 503 | Die Route zum Modell ist gestört, oder vorübergehend antwortet keine Route. |
07Vor dem Produktivbetrieb
Legen Sie für die Produktion einen eigenen Key an und stellen Sie ihn nach Bedarf ein: Budget, tägliches Ausgabenlimit, Modell-Allowlist und IP-Allowlist. Standardmäßig ist jeder Key auf 200 Requests pro Minute begrenzt, und dieser Wert lässt sich am Key ändern. Lesen Sie bei fehlgeschlagenen Requests den Header retry-after, bevor Sie es erneut versuchen, und speichern Sie die Request-ID aus der Fehlermeldung in Ihren Logs, denn sie hilft bei der Fehlersuche.
Eine Modell-ID wird von mehreren Routen bedient. Antwortet eine Route mit 5xx oder 429, wechselt der Request automatisch zur nächsten Route, zum selben Preis; ein Modell mit nur einer Route antwortet mit 503.
Häufige Fragen
- Anthropic-Format oder OpenAI-Format?
- Beides geht, mit demselben Key und derselben Base URL (https://api.relayswitch.io/v1). Das Anthropic SDK nutzt /messages, das OpenAI SDK /chat/completions, und die Claude-Modell-IDs werden in beiden exakt gleich geschrieben.
- Muss die Base URL /v1 enthalten?
- Ja. Tragen Sie https://api.relayswitch.io/v1 ein, das SDK hängt /messages oder /chat/completions selbst an.
- Wird Streaming unterstützt?
- Ja. Setzen Sie im Request stream: true, die Antwort kommt dann als Server-Sent Events. Alle Modelle unterstützen Streaming.
- Wie stelle ich sicher, dass wirklich Claude aufgerufen wird und kein anderes Modell?
- Es gibt zwei Wege, bei denen Sie dieser Seite nichts glauben müssen. Jedes Modell erhält einmal täglich denselben Test-Prompt, und die Antwort wird mit den früheren Ergebnissen verglichen; die Ergebnisse sind unter https://api.relayswitch.io/v1/proof einsehbar. Außerdem hat jeder Request einen signierten Beleg (GET https://api.relayswitch.io/v1/requests/:id/receipt) mit Modell-ID, abgerechneten Token und Kosten, der sich offline mit dem Public Key verifizieren lässt.
- Werden fehlgeschlagene Requests trotzdem abgerechnet?
- Requests, die scheitern, bevor sie das Modell erreichen, oder die das Modell nicht beantwortet, werden nicht abgerechnet. Das umfasst die Status 401 bis 404 sowie 429, 502 und 503.
- Wie lade ich auf, und brauche ich KYC?
- Per Karte oder USDT, USDC, BTC, ETH, SOL, ab $10. Das Guthaben wird in US-Dollar geführt, verfällt nicht, und es gibt kein Abo. Das Konto wird mit einer E-Mail-Adresse eröffnet, ohne Identitätsprüfung.
Eine Zeile base_url ändern
Base URL https://api.relayswitch.io/v1, Claude-Modelle pro Token zum Katalogpreis abgerechnet, mit öffentlich einsehbarer täglicher Prüfung.