Keine Fehlermeldungen mehr! Konfigurieren Sie die Cloudflare-Basis-URL und API ganz einfach für die OpenAI-Kompatibilität.

Warum liefert meine Cloudflare AI- Basis-URL immer einen 404-Fehler zurück?

Dieser Artikel zeigt Ihnen in Sekundenschnelle, wie Sie schnell eine Cloudflare-kompatible OpenAI-Basis-URL erhalten und konfigurieren. Er enthält perfekte Vorlagen für die offizielle REST-API, das AI-Gateway-Format und Drittanbieter-Clients (Dify/One-API), mit denen Sie kostenlose KI-APIs mit nur einem Klick einrichten und nutzen können!

Letzte Woche kontaktierte mich plötzlich ein Freund, der als unabhängiger Entwickler arbeitet, und schickte mir einen Screenshot, der einen Bildschirm voller 401-Fehler zeigte. Er sagte: „Bruder, ich versuche schon den ganzen Tag, die KI-API von Cloudflare zu debuggen, aber es funktioniert einfach nicht.“

Ich habe einen Blick auf seinen Code geworfen. Die Basis-URL war auf /ai/v1 gesetzt, aber der Anfragetext war wie die offizielle REST-API formatiert, sodass die beiden überhaupt nicht übereinstimmten.

Er sagte, er wolle lediglich das SDK von OpenAI verwenden, um ein Modell auf Workers AI zu debuggen. Gibt es dabei irgendwelche Probleme?

Das ist ein großes Problem.

Die KI-Dienste von Cloudflare verwenden je nach Anwendungsfall drei völlig unterschiedliche Basis-URLs. Jede hat ihr eigenes Format und ihre eigenen Anwendungsfälle. Obwohl eine Dokumentation vorhanden ist, ist diese auf verschiedene Seiten verteilt, sodass es schwierig ist, beim ersten Versuch die richtige zu finden. Die Verwendung der falschen URL führt zu einem 401- oder 400-Fehler und verhindert den Zugriff auf den Dienst.

Als ich zum ersten Mal auf dieses Problem stieß, habe ich es mehrmals versucht, bevor ich die Lösung fand. Ich war sprachlos angesichts des Bildschirms voller Fehlermeldungen.

Heute werde ich Ihnen diese drei Wege ganz genau aufzeigen, damit Sie nach dem Lesen dieses Textes keine Fehler mehr machen.

OpenAI-kompatible Schnittstellen-Basis-URL

Beginnen wir mit der am häufigsten verwendeten Variante.

Wenn Sie das OpenAI SDK oder Tools verwenden, die benutzerdefinierte OpenAI-Formate wie LangChain, Dify, NextChat oder One-API unterstützen, dann ist dies der richtige Ansatz.

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1

Cloudflare hat dies speziell für die Kompatibilität mit dem OpenAI-Schnittstellenformat entwickelt. Fügen Sie `/chat/completions` nach dem Endpunkt für den vollständigen Dialog ein. Ersetzen Sie Ihre ursprüngliche OpenAI-Basis-URL durch diese URL und den API-Schlüssel durch Ihr Cloudflare-Token. Anschließend sollte die Anwendung direkt funktionieren. Ich habe Modelle wie `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` und `@cf/meta/llama-3.1-8b-instruct` getestet, und alle funktionieren einwandfrei.

Es ist jedoch zu beachten, dass dies nur textbasierte Dialogmodelle unterstützt.

Die offizielle native REST-API von Cloudflare

Wenn Sie Stable Diffusion für die grafische Darstellung, Whisper für die Audiotranskription oder ein anderes nicht-textuelles Modell benötigen, wählen Sie den zweiten Weg, nämlich die offizielle native REST-API von Cloudflare.

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run

Der Modellname kann entweder im Pfad angegeben werden, z. B. /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, oder im `model`-Feld des Anfragetextes. Ich bevorzuge die Angabe im Feld; der Pfad ist kürzer und übersichtlicher. Anfangs war ich bezüglich dieses Details auch etwas verwirrt. Manche Modelle akzeptieren beide Methoden, andere nur eine. Beachten Sie dies bitte beim Lesen der Dokumentation.

AI Gateway Basis-URL

Es gibt einen dritten Weg: AI Gateway.

Dieses Szenario ist etwas anders. Wenn Sie im Cloudflare-Backend ein KI-Gateway eingerichtet haben, um APIs von Drittanbietern als Proxy zu verwenden, beispielsweise um OpenAI-Anfragen über das Cloudflare-Gateway für Caching, Monitoring und Ratenbegrenzung weiterzuleiten, dann wäre die Basis-URL...

https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai

Durch das Hinzufügen von `/chat/completions` nach dem Complete-Endpunkt wird sichergestellt, dass der gesamte Datenverkehr über das Cloudflare-Gateway geleitet wird. Im Log-Panel werden Latenz und Ergebnis jeder Anfrage angezeigt. Diese Funktion ist besonders hilfreich, wenn das Team mit mehr Projekten wächst, da die Daten nicht mehr einzeln von den Backends verschiedener Anbieter durchsucht werden müssen.

So wählen Sie aus: Drei URL-Sets in einem Satz erklärt.

Okay, damit wären die drei Wege abgedeckt. Zusammenfassend lässt sich sagen, dass es nur ein Prinzip gibt.

Welchen Weg Sie einschlagen, hängt von den Werkzeugen ab, die Sie verwenden.

Um mit dem OpenAI SDK ein Dialogmodell aufzurufen, gehen Sie zu `/ai/v1`. Um ein Bild-/Audiomodell aufzurufen, gehen Sie zu `/ai/run`. Für die zentrale Verwaltung über ein Gateway gehen Sie zu `/gateway/`. Die Authentifizierungsmethode ist dieselbe: Fügen Sie `Authorization: Bearer` gefolgt von Ihrem API-Token im Header ein. Erstellen Sie das Token im Cloudflare-Backend und aktivieren Sie die Berechtigung `Workers AI: Edit`.

Wo finde ich die account_id? Melden Sie sich in Ihrem Cloudflare-Adminbereich an, scrollen Sie in der rechten Seitenleiste zum Abschnitt „API“ oder überprüfen Sie die Adressleiste Ihres Browsers; dort finden Sie die 32-stellige alphanumerische Zeichenfolge.

Ehrlich gesagt, nachdem ich meinem Freund an diesem Tag dabei geholfen hatte, sagte er etwas zu mir, was ich für völlig richtig halte: Es lag nicht daran, dass ich nicht wusste, wie es geht, sondern daran, dass die Dokumentation es mir nicht klar erklärt hatte.

Viele technische Konfigurationen funktionieren so. Sie sind nicht besonders schwierig, aber es gibt zu viele Einstiegspunkte, sodass man sich beim ersten Versuch leicht verirrt. Falls Sie bei der Konfiguration von Cloudflare AI auf verschiedene unerklärliche Fehler gestoßen sind, liegt das höchstwahrscheinlich an einer falschen Basis-URL oder einem fehlerhaften Format. Halten Sie diese drei URL-Sätze bereit; so finden Sie beim nächsten Mal ganz einfach die richtige.

Gern geschehen.

Da du bis hierher gelesen hast: Wenn dir der Beitrag gefallen hat, teile ihn bitte. Wenn du als Erster über Neuigkeiten informiert werden möchtest, kannst du mir auch folgen! ⭐

Vielen Dank fürs Lesen meines Artikels. Bis zum nächsten Mal.