HappyHorse-1.1-R2V erstellt eine neue Videoszene aus Referenzbildern und einer Textvorgabe. Alibaba richtet das Modell darauf aus, erkennbare Figuren, Objekte und den visuellen Stil bei der Erzeugung von Bewegung zu erhalten. Die Referenzen bestimmen Inhalt und Erscheinungsbild der Szene; der Text beschreibt, wie diese Elemente miteinander interagieren sollen.
Es können ein bis neun Bilder verwendet werden. Sie können eine Figur, einen Gegenstand, die Umgebung oder die gestalterische Darstellung vorgeben. In der Beschreibung lassen sich die Nummer einer Referenz und ein konkretes Objekt darin nennen, um das Bildmaterial mit dem entsprechenden Teil der Handlung zu verbinden. Das ist besonders nützlich, wenn Elemente mehrerer Bilder zu einer Komposition zusammengeführt werden sollen.
Anders als im Modus mit Anfangsframe dienen die Referenzen hier als Grundlage für den Inhalt einer neuen Szene. Die Textvorgabe ist erforderlich: Sie verbindet das Erscheinungsbild der Objekte mit der Handlung, der Kamerabewegung und der gesamten Inszenierung. Der Hersteller hebt visuelle Konsistenz und filmische Bewegung hervor; das Ergebnis bleibt eine Generierung und ist kein Zusammenschnitt der Ausgangsbilder.
Akzeptiert werden JPEG, JPG, PNG und WEBP mit höchstens 20 MB pro Datei. Die kürzere Bildseite muss mindestens 400 Pixel lang sein; empfohlen wird Material auf dem Niveau von 720P oder höher. Die Eingabe dieses Modus besteht ausschliesslich aus Bildern und Text.
Das Ergebnis wird als MP4 mit 24 Bildern pro Sekunde gespeichert. Die Dauer wird als ganze Zahl zwischen 3 und 15 Sekunden festgelegt. Bei der Auflösung stehen 480P, 720P und 1080P zur Auswahl; die Erzeugung einer Tonbegleitung wird unterstützt.
Verfügbar sind horizontale, vertikale und quadratische Bildformate: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 und 21:9. Mit dem Format lässt sich der Kompositionsraum der neuen Szene im Voraus bestimmen.
Der Text kann in jeder Sprache verfasst werden. Die Grenze beträgt 5000 nichtchinesische oder 2500 chinesische Zeichen; der überzählige Teil wird abgeschnitten. Die wichtigsten Rollen der Referenzen, die Handlung und die Bewegung müssen in diesem Umfang Platz finden. Der anfängliche Zufallswert kann die Ähnlichkeit von Varianten beeinflussen, garantiert aber keine exakte Wiederholung eines Clips.
", "aboutText": "HappyHorse-1.1-R2V erstellt eine neue Videoszene aus Referenzbildern und einer Textvorgabe. Alibaba richtet das Modell darauf aus, erkennbare Figuren, Objekte und den visuellen Stil bei der Erzeugung von Bewegung zu erhalten. Die Referenzen bestimmen Inhalt und Erscheinungsbild der Szene; der Text beschreibt, wie diese Elemente miteinander interagieren sollen.\n\n### Rollen der visuellen Vorlagen\n\nEs können ein bis neun Bilder verwendet werden. Sie können eine Figur, einen Gegenstand, die Umgebung oder die gestalterische Darstellung vorgeben. In der Beschreibung lassen sich die Nummer einer Referenz und ein konkretes Objekt darin nennen, um das Bildmaterial mit dem entsprechenden Teil der Handlung zu verbinden. Das ist besonders nützlich, wenn Elemente mehrerer Bilder zu einer Komposition zusammengeführt werden sollen.\n\nAnders als im Modus mit Anfangsframe dienen die Referenzen hier als Grundlage für den Inhalt einer neuen Szene. Die Textvorgabe ist erforderlich: Sie verbindet das Erscheinungsbild der Objekte mit der Handlung, der Kamerabewegung und der gesamten Inszenierung. Der Hersteller hebt visuelle Konsistenz und filmische Bewegung hervor; das Ergebnis bleibt eine Generierung und ist kein Zusammenschnitt der Ausgangsbilder.\n\nAkzeptiert werden JPEG, JPG, PNG und WEBP mit höchstens 20 MB pro Datei. Die kürzere Bildseite muss mindestens 400 Pixel lang sein; empfohlen wird Material auf dem Niveau von 720P oder höher. Die Eingabe dieses Modus besteht ausschliesslich aus Bildern und Text.\n\n### Dauer, Bildformat und Ton\n\nDas Ergebnis wird als MP4 mit 24 Bildern pro Sekunde gespeichert. Die Dauer wird als ganze Zahl zwischen 3 und 15 Sekunden festgelegt. Bei der Auflösung stehen 480P, 720P und 1080P zur Auswahl; die Erzeugung einer Tonbegleitung wird unterstützt.\n\nVerfügbar sind horizontale, vertikale und quadratische Bildformate: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 und 21:9. Mit dem Format lässt sich der Kompositionsraum der neuen Szene im Voraus bestimmen.\n\nDer Text kann in jeder Sprache verfasst werden. Die Grenze beträgt 5000 nichtchinesische oder 2500 chinesische Zeichen; der überzählige Teil wird abgeschnitten. Die wichtigsten Rollen der Referenzen, die Handlung und die Bewegung müssen in diesem Umfang Platz finden. Der anfängliche Zufallswert kann die Ähnlichkeit von Varianten beeinflussen, garantiert aber keine exakte Wiederholung eines Clips.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "a7e2dc173b35d19986cc24c8cb7cf5180e7e4ff02403fdcb02dab76f19fcb8f9", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de-ch", "methods": [ { "html": "happyhorse-1.1-r2vModell zur Videoerzeugung aus Referenzbildern und einem Textszenario. Hilft, das Erscheinungsbild von Figuren, Gegenstände und den visuellen Stil in einer neuen Szene beizubehalten.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
HappyHorse-1.1-R2V erstellt eine neue Videoszene aus Referenzbildern und einer Textvorgabe. Alibaba richtet das Modell darauf aus, erkennbare Figuren, Objekte und den visuellen Stil bei der Erzeugung von Bewegung zu erhalten. Die Referenzen bestimmen Inhalt und Erscheinungsbild der Szene; der Text beschreibt, wie diese Elemente miteinander interagieren sollen.
Es können ein bis neun Bilder verwendet werden. Sie können eine Figur, einen Gegenstand, die Umgebung oder die gestalterische Darstellung vorgeben. In der Beschreibung lassen sich die Nummer einer Referenz und ein konkretes Objekt darin nennen, um das Bildmaterial mit dem entsprechenden Teil der Handlung zu verbinden. Das ist besonders nützlich, wenn Elemente mehrerer Bilder zu einer Komposition zusammengeführt werden sollen.
Anders als im Modus mit Anfangsframe dienen die Referenzen hier als Grundlage für den Inhalt einer neuen Szene. Die Textvorgabe ist erforderlich: Sie verbindet das Erscheinungsbild der Objekte mit der Handlung, der Kamerabewegung und der gesamten Inszenierung. Der Hersteller hebt visuelle Konsistenz und filmische Bewegung hervor; das Ergebnis bleibt eine Generierung und ist kein Zusammenschnitt der Ausgangsbilder.
Akzeptiert werden JPEG, JPG, PNG und WEBP mit höchstens 20 MB pro Datei. Die kürzere Bildseite muss mindestens 400 Pixel lang sein; empfohlen wird Material auf dem Niveau von 720P oder höher. Die Eingabe dieses Modus besteht ausschliesslich aus Bildern und Text.
Das Ergebnis wird als MP4 mit 24 Bildern pro Sekunde gespeichert. Die Dauer wird als ganze Zahl zwischen 3 und 15 Sekunden festgelegt. Bei der Auflösung stehen 480P, 720P und 1080P zur Auswahl; die Erzeugung einer Tonbegleitung wird unterstützt.
Verfügbar sind horizontale, vertikale und quadratische Bildformate: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 und 21:9. Mit dem Format lässt sich der Kompositionsraum der neuen Szene im Voraus bestimmen.
Der Text kann in jeder Sprache verfasst werden. Die Grenze beträgt 5000 nichtchinesische oder 2500 chinesische Zeichen; der überzählige Teil wird abgeschnitten. Die wichtigsten Rollen der Referenzen, die Handlung und die Bewegung müssen in diesem Umfang Platz finden. Der anfängliche Zufallswert kann die Ähnlichkeit von Varianten beeinflussen, garantiert aber keine exakte Wiederholung eines Clips.
POST /v1/videos/generationstext, imagevideo| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits happyhorse-1.1-r2v | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits Minimum: 3 Maximum: 15 Einheit: Sekunden | Standard5 |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480P, 720P, 1080P | Standard720P |
Feldratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Feldimage_urls | Typhttps_url|data_image_url[] | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 9 Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Erforderlich: prompt, image_urls
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, image_urls |
Parametermaterial_types | Vertragtext, image |
Parameteroptional | Vertragduration, resolution, ratio |
Parameterduration_integer_range | Vertrag3, 15 |
Parameterdefault_duration | Vertrag5 |
Parameterresolution | Vertrag480P, 720P, 1080P |
Parameterdefault_resolution | Vertrag720P |
Parameterratio | Vertrag16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Vertragfalse |
Parameterimage_urls | Vertrag{"min_count":1,"max_count":9,"schemes":["https","Rasterdaten als base64"],"max_data_image_bytes":20971520} |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/videos/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSpeichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jedes zurückgegebene Datenelement und jeden Ausgabeindex auf. content_url bezeichnet nur die erste Ausgabe; rufen Sie jeden tatsächlichen Inhaltspfad und jedes Asset ab. GET des Inhalts ohne index liefert nicht alle Ausgaben.
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldobject | Typstring |
Feldmodel | Typstring |
Feldstatus | Typstring |
Feldcontent_url | Typsigned URL |
Felddata[] | Typsigned URL |
Feldusage | Typobject |
Feldresult_pending_check | Typboolean |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwort409 · video_not_ready | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID ab und beachten Sie Retry-After. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Verwenden Sie die oben angezeigten Methodenpfade.
happyhorse-r2vModell zur Videoerzeugung aus Referenzbildern und einem Textszenario. Hilft, das Erscheinungsbild von Figuren, Gegenstände und den visuellen Stil in einer neuen Szene beizubehalten.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
HappyHorse-1.1-R2V erstellt eine neue Videoszene aus Referenzbildern und einer Textvorgabe. Alibaba richtet das Modell darauf aus, erkennbare Figuren, Objekte und den visuellen Stil bei der Erzeugung von Bewegung zu erhalten. Die Referenzen bestimmen Inhalt und Erscheinungsbild der Szene; der Text beschreibt, wie diese Elemente miteinander interagieren sollen.
Es können ein bis neun Bilder verwendet werden. Sie können eine Figur, einen Gegenstand, die Umgebung oder die gestalterische Darstellung vorgeben. In der Beschreibung lassen sich die Nummer einer Referenz und ein konkretes Objekt darin nennen, um das Bildmaterial mit dem entsprechenden Teil der Handlung zu verbinden. Das ist besonders nützlich, wenn Elemente mehrerer Bilder zu einer Komposition zusammengeführt werden sollen.
Anders als im Modus mit Anfangsframe dienen die Referenzen hier als Grundlage für den Inhalt einer neuen Szene. Die Textvorgabe ist erforderlich: Sie verbindet das Erscheinungsbild der Objekte mit der Handlung, der Kamerabewegung und der gesamten Inszenierung. Der Hersteller hebt visuelle Konsistenz und filmische Bewegung hervor; das Ergebnis bleibt eine Generierung und ist kein Zusammenschnitt der Ausgangsbilder.
Akzeptiert werden JPEG, JPG, PNG und WEBP mit höchstens 20 MB pro Datei. Die kürzere Bildseite muss mindestens 400 Pixel lang sein; empfohlen wird Material auf dem Niveau von 720P oder höher. Die Eingabe dieses Modus besteht ausschliesslich aus Bildern und Text.
Das Ergebnis wird als MP4 mit 24 Bildern pro Sekunde gespeichert. Die Dauer wird als ganze Zahl zwischen 3 und 15 Sekunden festgelegt. Bei der Auflösung stehen 480P, 720P und 1080P zur Auswahl; die Erzeugung einer Tonbegleitung wird unterstützt.
Verfügbar sind horizontale, vertikale und quadratische Bildformate: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 und 21:9. Mit dem Format lässt sich der Kompositionsraum der neuen Szene im Voraus bestimmen.
Der Text kann in jeder Sprache verfasst werden. Die Grenze beträgt 5000 nichtchinesische oder 2500 chinesische Zeichen; der überzählige Teil wird abgeschnitten. Die wichtigsten Rollen der Referenzen, die Handlung und die Bewegung müssen in diesem Umfang Platz finden. Der anfängliche Zufallswert kann die Ähnlichkeit von Varianten beeinflussen, garantiert aber keine exakte Wiederholung eines Clips.
POST /v1/videos/generationstext, imagevideo| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits happyhorse-r2v | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits Minimum: 3 Maximum: 15 Einheit: Sekunden | Standard5 |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480P, 720P, 1080P | Standard720P |
Feldratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Feldimage_urls | Typhttps_url|data_image_url[] | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 9 Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Erforderlich: prompt, image_urls
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext, image |
Parameterrequired | Vertragnull |
Parameteroptional_controls | Vertragnull |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/videos/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSpeichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jedes zurückgegebene Datenelement und jeden Ausgabeindex auf. content_url bezeichnet nur die erste Ausgabe; rufen Sie jeden tatsächlichen Inhaltspfad und jedes Asset ab. GET des Inhalts ohne index liefert nicht alle Ausgaben.
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldobject | Typstring |
Feldmodel | Typstring |
Feldstatus | Typstring |
Feldcontent_url | Typsigned URL |
Felddata[] | Typsigned URL |
Feldusage | Typobject |
Feldresult_pending_check | Typboolean |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwort409 · video_not_ready | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID ab und beachten Sie Retry-After. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Verwenden Sie die oben angezeigten Methodenpfade.
happyhorse-r2v-latestModell zur Videoerzeugung aus Referenzbildern und einem Textszenario. Hilft, das Erscheinungsbild von Figuren, Gegenstände und den visuellen Stil in einer neuen Szene beizubehalten.
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
HappyHorse-1.1-R2V erstellt eine neue Videoszene aus Referenzbildern und einer Textvorgabe. Alibaba richtet das Modell darauf aus, erkennbare Figuren, Objekte und den visuellen Stil bei der Erzeugung von Bewegung zu erhalten. Die Referenzen bestimmen Inhalt und Erscheinungsbild der Szene; der Text beschreibt, wie diese Elemente miteinander interagieren sollen.
Es können ein bis neun Bilder verwendet werden. Sie können eine Figur, einen Gegenstand, die Umgebung oder die gestalterische Darstellung vorgeben. In der Beschreibung lassen sich die Nummer einer Referenz und ein konkretes Objekt darin nennen, um das Bildmaterial mit dem entsprechenden Teil der Handlung zu verbinden. Das ist besonders nützlich, wenn Elemente mehrerer Bilder zu einer Komposition zusammengeführt werden sollen.
Anders als im Modus mit Anfangsframe dienen die Referenzen hier als Grundlage für den Inhalt einer neuen Szene. Die Textvorgabe ist erforderlich: Sie verbindet das Erscheinungsbild der Objekte mit der Handlung, der Kamerabewegung und der gesamten Inszenierung. Der Hersteller hebt visuelle Konsistenz und filmische Bewegung hervor; das Ergebnis bleibt eine Generierung und ist kein Zusammenschnitt der Ausgangsbilder.
Akzeptiert werden JPEG, JPG, PNG und WEBP mit höchstens 20 MB pro Datei. Die kürzere Bildseite muss mindestens 400 Pixel lang sein; empfohlen wird Material auf dem Niveau von 720P oder höher. Die Eingabe dieses Modus besteht ausschliesslich aus Bildern und Text.
Das Ergebnis wird als MP4 mit 24 Bildern pro Sekunde gespeichert. Die Dauer wird als ganze Zahl zwischen 3 und 15 Sekunden festgelegt. Bei der Auflösung stehen 480P, 720P und 1080P zur Auswahl; die Erzeugung einer Tonbegleitung wird unterstützt.
Verfügbar sind horizontale, vertikale und quadratische Bildformate: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 und 21:9. Mit dem Format lässt sich der Kompositionsraum der neuen Szene im Voraus bestimmen.
Der Text kann in jeder Sprache verfasst werden. Die Grenze beträgt 5000 nichtchinesische oder 2500 chinesische Zeichen; der überzählige Teil wird abgeschnitten. Die wichtigsten Rollen der Referenzen, die Handlung und die Bewegung müssen in diesem Umfang Platz finden. Der anfängliche Zufallswert kann die Ähnlichkeit von Varianten beeinflussen, garantiert aber keine exakte Wiederholung eines Clips.
POST /v1/videos/generationstext, imagevideo| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits happyhorse-r2v-latest | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldduration | Typinteger | AnforderungOptional | Werte und Limits Minimum: 3 Maximum: 15 Einheit: Sekunden | Standard5 |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480P, 720P, 1080P | Standard720P |
Feldratio | Typstring | AnforderungOptional | Werte und Limits 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Feldimage_urls | Typhttps_url|data_image_url[] | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 9 Maximale Anzahl dekodierter Bytes: 20'971'520 MIME-Typen: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Erforderlich: prompt, image_urls
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext, image |
Parameterrequired | Vertragnull |
Parameteroptional_controls | Vertragnull |
Lebenszyklus: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
POST /v1/videos/generationsAiloot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"\nexport AILOOT_IMAGE_URLS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-r2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nf=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")\nurls=json.loads(f.read_text())\nif not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")\nfor u in urls:\n z=urlsplit(u) if isinstance(u,str) else None\n if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")\np["image_urls"]=urls\np["ratio"]="16:9"\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\nSpeichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Bewahren Sie jedes zurückgegebene Datenelement und jeden Ausgabeindex auf. content_url bezeichnet nur die erste Ausgabe; rufen Sie jeden tatsächlichen Inhaltspfad und jedes Asset ab. GET des Inhalts ohne index liefert nicht alle Ausgaben.
Lesen Sie den bestehenden ursprünglichen Auftrag; reichen Sie einen Sendevorgang mit unbekanntem Ausgang niemals erneut ein.
| Feld | Typ |
|---|---|
Feldid | Typstring |
Feldobject | Typstring |
Feldmodel | Typstring |
Feldstatus | Typstring |
Feldcontent_url | Typsigned URL |
Felddata[] | Typsigned URL |
Feldusage | Typobject |
Feldresult_pending_check | Typboolean |
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwort409 · video_not_ready | BedingungDer ursprüngliche Ergebnisinhalt ist noch nicht verfügbar | Nächster SchrittFragen Sie die ursprünglich zurückgegebene ID ab und beachten Sie Retry-After. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Verwenden Sie die oben angezeigten Methodenpfade.