Wie man evolink Smart router verwendet: 5-Minuten-Setup für einheitliches KI-Modell-Routing
Tutorial

Wie man evolink Smart router verwendet: 5-Minuten-Setup für einheitliches KI-Modell-Routing

EvoLink Team
EvoLink Team
Product Team
11. März 2026
6 Min. Lesezeit
Stand 11. März 2026 bestätigt das Repository, dass EvoLink einen OpenAI-kompatiblen Chat-Completions-Endpunkt unter https://api.evolink.ai/v1/chat/completions und eine Basis-URL von https://api.evolink.ai/v1 über mehrere Integrationsleitfäden hinweg bereitstellt. Dieses Tutorial verwendet diese bestätigten Integrationsmuster und vermeidet undokumentierte Versprechen über versteckte Routing-Logik, exakte Modell-Pools oder kontospezifische Rabatte.
evolink Smart router ist der Smart-Routing-Einstiegspunkt innerhalb des einheitlichen API-Workflows von EvoLink. Der praktische Wert ist nicht "automatische Magie". Der Wert besteht darin, dass Ihre Anwendung eine einzige Integrationsschnittstelle beibehalten kann, während EvoLink Modellauswahlentscheidungen innerhalb der Gateway-Schicht verwaltet.
Verwenden Sie es, wenn Sie möchten:
  • ein OpenAI-kompatibles Anforderungsformat beibehalten
  • anwendungsseitiges Wechseln zwischen Anbietern oder Modellfamilien reduzieren
  • das geroutete Modell in der API-Antwort überprüfen, anstatt überall ein Modell fest zu codieren
  • mit einem flexiblen Gateway-Pfad beginnen, bevor Sie ein festes Modell für produktionskritische Abläufe festlegen

Wenn Sie bereits das genaue Modell, das Latenzprofil und das Kostenziel kennen, das Sie benötigen, ist eine feste Modell-ID normalerweise die sauberere Wahl.

Was Sie vor dem Start benötigen

ElementWas vorzubereiten istWarum es wichtig ist
EvoLink-KontoMelden Sie sich bei evolink.ai anSie benötigen Zugriff auf Dashboard-Einstellungen und Abrechnung
API-SchlüsselErstellen Sie einen im EvoLink-DashboardDas Gateway verwendet Bearer-Token-Authentifizierung
Basis-URLhttps://api.evolink.ai/v1Funktioniert mit OpenAI-kompatiblen SDK-Flows, die an anderer Stelle im Repository verwendet werden
Smart-Router-Modell-IDevolink/autoVerwenden Sie diese Modell-ID, um Smart Routing über das Gateway zu aktivieren

Ihre erste Anfrage mit curl

curl https://api.evolink.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "evolink/auto",
    "messages": [
      {
        "role": "user",
        "content": "Erklären Sie Vektordatenbanken in einem kurzen Absatz."
      }
    ]
  }'
Diese Anfrage verwendet dieselbe Form wie ein normaler OpenAI-kompatibler Chat-Completion-Aufruf. Der Hauptunterschied besteht darin, dass das Feld model auf Ihren Smart-Routing-Einstiegspunkt anstatt auf ein festes Anbietermodell verweist.

Python-Beispiel

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.evolink.ai/v1"
)

response = client.chat.completions.create(
    model="evolink/auto",
    messages=[
        {
            "role": "user",
            "content": "Fassen Sie den Kompromiss zwischen Latenz und Modellqualität zusammen."
        }
    ]
)

print(response.model)
print(response.choices[0].message.content)

Node.js-Beispiel

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.EVOLINK_API_KEY,
  baseURL: "https://api.evolink.ai/v1",
});

const response = await client.chat.completions.create({
  model: "evolink/auto",
  messages: [
    {
      role: "user",
      content: "Listen Sie drei Gründe auf, warum Teams ein KI-Gateway verwenden.",
    },
  ],
});

console.log(response.model);
console.log(response.choices[0].message.content);

Wie man die Antwort liest

Eine Smart-Router-Antwort folgt weiterhin der vertrauten Chat-Completions-Struktur:

{
  "id": "chatcmpl-example",
  "object": "chat.completion",
  "created": 1773187200,
  "model": "provider/model-selected-at-runtime",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Eine Vektordatenbank speichert Embeddings, damit die semantische Suche ähnliche Inhalte effizient abrufen kann."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 17,
    "completion_tokens": 18,
    "total_tokens": 35
  }
}
Das Feld model ist das Erste, was Sie in der Produktion protokollieren sollten. Es teilt Ihnen mit, welches geroutete Modell die Anfrage tatsächlich bearbeitet hat, was für Debugging, Ausgabenanalyse und die Entscheidung nützlich ist, ob Sie den Smart Router weiter verwenden oder eine Arbeitslast auf ein festes Modell umstellen sollten.

Smart Router vs festes Modell

Szenarioevolink Smart routerFeste Modell-ID
Frühes PrototypingSehr geeignetNormalerweise unnötig
Gemischte ArbeitslastenSehr geeignetKann betrieblich laut werden
Stabiler Produktionspfad mit striktem QAMöglich, aber sorgfältig überprüfenNormalerweise besser
Kostenoptimierung pro AnwendungsfallGuter AusgangspunktBesser, sobald Sie das Gewinnermodell kennen
Anbieter-Failover-StrategieEinfacher zu zentralisierenSie verwalten mehr Logik im App-Code

Das Muster, das normalerweise am besten skaliert, ist einfach:

  1. Beginnen Sie mit evolink Smart router, während sich die Arbeitslast noch ändert.
  2. Protokollieren Sie den gerouteten model-Wert und vergleichen Sie Kosten, Latenz und Ausgabequalität.
  3. Legen Sie ein festes Modell für Abläufe fest, die eine engere betriebliche Vorhersagbarkeit benötigen.

Was kontospezifisch bleibt

Der ursprüngliche Entwurf enthielt mehrere Produktaussagen, die nicht als harte Fakten ohne eine verifizierte Quelle, die mit Ihrem Konto oder der offiziellen Dokumentation verknüpft ist, veröffentlicht werden sollten. Behandeln Sie diese als zu bestätigende Punkte, bevor Sie externe Versprechen veröffentlichen:

  • die genaue öffentliche Modellkennung für evolink Smart router
  • die genaue Größe des verfügbaren Routing-Pools
  • jedes Versprechen über "keine Routing-Gebühr"
  • jede prozentuale Rabattaussage gegenüber direkten Anbietern
  • SLA-Aussagen wie 99,9% Betriebszeit
  • welche erweiterten Funktionen über den Smart Router für jedes geroutete Modell garantiert sind

Wenn Sie möchten, dass dieser Artikel später verkaufsorientierter wird, besteht die saubere Methode darin, diese Punkte erst hinzuzufügen, nachdem sie auf einer Erstanbieter-Preisseite, Produktseite oder offiziellen API-Dokumentation dokumentiert wurden.

Produktions-Checkliste vor dem Rollout

PrüfungWarum es zu überprüfen ist
Router-Modell-ID bestätigenVerhindert Kopier-Einfüge-Fehler aus Platzhalter-Code
Antwort-model-Feld testenBestätigt Sichtbarkeit des gerouteten Modells für Beobachtbarkeit
Kosten bei echten Prompts vergleichenEffektive Preisgestaltung hängt von ausgewählten Modellen und Arbeitslastform ab
Latenz nach Anforderungstyp messenSmart Routing ist nur nützlich, wenn es Ihrem benutzerseitigen SLA entspricht
Entscheiden, wann ein festes Modell festgelegt werden sollEinige Abläufe benötigen deterministische Ausgabe oder engere QA-Abdeckung

Nächste Schritte

Sobald Ihre erste Anfrage funktioniert, ist die wertvollste Folgeaktion nicht mehr Beispielcode. Es ist Instrumentierung.

  • protokollieren Sie response.model
  • speichern Sie Token-Nutzung nach Feature oder Route
  • vergleichen Sie Smart-Router-Traffic mit einer Baseline mit festem Modell
  • überprüfen Sie verfügbare feste Modelle im EvoLink-Modellkatalog

Das gibt Ihnen die Daten, die Sie benötigen, um zu entscheiden, ob der Gateway-Pfad die Kosteneffizienz und Produktionszuverlässigkeit für Ihre tatsächliche Arbeitslast verbessert.

FAQ

Nein. Eine feste Modell-ID behält die Auswahlentscheidung in Ihrer Anwendungskonfiguration. evolink Smart router behält diese Entscheidung in der Gateway-Schicht.

Nein. Basierend auf den vorhandenen Beispielen des Repositorys bleibt das Integrationsmuster OpenAI-kompatibel. Sie ändern hauptsächlich die Basis-URL und die Modellkennung.

Wo finde ich die richtige Smart-Router-Modell-ID?

Bestätigen Sie sie in Ihrem EvoLink-Dashboard oder der offiziellen Dokumentation, bevor Sie Kopier-Einfüge-Code veröffentlichen oder versenden. Der ursprüngliche Entwurf enthielt keine lokal verifizierte Kennung.

Ja, wenn Ihre Arbeitslast sich noch entwickelt und Sie einen einzigen Gateway-Einstiegspunkt möchten. Für streng kontrollierte Abläufe vergleichen Sie ihn vor dem vollständigen Rollout mit einem festen Modell.

Was sollte ich nach der Integration zuerst protokollieren?

Protokollieren Sie response.model, Latenz, Token-Nutzung und den Feature-Namen, der die Anfrage ausgelöst hat. Diese vier Felder erklären normalerweise die meisten Routing- und Kostenfragen.

Garantiert Smart Routing niedrigere Kosten?

Nicht automatisch. Es kann effektive Kosten verbessern, aber das Ergebnis hängt von Ihren Prompts, ausgewählten Downstream-Modellen und Kontokonfiguration ab.

Wann sollte ich von Smart Router zu einem festen Modell wechseln?

Wechseln Sie, wenn eine Arbeitslast einen klaren Gewinner bei Qualität, Latenz oder Kosten hat und Sie engeres QA und vorhersagbareres Produktionsverhalten möchten.

Bereit, Ihre KI-Kosten um 89 % zu senken?

Starten Sie noch heute mit EvoLink und erleben Sie die Vorteile intelligenter API-Routing.