HappyHorse-1.1-R2V tworzy nową scenę filmową na podstawie obrazów referencyjnych i polecenia tekstowego. Alibaba ukierunkowuje model na zachowanie rozpoznawalnych postaci, obiektów i stylu wizualnego podczas generowania ruchu. Obrazy referencyjne określają treść i wygląd sceny, a tekst opisuje, jak jej elementy mają ze sobą współdziałać.
Można użyć od jednego do dziewięciu obrazów. Mogą one określać postać, przedmiot, otoczenie lub sposób artystycznego przedstawienia. W opisie można wskazać numer obrazu referencyjnego i konkretny obiekt na nim, aby powiązać materiał wizualny z odpowiednią częścią akcji. Jest to szczególnie przydatne, gdy elementy kilku obrazów trzeba połączyć w jednej kompozycji.
W odróżnieniu od trybu z klatką początkową obrazy referencyjne stanowią tutaj podstawę treści nowej sceny. Polecenie tekstowe jest obowiązkowe: łączy wygląd obiektów z akcją, ruchem kamery i ogólną inscenizacją. Producent podkreśla spójność wizualną i filmowy charakter ruchu; wynik pozostaje generacją, a nie montażem obrazów źródłowych.
Obsługiwane są JPEG, JPG, PNG i WEBP o rozmiarze do 20 MB każdy. Krótszy bok obrazu musi mieć co najmniej 400 pikseli; zalecane są materiały w rozdzielczości 720P lub wyższej. W tym trybie danymi wejściowymi są właśnie obrazy i tekst.
Wynik jest zapisywany w MP4 z częstotliwością 24 klatek na sekundę. Czas trwania określa się jako liczbę całkowitą od 3 do 15 sekund. Można wybrać rozdzielczość 480P, 720P lub 1080P; obsługiwane jest generowanie towarzyszącego dźwięku.
Dostępne są kadry poziome, pionowe i kwadratowe: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 i 21:9. Wybór proporcji pomaga z góry określić przestrzeń kompozycyjną nowej sceny.
Tekst może być w dowolnym języku. Limit wynosi 5000 znaków innych niż chińskie albo 2500 znaków chińskich, a nadmiarowa część jest odrzucana. Najważniejsze role obrazów referencyjnych, akcja i ruch muszą zmieścić się w tym limicie. Początkowa wartość ziarna losowości może wpływać na podobieństwo wariantów, ale nie gwarantuje dokładnego odtworzenia tego samego filmu.
", "aboutText": "HappyHorse-1.1-R2V tworzy nową scenę filmową na podstawie obrazów referencyjnych i polecenia tekstowego. Alibaba ukierunkowuje model na zachowanie rozpoznawalnych postaci, obiektów i stylu wizualnego podczas generowania ruchu. Obrazy referencyjne określają treść i wygląd sceny, a tekst opisuje, jak jej elementy mają ze sobą współdziałać.\n\n### Role wzorców wizualnych\n\nMożna użyć od jednego do dziewięciu obrazów. Mogą one określać postać, przedmiot, otoczenie lub sposób artystycznego przedstawienia. W opisie można wskazać numer obrazu referencyjnego i konkretny obiekt na nim, aby powiązać materiał wizualny z odpowiednią częścią akcji. Jest to szczególnie przydatne, gdy elementy kilku obrazów trzeba połączyć w jednej kompozycji.\n\nW odróżnieniu od trybu z klatką początkową obrazy referencyjne stanowią tutaj podstawę treści nowej sceny. Polecenie tekstowe jest obowiązkowe: łączy wygląd obiektów z akcją, ruchem kamery i ogólną inscenizacją. Producent podkreśla spójność wizualną i filmowy charakter ruchu; wynik pozostaje generacją, a nie montażem obrazów źródłowych.\n\nObsługiwane są JPEG, JPG, PNG i WEBP o rozmiarze do 20 MB każdy. Krótszy bok obrazu musi mieć co najmniej 400 pikseli; zalecane są materiały w rozdzielczości 720P lub wyższej. W tym trybie danymi wejściowymi są właśnie obrazy i tekst.\n\n### Czas trwania, kadr i dźwięk\n\nWynik jest zapisywany w MP4 z częstotliwością 24 klatek na sekundę. Czas trwania określa się jako liczbę całkowitą od 3 do 15 sekund. Można wybrać rozdzielczość 480P, 720P lub 1080P; obsługiwane jest generowanie towarzyszącego dźwięku.\n\nDostępne są kadry poziome, pionowe i kwadratowe: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 i 21:9. Wybór proporcji pomaga z góry określić przestrzeń kompozycyjną nowej sceny.\n\nTekst może być w dowolnym języku. Limit wynosi 5000 znaków innych niż chińskie albo 2500 znaków chińskich, a nadmiarowa część jest odrzucana. Najważniejsze role obrazów referencyjnych, akcja i ruch muszą zmieścić się w tym limicie. Początkowa wartość ziarna losowości może wpływać na podobieństwo wariantów, ale nie gwarantuje dokładnego odtworzenia tego samego filmu.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "063ed705ef12f9509af886f24fc352f2762b9ab57a7148b4d4ee2100fe1fb5cd", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "happyhorse-1.1-r2vModel do generowania wideo na podstawie obrazów referencyjnych i scenariusza tekstowego. Pomaga zachować wygląd postaci i przedmiotów oraz styl wizualny w nowej scenie.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
HappyHorse-1.1-R2V tworzy nową scenę filmową na podstawie obrazów referencyjnych i polecenia tekstowego. Alibaba ukierunkowuje model na zachowanie rozpoznawalnych postaci, obiektów i stylu wizualnego podczas generowania ruchu. Obrazy referencyjne określają treść i wygląd sceny, a tekst opisuje, jak jej elementy mają ze sobą współdziałać.
Można użyć od jednego do dziewięciu obrazów. Mogą one określać postać, przedmiot, otoczenie lub sposób artystycznego przedstawienia. W opisie można wskazać numer obrazu referencyjnego i konkretny obiekt na nim, aby powiązać materiał wizualny z odpowiednią częścią akcji. Jest to szczególnie przydatne, gdy elementy kilku obrazów trzeba połączyć w jednej kompozycji.
W odróżnieniu od trybu z klatką początkową obrazy referencyjne stanowią tutaj podstawę treści nowej sceny. Polecenie tekstowe jest obowiązkowe: łączy wygląd obiektów z akcją, ruchem kamery i ogólną inscenizacją. Producent podkreśla spójność wizualną i filmowy charakter ruchu; wynik pozostaje generacją, a nie montażem obrazów źródłowych.
Obsługiwane są JPEG, JPG, PNG i WEBP o rozmiarze do 20 MB każdy. Krótszy bok obrazu musi mieć co najmniej 400 pikseli; zalecane są materiały w rozdzielczości 720P lub wyższej. W tym trybie danymi wejściowymi są właśnie obrazy i tekst.
Wynik jest zapisywany w MP4 z częstotliwością 24 klatek na sekundę. Czas trwania określa się jako liczbę całkowitą od 3 do 15 sekund. Można wybrać rozdzielczość 480P, 720P lub 1080P; obsługiwane jest generowanie towarzyszącego dźwięku.
Dostępne są kadry poziome, pionowe i kwadratowe: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 i 21:9. Wybór proporcji pomaga z góry określić przestrzeń kompozycyjną nowej sceny.
Tekst może być w dowolnym języku. Limit wynosi 5000 znaków innych niż chińskie albo 2500 znaków chińskich, a nadmiarowa część jest odrzucana. Najważniejsze role obrazów referencyjnych, akcja i ruch muszą zmieścić się w tym limicie. Początkowa wartość ziarna losowości może wpływać na podobieństwo wariantów, ale nie gwarantuje dokładnego odtworzenia tego samego filmu.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity happyhorse-1.1-r2v | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Poleduration | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 3 Maksimum: 15 Jednostka: sekundy | Domyślnie5 |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 480P, 720P, 1080P | Domyślnie720P |
Poleratio | Typstring | WymaganieOpcjonalne | Wartości i limity 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Domyślnie16:9 |
Poleimage_urls | Typhttps_url|data_image_url[] | WymaganieWymagane | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 9 Maksymalna liczba zdekodowanych bajtów: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Domyślnie— |
reference_images_to_video · Wymagane: prompt, image_urls
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, image_urls |
Parametrmaterial_types | Kontrakttext, image |
Parametroptional | Kontraktduration, resolution, ratio |
Parametrduration_integer_range | Kontrakt3, 15 |
Parametrdefault_duration | Kontrakt5 |
Parametrresolution | Kontrakt480P, 720P, 1080P |
Parametrdefault_resolution | Kontrakt720P |
Parametrratio | Kontrakt16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parametrratio_must_omit | Kontraktfalse |
Parametrimage_urls | Kontrakt{"min_count":1,"max_count":9,"schemes":["https","dane rastrowe w base64"],"max_data_image_bytes":20971520} |
Cykl życia: 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
Struktury metod i ID są dokładne; możliwości dostawcy są odrębne od dopuszczenia żądania.
POST /v1/videos/generationsAiloot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
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\nZapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Zachowaj każdy zwrócony element data i indeks wyniku. content_url wskazuje tylko pierwszy; pobierz każdą rzeczywistą ścieżkę treści i zasób. GET treści bez index nie obejmuje wszystkich wyników.
Odczytuj istniejące pierwotne zadanie; nigdy nie ponawiaj wysłania o nieznanym wyniku.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pola, sposób reprezentacji materiału lub wartość parametru | Następny krokPopraw wskazane pola przed nowym żądaniem utworzenia. |
Odpowiedź409 · video_not_ready | WarunekTreść pierwotnego wyniku nie jest jeszcze dostępna | Następny krokOdpytuj pierwotny zwrócony identyfikator i przestrzegaj Retry-After. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Użyj ścieżek metod podanych powyżej.
happyhorse-r2vModel do generowania wideo na podstawie obrazów referencyjnych i scenariusza tekstowego. Pomaga zachować wygląd postaci i przedmiotów oraz styl wizualny w nowej scenie.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
HappyHorse-1.1-R2V tworzy nową scenę filmową na podstawie obrazów referencyjnych i polecenia tekstowego. Alibaba ukierunkowuje model na zachowanie rozpoznawalnych postaci, obiektów i stylu wizualnego podczas generowania ruchu. Obrazy referencyjne określają treść i wygląd sceny, a tekst opisuje, jak jej elementy mają ze sobą współdziałać.
Można użyć od jednego do dziewięciu obrazów. Mogą one określać postać, przedmiot, otoczenie lub sposób artystycznego przedstawienia. W opisie można wskazać numer obrazu referencyjnego i konkretny obiekt na nim, aby powiązać materiał wizualny z odpowiednią częścią akcji. Jest to szczególnie przydatne, gdy elementy kilku obrazów trzeba połączyć w jednej kompozycji.
W odróżnieniu od trybu z klatką początkową obrazy referencyjne stanowią tutaj podstawę treści nowej sceny. Polecenie tekstowe jest obowiązkowe: łączy wygląd obiektów z akcją, ruchem kamery i ogólną inscenizacją. Producent podkreśla spójność wizualną i filmowy charakter ruchu; wynik pozostaje generacją, a nie montażem obrazów źródłowych.
Obsługiwane są JPEG, JPG, PNG i WEBP o rozmiarze do 20 MB każdy. Krótszy bok obrazu musi mieć co najmniej 400 pikseli; zalecane są materiały w rozdzielczości 720P lub wyższej. W tym trybie danymi wejściowymi są właśnie obrazy i tekst.
Wynik jest zapisywany w MP4 z częstotliwością 24 klatek na sekundę. Czas trwania określa się jako liczbę całkowitą od 3 do 15 sekund. Można wybrać rozdzielczość 480P, 720P lub 1080P; obsługiwane jest generowanie towarzyszącego dźwięku.
Dostępne są kadry poziome, pionowe i kwadratowe: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 i 21:9. Wybór proporcji pomaga z góry określić przestrzeń kompozycyjną nowej sceny.
Tekst może być w dowolnym języku. Limit wynosi 5000 znaków innych niż chińskie albo 2500 znaków chińskich, a nadmiarowa część jest odrzucana. Najważniejsze role obrazów referencyjnych, akcja i ruch muszą zmieścić się w tym limicie. Początkowa wartość ziarna losowości może wpływać na podobieństwo wariantów, ale nie gwarantuje dokładnego odtworzenia tego samego filmu.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity happyhorse-r2v | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Poleduration | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 3 Maksimum: 15 Jednostka: sekundy | Domyślnie5 |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 480P, 720P, 1080P | Domyślnie720P |
Poleratio | Typstring | WymaganieOpcjonalne | Wartości i limity 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Domyślnie16:9 |
Poleimage_urls | Typhttps_url|data_image_url[] | WymaganieWymagane | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 9 Maksymalna liczba zdekodowanych bajtów: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Domyślnie— |
reference_images_to_video · Wymagane: prompt, image_urls
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext, image |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Cykl życia: 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
Struktury metod i ID są dokładne; możliwości dostawcy są odrębne od dopuszczenia żądania.
POST /v1/videos/generationsAiloot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
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\nZapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Zachowaj każdy zwrócony element data i indeks wyniku. content_url wskazuje tylko pierwszy; pobierz każdą rzeczywistą ścieżkę treści i zasób. GET treści bez index nie obejmuje wszystkich wyników.
Odczytuj istniejące pierwotne zadanie; nigdy nie ponawiaj wysłania o nieznanym wyniku.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pola, sposób reprezentacji materiału lub wartość parametru | Następny krokPopraw wskazane pola przed nowym żądaniem utworzenia. |
Odpowiedź409 · video_not_ready | WarunekTreść pierwotnego wyniku nie jest jeszcze dostępna | Następny krokOdpytuj pierwotny zwrócony identyfikator i przestrzegaj Retry-After. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Użyj ścieżek metod podanych powyżej.
happyhorse-r2v-latestModel do generowania wideo na podstawie obrazów referencyjnych i scenariusza tekstowego. Pomaga zachować wygląd postaci i przedmiotów oraz styl wizualny w nowej scenie.
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
HappyHorse-1.1-R2V tworzy nową scenę filmową na podstawie obrazów referencyjnych i polecenia tekstowego. Alibaba ukierunkowuje model na zachowanie rozpoznawalnych postaci, obiektów i stylu wizualnego podczas generowania ruchu. Obrazy referencyjne określają treść i wygląd sceny, a tekst opisuje, jak jej elementy mają ze sobą współdziałać.
Można użyć od jednego do dziewięciu obrazów. Mogą one określać postać, przedmiot, otoczenie lub sposób artystycznego przedstawienia. W opisie można wskazać numer obrazu referencyjnego i konkretny obiekt na nim, aby powiązać materiał wizualny z odpowiednią częścią akcji. Jest to szczególnie przydatne, gdy elementy kilku obrazów trzeba połączyć w jednej kompozycji.
W odróżnieniu od trybu z klatką początkową obrazy referencyjne stanowią tutaj podstawę treści nowej sceny. Polecenie tekstowe jest obowiązkowe: łączy wygląd obiektów z akcją, ruchem kamery i ogólną inscenizacją. Producent podkreśla spójność wizualną i filmowy charakter ruchu; wynik pozostaje generacją, a nie montażem obrazów źródłowych.
Obsługiwane są JPEG, JPG, PNG i WEBP o rozmiarze do 20 MB każdy. Krótszy bok obrazu musi mieć co najmniej 400 pikseli; zalecane są materiały w rozdzielczości 720P lub wyższej. W tym trybie danymi wejściowymi są właśnie obrazy i tekst.
Wynik jest zapisywany w MP4 z częstotliwością 24 klatek na sekundę. Czas trwania określa się jako liczbę całkowitą od 3 do 15 sekund. Można wybrać rozdzielczość 480P, 720P lub 1080P; obsługiwane jest generowanie towarzyszącego dźwięku.
Dostępne są kadry poziome, pionowe i kwadratowe: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 i 21:9. Wybór proporcji pomaga z góry określić przestrzeń kompozycyjną nowej sceny.
Tekst może być w dowolnym języku. Limit wynosi 5000 znaków innych niż chińskie albo 2500 znaków chińskich, a nadmiarowa część jest odrzucana. Najważniejsze role obrazów referencyjnych, akcja i ruch muszą zmieścić się w tym limicie. Początkowa wartość ziarna losowości może wpływać na podobieństwo wariantów, ale nie gwarantuje dokładnego odtworzenia tego samego filmu.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity happyhorse-r2v-latest | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity Minimalna długość: 1 | Domyślnie— |
Poleduration | Typinteger | WymaganieOpcjonalne | Wartości i limity Minimum: 3 Maksimum: 15 Jednostka: sekundy | Domyślnie5 |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 480P, 720P, 1080P | Domyślnie720P |
Poleratio | Typstring | WymaganieOpcjonalne | Wartości i limity 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Domyślnie16:9 |
Poleimage_urls | Typhttps_url|data_image_url[] | WymaganieWymagane | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 9 Maksymalna liczba zdekodowanych bajtów: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Domyślnie— |
reference_images_to_video · Wymagane: prompt, image_urls
| Parametr | Kontrakt |
|---|---|
Parametrmaterial_types | Kontrakttext, image |
Parametrrequired | Kontraktnull |
Parametroptional_controls | Kontraktnull |
Cykl życia: 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
Struktury metod i ID są dokładne; możliwości dostawcy są odrębne od dopuszczenia żądania.
POST /v1/videos/generationsAiloot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
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\nZapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Zachowaj każdy zwrócony element data i indeks wyniku. content_url wskazuje tylko pierwszy; pobierz każdą rzeczywistą ścieżkę treści i zasób. GET treści bez index nie obejmuje wszystkich wyników.
Odczytuj istniejące pierwotne zadanie; nigdy nie ponawiaj wysłania o nieznanym wyniku.
| Pole | Typ |
|---|---|
Poleid | Typstring |
Poleobject | Typstring |
Polemodel | Typstring |
Polestatus | Typstring |
Polecontent_url | Typsigned URL |
Poledata[] | Typsigned URL |
Poleusage | Typobject |
Poleresult_pending_check | Typboolean |
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź400 · invalid_request_error | WarunekNieprawidłowe wymagane pola, sposób reprezentacji materiału lub wartość parametru | Następny krokPopraw wskazane pola przed nowym żądaniem utworzenia. |
Odpowiedź409 · video_not_ready | WarunekTreść pierwotnego wyniku nie jest jeszcze dostępna | Następny krokOdpytuj pierwotny zwrócony identyfikator i przestrzegaj Retry-After. |
Odpowiedźserver_error | WarunekZwrócona odpowiedź wskazuje, że operacja lub wynik wymaga sprawdzenia | Następny krokZachowaj pierwotnie zwrócony identyfikator operacji lub zadania, nagłówki żądania i odpowiedź; kontynuuj obsługiwane odczyty tej pierwotnej operacji. Nie wysyłaj ponownie żądania utworzenia. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Użyj ścieżek metod podanych powyżej.