API Reference
Überblick
Endpunkte und Konventionen der asynchronen Bild-API.
SeedRouter stellt Bild-, Video-, Audio- und Textmodelle über eine API und einen API-Schlüssel bereit. Bild-, Video- und Audiomodelle laufen als asynchrone Aufgaben: Du sendest eine Anfrage, erhältst eine Aufgaben-ID und fragst das Ergebnis ab. Textmodelle antworten direkt, im Anfrageformat des jeweiligen Modellanbieters.
Basis-URL
https://api.seedrouter.aiVerwende HTTPS und sende Anfragekörper als JSON. Die Audio-Endpunkte erwarten stattdessen einen Upload als multipart/form-data.
Authentifizierung
Sende deinen Schlüssel bei jeder Anfrage als Bearer-Token, auch bei Aufgabenabfragen:
Authorization: Bearer YOUR_API_KEYDer Endpunkt für Anthropic Messages akzeptiert den Schlüssel auch in x-api-key, zusammen mit dem Header anthropic-version. Siehe Authentifizierung.
Endpunkte für Medienaufgaben
| Methode | Pfad | Zweck |
|---|---|---|
| POST | /v1/images/generations | Sendet eine Aufgabe zur Bilderzeugung oder -bearbeitung: GPT Image, Nano Banana und Midjourney. |
| POST | /v1/videos/generations | Sendet eine Videoaufgabe: Seedance 2.5 und 2.0 (Anfragetext für ModelArk), Veo 3.1, Kling 3.0, MiniMax H3 und SD Video. |
| POST | /v1/audio/transcriptions | Sendet eine Audiodatei zur Transkription mit Whisper-1. |
| POST | /v1/audio/translations | Sendet eine Audiodatei zur Übersetzung ins Englische mit Whisper-1. |
| GET | /v1/tasks/{id} | Liest Status und Ergebnis einer Bild-, Video- oder Audioaufgabe. |
Referenzbilder, -videos und -audios übergibst du als URLs im Anfragekörper. Eine Bildanfrage wird zur Bearbeitung, wenn sie Eingabebilder enthält. Die Referenz jedes Modells listet seine Parameter.
Text-Endpunkte
| Methode | Pfad | Anfrageformat |
|---|---|---|
| POST | /v1/chat/completions | OpenAI Chat Completions |
| POST | /v1/responses | OpenAI Responses |
| POST | /v1/messages | Anthropic Messages |
| POST | /v1beta/models/{model}:generateContent | Google Gemini |
| POST | /v1beta/models/{model}:streamGenerateContent | Google Gemini, gestreamt |
| GET | /v1/models | Listet die verfügbaren Modelle |
Nicht jedes Textmodell unterstützt jedes Format. Die API-Referenz des Modells nennt die Formate, die es akzeptiert; Claude Opus 5.5 etwa akzeptiert Chat Completions, Responses und Messages, während die Gemini-Textmodelle die /v1beta-Pfade verwenden.
Ablauf einer Anfrage
Medienaufgaben
- Sende die Anfrage. Die Antwort ist eine Aufgabe, nicht die fertige Datei: Speichere ihre
id. - Frag die Aufgabe ab, bis sie einen Endzustand erreicht. Aufgaben auf
/v1/tasks/{id}meldenprocessingund danachcompletedoderfailed. - Lies das Ergebnis. Bilder stehen in
output.data[].url, Videos inoutput.video_url, die Ausgabe von Whisper inoutput.url. Jeder Ergebnislink zeigt auf den Speicher von SeedRouter.
Bei einem Fehlschlag prüfst du error.code und error.message. Fehlgeschlagene Aufgaben werden nicht berechnet. Einen Webhook für den Abschluss gibt es nicht; frag die Aufgabe stattdessen ab, wie unter Webhooks beschrieben.
Textanfragen
Eine Textanfrage liefert die Antwort des Modells in derselben Antwort, in der offiziellen Antwortstruktur des Anbieters. Setze stream auf true oder nutze bei Gemini :streamGenerateContent, um Server-Sent Events zu erhalten. Textmodelle werden pro Token abgerechnet.