Wan- und HappyHorse-Reihe

Die Videogenerierungsmodelle von Alibaba, insgesamt sechs, aufgerufen über den OfoxAI-Videoendpunkt POST /v1/videos. Aufgaben laufen asynchron: Nach dem Erstellen erhalten Sie eine Aufgaben-ID, über die Sie anschließend das Ergebnis abfragen.

Modellwahl

Alle sechs unterstützen Text-zu-Video und Bild-zu-Video und können eine synchrone Tonspur erzeugen (generate_audio ist standardmäßig true). adaptive übernimmt das Seitenverhältnis des Eingabebilds.

Die Tabelle entspricht den video_attributes, die die Models API zurückgibt; ändern sich die Fähigkeiten eines Modells, ist die Antwort der API maßgeblich. Abgerechnet wird pro Sekunde; die tatsächlichen Kosten stehen in usage.video_cost des Aufgabenergebnisses. Preise finden Sie auf der Modellseite .

Aufrufbeispiele

Die folgenden Beispiele zeigen nur die Anfrage zum Erstellen der Aufgabe. Den vollständigen Ablauf mit Statusabfrage und Download des Ergebnisses finden Sie unter Video API · Schnellstart.

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Ein Wasserdorf in Südchina am frühen Morgen, ein kleines Boot gleitet langsam unter einer Steinbrücke hindurch",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Die Person im Bild dreht sich um und geht in die Ferne",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "Kamerabewegung beibehalten, das Bild in den Stil einer Tuschemalerei-Animation umwandeln",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images und input_references dürfen nicht gemeinsam übergeben werden; andernfalls wird 400 references_conflict zurückgegeben.
• Wenn Sie keine Tonspur benötigen, übergeben Sie "generate_audio": false.
• Die vollständige Beschreibung der Feldstruktur finden Sie unter Videoaufgabe erstellen.

Unterschiede zu anderen Reihen

• Kein Abbruch möglich: Sobald die Aufgabe an den Upstream-Anbieter übermittelt ist, liefert DELETE /v1/videos/{id} 400 cancel_not_supported; die Aufgabe wird weiter generiert und abgerechnet. Prüfen Sie die Parameter vor dem Absenden.
• Videoadressen: In unseren Tests liefert eine abgeschlossene Aufgabe nur unsigned_urls (temporäre Adressen in Alibaba Cloud OSS), keine mirror_urls. Temporäre Adressen können nach 24 Stunden ungültig werden; laden Sie das Video daher zeitnah herunter.
• Kürzere Dauer: Wan ab 2 Sekunden, HappyHorse ab 3 Sekunden; bei den anderen Reihen beträgt das Minimum 4 Sekunden.

Wasserzeichen entfernen

Spezifische Parameter der Alibaba-Modelle werden über provider.options.dashscope übergeben:

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options wird nur an den passenden Anbieter weitergegeben; andere Anbieter erhalten es nicht. Die vollständige Beschreibung finden Sie unter Provider-Routing für Videos.

Häufige Fehler

Alle Fehlercodes finden Sie unter Fehlercodes der Video API.

Offizielle Dokumentation

• Alibaba Cloud Model Studio · Dokumentation der Modelldienste 
• OfoxAI · Videoaufgabe erstellen

FAQ