Runs
Ein Run ist eine einzelne Generierungsanfrage. Wenn du die API aufrufst, erstellt Runbase einen Run, sendet ihn an das zugrunde liegende KI-Modell und gibt das Ergebnis zurück, sobald es bereit ist.
Jeder Run durchläuft einen Lebenszyklus:
POST /api/v1/runs → pending → processing → succeeded (or failed)
Run-Status
| Status | Bedeutung |
|---|---|
pending | In der Warteschlange, wartet darauf, von einem Worker übernommen zu werden |
processing | Wird gerade beim KI-Anbieter generiert |
succeeded | Generierung abgeschlossen — output.urls enthält das Ergebnis |
failed | Generierung fehlgeschlagen — error beschreibt, was schiefgelaufen ist |
Asynchron von Grund auf
Alle Generierungen sind asynchron. Wenn du einen Run erstellst, antwortet die API sofort mit status: "pending" und einer Run-ID. Anschließend pollst du GET /api/v1/runs/:id, bis der Status succeeded oder failed ist.
Die Dauer variiert je nach Modell, Auslastung des Anbieters und Komplexität der Eingabe:
- Bildmodelle werden in der Regel schneller abgeschlossen als Videomodelle
- Videomodelle hängen stark von Dauer, Auflösung und der Warteschlangenzeit des Anbieters ab
Kosten und Rückerstattungen
Die Kosten werden von deinem Guthaben abgezogen wenn der Run erstellt wird, nicht wenn er abgeschlossen ist. Dadurch werden die Mittel im Voraus reserviert.
Wenn der Run fehlschlägt, werden die gesamten Kosten automatisch deinem Guthaben gutgeschrieben. Du zahlst nie für fehlgeschlagene Generierungen.
Modelle
Runbase ist ein einheitliches Gateway zu Modellen mehrerer Anbieter. Jedes Modell hat eine eindeutige ID im Format provider/model-name (z. B. openai/gpt-image-2, bytedance/seedance-2).
Alle Modelle verwenden dieselbe API mit zwei Endpunkten:
POST /api/v1/runs— einen Run mit einer Modell-ID und Eingabe erstellenGET /api/v1/runs/:id— Status prüfen und Ergebnisse abrufen
Das Eingabeschema variiert je nach Modell (verschiedene Parameter für Prompt, Größe, Qualität, image_urls usw.), aber der Request-/Response-Wrapper ist immer derselbe.
Authentifizierung
Jede API-Anfrage erfordert einen API-Schlüssel im Authorization-Header als Bearer-Token. Schlüssel beginnen mit sk- und können im Dashboard erstellt werden. Siehe Authentifizierung für Details.
Guthaben
Runbase verwendet vorausbezahltes Guthaben. Du lädst dein Guthaben auf, und jeder Run zieht entsprechend der Preisgestaltung des Modells davon ab. Siehe Abrechnung für Details.