BroadRouter
Loslegen

Basis-URL (Base URL)

Aktualisiert

Eine Basis-URL ist die feste Stammadresse einer API, etwa https://api.example.com/v1, die ein Client vor jeden Endpoint-Pfad wie /chat/completions setzt. In OpenAI-kompatiblen SDKs lenkt eine geänderte Basis-URL, zusammen mit API-Schlüssel und Modell-ID, denselben Code zu einem anderen Anbieter.

Auch genannt: Basis-URL, Base URL, API-Basis-URL, Endpoint-URL, API base URL, api_base, baseURL, OPENAI_BASE_URL, endpoint URL

Jede Anfrage eines SDK besteht aus Basis-URL plus Pfad. Stimmt die Basis-URL, funktioniert der Rest des Clients unverändert.

So funktioniert es

Der Client setzt zwei Teile zusammen:

Teil Beispiel
Basis-URL https://inference.broadnet.ai/v1
Endpoint-Pfad /chat/completions
Vollständige Request-URL https://inference.broadnet.ai/v1/chat/completions

Im Code hängt der Parametername von der Bibliothek ab:

# Python SDK
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
// Node SDK
const client = new OpenAI({ baseURL: "https://inference.broadnet.ai/v1", apiKey: process.env.BROADNET_API_KEY });

Beide offiziellen SDKs greifen auf die Umgebungsvariable OPENAI_BASE_URL zurück und auf die Adresse von OpenAI, wenn nichts gesetzt ist. Andere Tools verwenden Namen wie api_base oder OPENAI_API_BASE.

Warum es wichtig ist

Die Basis-URL macht den Wechsel zu einer OpenAI-kompatiblen API zu einer reinen Konfigurationsänderung. Sie entscheidet auch, wohin Ihre Prompts gehen und wer Ihnen eine Rechnung stellt. Ein falscher Wert kann Traffic, und Ihren API-Schlüssel, an den falschen Anbieter schicken. Halten Sie sie in der Konfiguration neben dem Schlüssel, nicht fest einkodiert an mehreren Stellen.

Router nutzen dieselbe Idee: Sie richten die Basis-URL auf den Router statt auf einen Modellanbieter.

Bei BroadNet Inference

Die Basis-URL lautet https://inference.broadnet.ai/v1 für jedes Modell: Chat, Vision und Speech-to-Text. Chat geht an /chat/completions, Transkription an /audio/transcriptions. Der curl-Schnellstart zeigt eine erste Anfrage, und die LangChain-Anleitung zeigt, wo die Einstellung in einem Framework sitzt.

Häufige Fehler

  • Fehlendes /v1. https://inference.broadnet.ai ohne /v1 führt im SDK zu 404-Fehlern.
  • Doppelter Pfad. Wer den vollständigen Endpoint, etwa .../v1/chat/completions, als Basis-URL einfügt, lässt das SDK .../chat/completions/chat/completions aufrufen.
  • Übrig gebliebene Umgebungsvariablen. Eine alte OPENAI_BASE_URL in Ihrer Shell überschreibt, was Sie erwarten. Geben Sie sie aus, wenn Anfragen am falschen Ziel landen.
  • Unverschlüsseltes HTTP. Verwenden Sie immer https://. Bearer-Schlüssel müssen über TLS übertragen werden.
  • URL geändert, Modell nicht. Jeder Anbieter hat eigene Modell-IDs, etwa broadnet/deepseek-v4.1-flash.

Ziehen Sie eine ganze App um? Arbeiten Sie die Checkliste für die Migration durch.

Häufige Fragen

Muss die Basis-URL auf /v1 enden?

Bei OpenAI-kompatiblen SDKs ja, wenn die Pfade des Anbieters mit /v1 beginnen. Das SDK hängt dann Pfade wie /chat/completions an. Den genauen Wert finden Sie in der Dokumentation des Anbieters.

Kann ich die Basis-URL setzen, ohne den Code zu ändern?

Ja. Die offiziellen OpenAI-SDKs für Python und Node lesen die Umgebungsvariable OPENAI_BASE_URL, wenn Sie keine Basis-URL übergeben. Manche Tools verwenden eigene Variablennamen, etwa OPENAI_API_BASE in Aider.

Wie lautet die Basis-URL von BroadNet Inference?

https://inference.broadnet.ai/v1

Als Markdown lesenChatGPT fragenClaude fragenPerplexity fragen