Von den offiziellen SDKs zum einheitlichen Gateway migrieren: fünf Schritte ohne Änderungsaufwand
Wie bindet man Projekte, deren Code bereits auf den offiziellen OpenAI- oder Anthropic-SDKs basiert, ohne Änderung der Geschäftslogik an ein einheitliches Gateway an? Dieser Artikel liefert eine schrittweise Migrationscheckliste, Verifikationsmethoden und gängige Rollback-Szenarien.
1. Die Base URL in die Konfiguration auslagern
Wenn in Ihrem Code noch https://api.openai.com/v1 fest verdrahtet ist, besteht der erste Schritt nicht darin, die Adresse zu ändern, sondern sie in eine Umgebungsvariable zu verschieben. Das entscheidet darüber, ob Sie jederzeit zurückrollen können.
2. Gateway-Adresse und Key einsetzen
Bei Admesh müssen Sie sich nur zwei Informationen merken: Die Base URL lautet https://api.admesh.ai/v1, und der Key wird in der Konsole erstellt. Der Key wird im Klartext nur einmal bei der Erstellung angezeigt; danach bleiben nur Präfix und die letzten vier Zeichen erhalten.
Admesh-Live-Preise (Auszug)
Die Preise stammen aus der Live-Konfiguration von Admesh, in USD pro Million Token. Die vollständige Liste findest du im Modellkatalog.
| Modellname und ID | Kontextfenster | Preis eingeben / 1 M | Ausgabepreis / 1 M | Cache-Treffer / 1 M |
|---|---|---|---|---|
Claude Fable 5 anthropic/claude-fable-5 | 1M | $3.25 / 1M | $16.25 / 1M | $0.325 / 1M |
Claude Fable 5.1 anthropic/claude-fable-5-1 | 1M | $3.25 / 1M | $16.25 / 1M | $0.08125 / 1M |
Claude Haiku 4.5 anthropic/claude-haiku-4-5-20251001 | 200K | $0.325 / 1M | $1.625 / 1M | $0.0325 / 1M |
Claude Haiku 5.5 anthropic/claude-haiku-5-5 | 1M | $0.0325 / 1M | $0.1625 / 1M | $0.00325 / 1M |
Claude Opus 4.5 anthropic/claude-opus-4-5-20251101 | 200K | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Claude Opus 4.6 anthropic/claude-opus-4-6 | 1M | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Claude Opus 4.7 anthropic/claude-opus-4-7 | 1M | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Claude Opus 4.8 anthropic/claude-opus-4-8 | 1M | $1.625 / 1M | $8.125 / 1M | $0.1625 / 1M |
Die oben genannten Preise sind die Standardpreise pro Einheit für öffentliche Kanäle; die Abrechnung erfolgt auf Basis des tatsächlichen Token-Verbrauchs. Den vollständigen Modellkatalog anzeigen
3. Modellnamen durch namespace/model ersetzen
Das Gateway verwendet öffentliche Modellnamen im Format namespace/model (z. B. anthropic/…, openai/…, deepseek/…, qwen/…). Die vollständige Liste finden Sie unter /v1/models oder im Modellkatalog der Konsole; auch die Dokumentationsseite enthält eine [Modellliste](https://docs.admesh.ai/zh/docs/api-reference/models).
Modellnamen nicht im Code fest verdrahten – in die Konfiguration auslagern; ein Modellwechsel ist dann nur eine Konfigurationsänderung.
4. Dual-Write-Vergleich
- Dieselbe Charge echter Anfragen sowohl an die offizielle API als auch an das Gateway senden.
- Drei Dinge vergleichen: Antwortstruktur (ob die Felder übereinstimmen),
usage-Feld (Token-Zählweise) und Verhalten der Streaming-Fragmentierung. - Fehlerantworten prüfen: absichtlich eine Anfrage mit falschem Parameter senden und bestätigen, dass das Fehlercode-Format den Erwartungen entspricht.
- Unterschiede bei Latenz und Kosten auf beiden Seiten erfassen und als Baseline für spätere Optimierungen festhalten.
5. Canary-Rollout und Rollback
- Zuerst nicht-kritischen Traffic (interne Tools, risikoarme Aufgaben) umstellen und eine Woche beobachten.
- Drei Kennzahlen überwachen: Fehlerrate, P95-Latenz und Kosten pro Anfrage.
- Das Rollback-Szenario einfach halten: die Umgebungsvariable zurück auf die offizielle Adresse ändern, ohne Codeänderung.
- Nach bestätigter Stabilität das Hauptgeschäft migrieren und gleichzeitig Dokumentation und Alarmkonfiguration des Teams aktualisieren.
Was ist mit dem nativen Anthropic-Protokoll?
Manche Codes verwenden direkt die Form der Anthropic Messages API (/v1/messages, max_tokens als Pflichtfeld, system als eigenständiges Feld). Admesh bietet gleichzeitig einen [Anthropic-kompatiblen Endpunkt](https://docs.admesh.ai/zh/docs/api-reference/anthropic-compatible); solche Projekte müssen nicht auf OpenAI-Stil umgeschrieben werden, sondern nur Base URL und Key austauschen.
FAQ
Muss bei der Migration Geschäftscode geändert werden?
Werden fertige Tools wie LangChain, Cursor oder NextChat unterstützt?
Kann das bisherige offizielle Konto nach der Migration behalten werden?
Referenzen
Diese Modelle über ein Gateway aufrufen
Admesh bietet eine einheitliche OpenAI-kompatible API: eine Base URL und ein Key für Claude, GPT, DeepSeek und mehr. Neue Konten erhalten Testguthaben ohne Ablaufdatum.