Modelle - Runbase Docs

Runbase bietet Zugriff auf erstklassige Bild- und Videogenerierungsmodelle von mehreren Anbietern über eine einzige API.

Modelle durchsuchen

Besuche die Modelle-Seite, um alle verfügbaren Modelle mit Preisen, Funktionen und Beispielausgaben zu sehen. Jedes Modell hat eine eigene Detailseite mit:

Playground — teste das Modell in deinem Browser, bevor du Code schreibst
Preisgestaltung — Kosten pro Ausführung oder pro Sekunde
Beispiele — Beispielausgaben mit Prompts
API-Referenz — modellspezifische Eingabeparameter und Codebeispiele

Playground

Jede Modellseite enthält oben einen interaktiven Playground. Melde dich an, gib einen Prompt ein und klicke auf Run model, um das Ergebnis in Sekunden zu sehen. Das ist der schnellste Weg, die Qualität und Geschwindigkeit eines Modells zu bewerten, bevor du es in deine Anwendung integrierst.

Format der Modell-ID

Jedes Modell hat eine ID im Format provider/model-name, zum Beispiel:

openai/gpt-image-2 — Bilderzeugung
bytedance/seedance-2 — Videogenerierung
google/veo-3 — Videogenerierung

Die vollständige Liste der verfügbaren Modelle und ihrer IDs findest du auf der Modelle-Seite. Modelle werden regelmäßig hinzugefügt — schau dort nach den neuesten.

Eingabeparameter

Jedes Modell definiert sein eigenes Eingabeschema. Häufige Parameter sind:

prompt (string) — Textbeschreibung dessen, was generiert werden soll
aspect_ratio (string) — Ausgabedimensionen, z. B. "1:1", "16:9"
quality (string) — Qualitätsstufe der Generierung
image_urls (string[]) — URLs von Referenzbildern (wo unterstützt)

Die vollständige Eingabespezifikation und verfügbare Optionen findest du auf der Detailseite jedes Modells.

Ein Modell verwenden

Übergebe die Modell-ID und das Eingabeobjekt an den Create-Run-Endpunkt:

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

Wenn du eine ungültige Modell-ID übergibst, erhältst du einen 400 model_not_found-Fehler. Wenn die Eingabe nicht zum Schema des Modells passt, erhältst du 400 invalid_input mit einer Beschreibung des Problems.

Bild- vs. Videomodelle

Bildmodelle geben eine oder mehrere Bild-URLs in output.urls zurück. Die Generierungszeit variiert je nach Modell, Auslastung des Anbieters und Eingabekomplexität.
Videomodelle geben eine Video-URL in output.urls zurück. Die Generierungszeit variiert je nach Modell, Dauer, Auflösung und Auslastung des Anbieters.

Die API-Struktur ist für beide identisch — der einzige Unterschied ist, wohin die Ausgab-URLs zeigen.