HappyHorse-1.1-I2V to model Alibaba, który rozpoczyna scenę filmową od gotowego obrazu. Obraz staje się pierwszą klatką, a tekst może określić dalszy przebieg akcji: ruch postaci, zmiany w scenie i kierunek ruchu kamery. Takie rozwiązanie nadaje się do ożywiania ilustracji, fotografii produktowej lub wcześniej przygotowanej koncepcji wizualnej.
Opis tekstowy jest opcjonalny. Bez niego model sam wywnioskuje możliwy ruch z treści obrazu początkowego. Gdy opis zostanie podany, obraz wejściowy określa kompozycję i wygląd obiektów, a słowa ukierunkowują rozwój sceny w czasie.
Alibaba podkreśla zachowanie wyglądu postaci, spójność wizualną, płynność ruchu i połączenie obrazu z dźwiękiem. Do deklarowanych cech należą również stabilność napisów i faktur. Są to założenia modelu i nie oznaczają dosłownego zachowania każdego piksela we wszystkich wygenerowanych klatkach.
W tym trybie używa się jednego obrazu początkowego. Wyznacza on scenę wyjściową, zamiast stanowić zestaw niezależnych wzorców do nowej kompozycji. Dla tej konkretnej wersji nie zadeklarowano możliwości wskazania osobnej klatki końcowej.
Obsługiwane są JPEG, JPG, PNG i WEBP. Każdy bok obrazu wejściowego musi mieć co najmniej 300 pikseli; dopuszczalne proporcje wynoszą od 1:2,5 do 2,5:1, a rozmiar pliku może sięgać 20 MB. Proporcje gotowego filmu odpowiadają pierwszej klatce.
Czas trwania wybiera się jako liczbę całkowitą od 3 do 15 sekund. Dostępne są rozdzielczości 480P, 720P i 1080P; format wyjściowy to MP4, a liczba klatek na sekundę wynosi 24. Model obsługuje tworzenie dźwięku wraz z obrazem filmowym.
Opis może być w dowolnym języku i zawierać do 5000 znaków innych niż chińskie albo 2500 znaków chińskich. Po przekroczeniu limitu nadmiarowa część jest odrzucana, dlatego istotne działania i cechy ruchu warto opisać w jego granicach. Ta sama początkowa wartość ziarna losowości może dać podobne filmy, ale nie gwarantuje ich zgodności klatka po klatce.
", "aboutText": "HappyHorse-1.1-I2V to model Alibaba, który rozpoczyna scenę filmową od gotowego obrazu. Obraz staje się pierwszą klatką, a tekst może określić dalszy przebieg akcji: ruch postaci, zmiany w scenie i kierunek ruchu kamery. Takie rozwiązanie nadaje się do ożywiania ilustracji, fotografii produktowej lub wcześniej przygotowanej koncepcji wizualnej.\n\nOpis tekstowy jest opcjonalny. Bez niego model sam wywnioskuje możliwy ruch z treści obrazu początkowego. Gdy opis zostanie podany, obraz wejściowy określa kompozycję i wygląd obiektów, a słowa ukierunkowują rozwój sceny w czasie.\n\n### Od pierwszej klatki do ruchu\n\nAlibaba podkreśla zachowanie wyglądu postaci, spójność wizualną, płynność ruchu i połączenie obrazu z dźwiękiem. Do deklarowanych cech należą również stabilność napisów i faktur. Są to założenia modelu i nie oznaczają dosłownego zachowania każdego piksela we wszystkich wygenerowanych klatkach.\n\nW tym trybie używa się jednego obrazu początkowego. Wyznacza on scenę wyjściową, zamiast stanowić zestaw niezależnych wzorców do nowej kompozycji. Dla tej konkretnej wersji nie zadeklarowano możliwości wskazania osobnej klatki końcowej.\n\nObsługiwane są JPEG, JPG, PNG i WEBP. Każdy bok obrazu wejściowego musi mieć co najmniej 300 pikseli; dopuszczalne proporcje wynoszą od 1:2,5 do 2,5:1, a rozmiar pliku może sięgać 20 MB. Proporcje gotowego filmu odpowiadają pierwszej klatce.\n\n### Parametry filmu\n\nCzas trwania wybiera się jako liczbę całkowitą od 3 do 15 sekund. Dostępne są rozdzielczości 480P, 720P i 1080P; format wyjściowy to MP4, a liczba klatek na sekundę wynosi 24. Model obsługuje tworzenie dźwięku wraz z obrazem filmowym.\n\nOpis może być w dowolnym języku i zawierać do 5000 znaków innych niż chińskie albo 2500 znaków chińskich. Po przekroczeniu limitu nadmiarowa część jest odrzucana, dlatego istotne działania i cechy ruchu warto opisać w jego granicach. Ta sama początkowa wartość ziarna losowości może dać podobne filmy, ale nie gwarantuje ich zgodności klatka po klatce.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3714de4dbc3a33a0513ec0a00088bc5898bbf7dd57a062d69fdc8a225bb70b77", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "happyhorse-1.1-i2vModel do ożywiania obrazów: obraz wejściowy wyznacza pierwszą klatkę, a opis ukierunkowuje dalszy ruch. Tworzy krótki film z możliwością wygenerowania towarzyszącego mu dźwięku.
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-I2V to model Alibaba, który rozpoczyna scenę filmową od gotowego obrazu. Obraz staje się pierwszą klatką, a tekst może określić dalszy przebieg akcji: ruch postaci, zmiany w scenie i kierunek ruchu kamery. Takie rozwiązanie nadaje się do ożywiania ilustracji, fotografii produktowej lub wcześniej przygotowanej koncepcji wizualnej.
Opis tekstowy jest opcjonalny. Bez niego model sam wywnioskuje możliwy ruch z treści obrazu początkowego. Gdy opis zostanie podany, obraz wejściowy określa kompozycję i wygląd obiektów, a słowa ukierunkowują rozwój sceny w czasie.
Alibaba podkreśla zachowanie wyglądu postaci, spójność wizualną, płynność ruchu i połączenie obrazu z dźwiękiem. Do deklarowanych cech należą również stabilność napisów i faktur. Są to założenia modelu i nie oznaczają dosłownego zachowania każdego piksela we wszystkich wygenerowanych klatkach.
W tym trybie używa się jednego obrazu początkowego. Wyznacza on scenę wyjściową, zamiast stanowić zestaw niezależnych wzorców do nowej kompozycji. Dla tej konkretnej wersji nie zadeklarowano możliwości wskazania osobnej klatki końcowej.
Obsługiwane są JPEG, JPG, PNG i WEBP. Każdy bok obrazu wejściowego musi mieć co najmniej 300 pikseli; dopuszczalne proporcje wynoszą od 1:2,5 do 2,5:1, a rozmiar pliku może sięgać 20 MB. Proporcje gotowego filmu odpowiadają pierwszej klatce.
Czas trwania wybiera się jako liczbę całkowitą od 3 do 15 sekund. Dostępne są rozdzielczości 480P, 720P i 1080P; format wyjściowy to MP4, a liczba klatek na sekundę wynosi 24. Model obsługuje tworzenie dźwięku wraz z obrazem filmowym.
Opis może być w dowolnym języku i zawierać do 5000 znaków innych niż chińskie albo 2500 znaków chińskich. Po przekroczeniu limitu nadmiarowa część jest odrzucana, dlatego istotne działania i cechy ruchu warto opisać w jego granicach. Ta sama początkowa wartość ziarna losowości może dać podobne filmy, ale nie gwarantuje ich zgodności klatka po klatce.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity happyhorse-1.1-i2v | Domyślnie— |
Poleprompt | Typstring | WymaganieOpcjonalne | 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 | WymaganieNieobsługiwane | Wartości i limity | Domyślnie— |
Poleimage_urls | Typhttps_url|data_image_url[] | WymaganieWymagane | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 1 Maksymalna liczba zdekodowanych bajtów: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Domyślnie— |
first_frame_to_video · Wymagane: image_urls
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, image_urls |
Parametrmaterial_types | Kontrakttext, image |
Parametroptional | Kontraktduration, resolution, ratio, prompt |
Parametrduration_integer_range | Kontrakt3, 15 |
Parametrdefault_duration | Kontrakt5 |
Parametrresolution | Kontrakt480P, 720P, 1080P |
Parametrdefault_resolution | Kontrakt720P |
Parametrratio | Kontrakt |
Parametrratio_must_omit | Kontrakttrue |
Parametrimage_urls | Kontrakt{"min_count":1,"max_count":1,"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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Użyj ścieżek metod podanych powyżej.
happyhorse-i2vModel do ożywiania obrazów: obraz wejściowy wyznacza pierwszą klatkę, a opis ukierunkowuje dalszy ruch. Tworzy krótki film z możliwością wygenerowania towarzyszącego mu dźwięku.
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-I2V to model Alibaba, który rozpoczyna scenę filmową od gotowego obrazu. Obraz staje się pierwszą klatką, a tekst może określić dalszy przebieg akcji: ruch postaci, zmiany w scenie i kierunek ruchu kamery. Takie rozwiązanie nadaje się do ożywiania ilustracji, fotografii produktowej lub wcześniej przygotowanej koncepcji wizualnej.
Opis tekstowy jest opcjonalny. Bez niego model sam wywnioskuje możliwy ruch z treści obrazu początkowego. Gdy opis zostanie podany, obraz wejściowy określa kompozycję i wygląd obiektów, a słowa ukierunkowują rozwój sceny w czasie.
Alibaba podkreśla zachowanie wyglądu postaci, spójność wizualną, płynność ruchu i połączenie obrazu z dźwiękiem. Do deklarowanych cech należą również stabilność napisów i faktur. Są to założenia modelu i nie oznaczają dosłownego zachowania każdego piksela we wszystkich wygenerowanych klatkach.
W tym trybie używa się jednego obrazu początkowego. Wyznacza on scenę wyjściową, zamiast stanowić zestaw niezależnych wzorców do nowej kompozycji. Dla tej konkretnej wersji nie zadeklarowano możliwości wskazania osobnej klatki końcowej.
Obsługiwane są JPEG, JPG, PNG i WEBP. Każdy bok obrazu wejściowego musi mieć co najmniej 300 pikseli; dopuszczalne proporcje wynoszą od 1:2,5 do 2,5:1, a rozmiar pliku może sięgać 20 MB. Proporcje gotowego filmu odpowiadają pierwszej klatce.
Czas trwania wybiera się jako liczbę całkowitą od 3 do 15 sekund. Dostępne są rozdzielczości 480P, 720P i 1080P; format wyjściowy to MP4, a liczba klatek na sekundę wynosi 24. Model obsługuje tworzenie dźwięku wraz z obrazem filmowym.
Opis może być w dowolnym języku i zawierać do 5000 znaków innych niż chińskie albo 2500 znaków chińskich. Po przekroczeniu limitu nadmiarowa część jest odrzucana, dlatego istotne działania i cechy ruchu warto opisać w jego granicach. Ta sama początkowa wartość ziarna losowości może dać podobne filmy, ale nie gwarantuje ich zgodności klatka po klatce.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity happyhorse-i2v | Domyślnie— |
Poleprompt | Typstring | WymaganieOpcjonalne | 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 | WymaganieNieobsługiwane | Wartości i limity | Domyślnie— |
Poleimage_urls | Typhttps_url|data_image_url[] | WymaganieWymagane | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 1 Maksymalna liczba zdekodowanych bajtów: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Domyślnie— |
first_frame_to_video · Wymagane: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Użyj ścieżek metod podanych powyżej.
happyhorse-i2v-latestModel do ożywiania obrazów: obraz wejściowy wyznacza pierwszą klatkę, a opis ukierunkowuje dalszy ruch. Tworzy krótki film z możliwością wygenerowania towarzyszącego mu dźwięku.
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-I2V to model Alibaba, który rozpoczyna scenę filmową od gotowego obrazu. Obraz staje się pierwszą klatką, a tekst może określić dalszy przebieg akcji: ruch postaci, zmiany w scenie i kierunek ruchu kamery. Takie rozwiązanie nadaje się do ożywiania ilustracji, fotografii produktowej lub wcześniej przygotowanej koncepcji wizualnej.
Opis tekstowy jest opcjonalny. Bez niego model sam wywnioskuje możliwy ruch z treści obrazu początkowego. Gdy opis zostanie podany, obraz wejściowy określa kompozycję i wygląd obiektów, a słowa ukierunkowują rozwój sceny w czasie.
Alibaba podkreśla zachowanie wyglądu postaci, spójność wizualną, płynność ruchu i połączenie obrazu z dźwiękiem. Do deklarowanych cech należą również stabilność napisów i faktur. Są to założenia modelu i nie oznaczają dosłownego zachowania każdego piksela we wszystkich wygenerowanych klatkach.
W tym trybie używa się jednego obrazu początkowego. Wyznacza on scenę wyjściową, zamiast stanowić zestaw niezależnych wzorców do nowej kompozycji. Dla tej konkretnej wersji nie zadeklarowano możliwości wskazania osobnej klatki końcowej.
Obsługiwane są JPEG, JPG, PNG i WEBP. Każdy bok obrazu wejściowego musi mieć co najmniej 300 pikseli; dopuszczalne proporcje wynoszą od 1:2,5 do 2,5:1, a rozmiar pliku może sięgać 20 MB. Proporcje gotowego filmu odpowiadają pierwszej klatce.
Czas trwania wybiera się jako liczbę całkowitą od 3 do 15 sekund. Dostępne są rozdzielczości 480P, 720P i 1080P; format wyjściowy to MP4, a liczba klatek na sekundę wynosi 24. Model obsługuje tworzenie dźwięku wraz z obrazem filmowym.
Opis może być w dowolnym języku i zawierać do 5000 znaków innych niż chińskie albo 2500 znaków chińskich. Po przekroczeniu limitu nadmiarowa część jest odrzucana, dlatego istotne działania i cechy ruchu warto opisać w jego granicach. Ta sama początkowa wartość ziarna losowości może dać podobne filmy, ale nie gwarantuje ich zgodności klatka po klatce.
POST /v1/videos/generationstext, imagevideo| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity happyhorse-i2v-latest | Domyślnie— |
Poleprompt | Typstring | WymaganieOpcjonalne | 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 | WymaganieNieobsługiwane | Wartości i limity | Domyślnie— |
Poleimage_urls | Typhttps_url|data_image_url[] | WymaganieWymagane | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 1 Maksymalna liczba zdekodowanych bajtów: 20 971 520 Typy MIME: image/jpeg, image/png, image/webp | Domyślnie— |
first_frame_to_video · Wymagane: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Użyj ścieżek metod podanych powyżej.