Skip to Content
API-ReferenzVideogenerierungVideomodelle

Videomodelle

Alle Videomodelle auf POST /v1/videos verwenden dieselbe Anfragestruktur; sie unterscheiden sich in den zulässigen Auflösungen, Dauern, Seitenverhältnissen und Generierungsmodi. Diese Fähigkeiten beschreibt für jedes Modell das Objekt video_attributes, das die Models API zurückgibt. Diese Seite erläutert die Felder dieses Objekts und wie Sie es abfragen.

Die Parameterwerte der einzelnen Modelle finden Sie auf den Seiten der Modellreihen: Seedance, Wan und HappyHorse, Hailuo.

Das Objekt video_attributes

Jedes Videomodell in der Antwort der Models API enthält ein Objekt video_attributes. Es ist die maßgebliche Beschreibung der Parameter, die das Modell akzeptiert.

{ "modes": ["t2v", "i2v", "v2v"], "resolutions": ["480p", "720p", "1080p"], "default_resolution": "720p", "min_duration_seconds": 4, "max_duration_seconds": 30, "supports_audio": true, "aspect_ratios": ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "adaptive"] }
FeldTypBeschreibung
modesstring[]Vom Modell unterstützte Generierungsmodi: t2v Text-zu-Video, i2v Bild-zu-Video, v2v Video als Referenz. Der Modus wird in der Anfrage nicht übergeben, sondern aus den Eingabefeldern bestimmt, siehe Modusbestimmung
resolutionsstring[]Zulässige Werte für resolution; Werte außerhalb der Liste werden abgelehnt
default_resolutionstringWird verwendet, wenn die Anfrage weder resolution noch size enthält
min_duration_secondsnumberUntergrenze für duration, in Sekunden
max_duration_secondsnumberObergrenze für duration, in Sekunden
supports_audiobooleanOb generate_audio: true eine Tonspur erzeugt
aspect_ratiosstring[]Zulässige Werte für aspect_ratio; adaptive übernimmt das Seitenverhältnis des Eingabebilds

video_attributes ist die verbindliche Angabe zu resolution, duration und aspect_ratio eines einzelnen Modells. Die unter Videoaufgabe erstellen aufgeführten Parameterbereiche sind die Vereinigungsmenge aller Modelle; ein dort gültiger Wert kann von einem bestimmten Modell also trotzdem abgelehnt werden.

Aktuelle Liste abfragen

Die Models API ist ein öffentlicher Endpunkt und benötigt keinen API Key. Filtern Sie nach supported_endpoints, um nur die Videomodelle zu erhalten:

Terminal
curl -s https://api.ofox.io/v1/models \ | jq -r '.data[] | select(.supported_endpoints[]? == "/v1/videos") | .id'

Neue Modelle werden unabhängig von Dokumentationsupdates freigeschaltet. Wenn Sie die aktuelle Liste benötigen, fragen Sie diesen Endpunkt direkt ab.

Nächste Schritte

Zuletzt aktualisiert am