Fangen Sie an
Den richtigen API-Endpunkt wählen
Basis-URL, Hostauswahl und die API-Familie, an die jede Anfrage gesendet werden soll.
Modelflare verwendet einen API-Schlüssel für mehrere Protokolle. Der JSON-Umschlag ist nicht für jedes Modell gleich. Wählen Sie zuerst die Familie aus und kopieren Sie dann die Anfrage aus der passenden Anleitung oder Modellseite.
Basis-URL
Abschnitt betitelt „Basis-URL“https://modelflare.dev/v1Nach China gerichteter EdgeOne-Verkehr kann https://origin.modelflare.dev/v1 für dieselbe Anwendung verwenden. Wählen Sie den Host aus, bevor Sie eine Anfrage senden. Leiten Sie einen In-Flight-POST nicht zwischen Hosts um.
Anthropic-Clients sind die Ausnahme: ANTHROPIC_BASE_URL ist https://modelflare.dev (der Site-Ursprung, nicht /v1). Die offizielle Claude Code-CLI hängt den Nachrichtenpfad selbst an. Siehe Claude Code.
Authentifizierung
Abschnitt betitelt „Authentifizierung“Authorization: Bearer YOUR_MODELFLARE_API_KEYSenden Sie diesen Header bei jeder Anfrage, einschließlich Videoabfragen und Downloads. Erstellen Sie den Schlüssel in der Konsole. Details: Authentifizierung.
Familien
Abschnitt betitelt „Familien“https://modelflare.devChat Completions
POST /v1/chat/completions OpenAI-kompatibler Chat.
Responses
POST /v1/responses Codex und Grok Build.
Anthropic Messages
ANTHROPIC_BASE_URL=https://modelflare.dev Die Claude Code-CLI hängt den Nachrichtenpfad selbst an.
Bilder
POST /v1/images/generations GPT-Bilder, Wan-Bild und Seedream.
Gemini nativ
POST /v1/models/{model}:generateContent Gemini-Bildmodelle. Gemini CLI verwendet die /v1beta-Schreibweise selbst.
Video
POST /v1/videos Erstellt eine Aufgabe: Fragen Sie sie ab und laden Sie dann das Ergebnis herunter.
Seedance-Vermögenswerte
POST /volc/asset/* Verwalten Sie Seedance-Asset-Gruppen und anbieterseitige Medien-IDs.
Modelle
GET /v1/models Was der aktuelle Schlüssel aufrufen kann.
| Familie | Typischer Eintrag | Benutze es für |
|---|---|---|
| Chat Completions | POST /v1/chat/completions |
OpenAI-kompatibler Chat. Erste Anfrage: Quickstart. |
| Responses | POST /v1/responses |
Codex und Grok Build. |
| Anthropic Messages | Anthropic-kompatible Nachrichten | Claude Code. |
| Bilder | POST /v1/images/generations |
GPT-Bilder, Wan-Bild und Seedream. Genaue Felder: Bildmodelle. |
| Gemini nativ | POST /v1/models/{model}:generateContent |
Gemini-Bildmodelle; auch auf origin.modelflare.dev serviert. Gemini CLI erstellt den gleichen Pfad unter /v1beta, der nur von modelflare.dev bedient wird. |
| Video | POST /v1/videos |
Seedance, Wan, Kling und andere asynchrone Videomodelle. Pollen Sie GET /v1/videos/{task_id} und laden Sie GET /v1/videos/{task_id}/content herunter. Genauer Umschlag: Videomodelle. |
| Seedance-Vermögenswerte | POST /volc/asset/* |
Anbieterseitige Asset-Gruppen und Medien erstellen, abfragen, aktualisieren und löschen. Siehe Seedance Asset Management. |
| Modelle | GET /v1/models |
Listet Modelle auf, die die aktuelle Taste aufrufen kann. |
Bild- und Videoanfragen mit falschem Endpunkt werden mit unsupported_endpoint abgelehnt. Senden Sie keine Gemini-Bildfelder an /v1/images/* oder GPT-Bildfelder an generateContent. Mischen Sie keine Chat Completions-Felder in einem Responses- oder Anthropic-Client.
Bilder und Videos funktionieren mit einem Smart API Key oder einem media Gruppen-API-Schlüssel. Ergebnis-URLs können ablaufen; Übertragen Sie die Datei, nachdem eine Videoaufgabe erfolgreich ausgeführt wurde.
Seedance-Asset-Management-Aufrufe akzeptieren dieselben Schlüssel: einen Smart-API-Schlüssel oder einen media-Gruppen-API-Schlüssel. Die Asset-Erstellung erfolgt asynchron. Verwenden Sie GetAsset bis Active und übergeben Sie dann das zurückgegebene asset://<ID> unverändert in einer unterstützten Seedance-Anfrage. Das Gateway behält den Asset-Eigentum pro Benutzer und erhebt keine separate Gebühr für die Ressourcenverwaltung.
Modelle für diesen Schlüssel auflisten
Abschnitt betitelt „Modelle für diesen Schlüssel auflisten“https://modelflare.dev/v1/modelscurl https://modelflare.dev/v1/models \ -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"Die Antwort listet Modelle auf, die der aktuelle Schlüssel aufrufen kann. Es ist kein Ersatz für Modelle und Preise, das Preise, Gruppen und Protokollbezeichnungen umfasst. Verwenden Sie den genauen id im JSON-Feld model. Siehe Modelle und Gruppen.