HappyHorse-1.1-I2V er en modell fra Alibaba som starter en videoscene med et ferdig bilde. Bildet blir det første videobildet, mens teksten kan bestemme hva som skjer videre: figurens bevegelser, endringer i scenen og kameraføringen. Dette egner seg til å animere en illustrasjon, et produktfoto eller et visuelt konsept som er laget på forhånd.
En tekstbeskrivelse er ikke påkrevd. Uten tekst utleder modellen selv en mulig bevegelse fra innholdet i startbildet. Når oppgaven er beskrevet eksplisitt, bestemmer kildebildet komposisjonen og objektenes utseende, mens ordene styrer hvordan scenen utvikler seg over tid.
Alibaba fremhever bevaring av figurens utseende, visuell sammenheng, jevne bevegelser og samspillet mellom bilde og lyd. Stabil gjengivelse av tekst og teksturer er også blant målene som oppgis. Dette beskriver hva modellen er utviklet for, og betyr ikke at hver piksel beholdes bokstavelig i alle genererte bilder.
Denne modusen bruker ett startbilde. Det bestemmer utgangsscenen og er ikke en samling uavhengige eksempler for en ny komposisjon. Muligheten til å angi et eget sluttbilde er ikke oppgitt for denne bestemte versjonen.
JPEG, JPG, PNG og WEBP godtas. Hver side av inndatabildet må være minst 300 piksler; tillatt sideforhold er fra 1:2,5 til 2,5:1, og filstørrelsen er opptil 20 MB. Sideforholdet i den ferdige videoen følger det første bildet.
Varigheten velges som et heltall fra 3 til 15 sekunder. Oppløsningene 480P, 720P og 1080P er tilgjengelige; utdataformatet er MP4 med 24 bilder per sekund. Det er støtte for å lage lyd sammen med videoen.
Beskrivelsen kan være på hvilket som helst språk og inneholde opptil 5000 ikke-kinesiske eller 2500 kinesiske tegn. Dersom grensen overskrides, fjernes den overskytende delen. Viktige handlinger og bevegelsesdetaljer bør derfor beskrives innenfor denne grensen. Samme tilfeldige startverdi kan gi lignende videoer, men garanterer ikke at de blir identiske bilde for bilde.
", "aboutText": "HappyHorse-1.1-I2V er en modell fra Alibaba som starter en videoscene med et ferdig bilde. Bildet blir det første videobildet, mens teksten kan bestemme hva som skjer videre: figurens bevegelser, endringer i scenen og kameraføringen. Dette egner seg til å animere en illustrasjon, et produktfoto eller et visuelt konsept som er laget på forhånd.\n\nEn tekstbeskrivelse er ikke påkrevd. Uten tekst utleder modellen selv en mulig bevegelse fra innholdet i startbildet. Når oppgaven er beskrevet eksplisitt, bestemmer kildebildet komposisjonen og objektenes utseende, mens ordene styrer hvordan scenen utvikler seg over tid.\n\n### Fra første bilde til bevegelse\n\nAlibaba fremhever bevaring av figurens utseende, visuell sammenheng, jevne bevegelser og samspillet mellom bilde og lyd. Stabil gjengivelse av tekst og teksturer er også blant målene som oppgis. Dette beskriver hva modellen er utviklet for, og betyr ikke at hver piksel beholdes bokstavelig i alle genererte bilder.\n\nDenne modusen bruker ett startbilde. Det bestemmer utgangsscenen og er ikke en samling uavhengige eksempler for en ny komposisjon. Muligheten til å angi et eget sluttbilde er ikke oppgitt for denne bestemte versjonen.\n\nJPEG, JPG, PNG og WEBP godtas. Hver side av inndatabildet må være minst 300 piksler; tillatt sideforhold er fra 1:2,5 til 2,5:1, og filstørrelsen er opptil 20 MB. Sideforholdet i den ferdige videoen følger det første bildet.\n\n### Videoparametere\n\nVarigheten velges som et heltall fra 3 til 15 sekunder. Oppløsningene 480P, 720P og 1080P er tilgjengelige; utdataformatet er MP4 med 24 bilder per sekund. Det er støtte for å lage lyd sammen med videoen.\n\nBeskrivelsen kan være på hvilket som helst språk og inneholde opptil 5000 ikke-kinesiske eller 2500 kinesiske tegn. Dersom grensen overskrides, fjernes den overskytende delen. Viktige handlinger og bevegelsesdetaljer bør derfor beskrives innenfor denne grensen. Samme tilfeldige startverdi kan gi lignende videoer, men garanterer ikke at de blir identiske bilde for bilde.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "706efde2d5fd4292c51b07ebfc18b92f3b48fffab85ad20765683f4be9cb3079", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nb", "methods": [ { "html": "happyhorse-1.1-i2vEn modell som animerer et bilde: kildebildet bestemmer det første videobildet, og beskrivelsen styrer bevegelsen videre. Lager en kort video med mulighet for lyd.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
HappyHorse-1.1-I2V er en modell fra Alibaba som starter en videoscene med et ferdig bilde. Bildet blir det første videobildet, mens teksten kan bestemme hva som skjer videre: figurens bevegelser, endringer i scenen og kameraføringen. Dette egner seg til å animere en illustrasjon, et produktfoto eller et visuelt konsept som er laget på forhånd.
En tekstbeskrivelse er ikke påkrevd. Uten tekst utleder modellen selv en mulig bevegelse fra innholdet i startbildet. Når oppgaven er beskrevet eksplisitt, bestemmer kildebildet komposisjonen og objektenes utseende, mens ordene styrer hvordan scenen utvikler seg over tid.
Alibaba fremhever bevaring av figurens utseende, visuell sammenheng, jevne bevegelser og samspillet mellom bilde og lyd. Stabil gjengivelse av tekst og teksturer er også blant målene som oppgis. Dette beskriver hva modellen er utviklet for, og betyr ikke at hver piksel beholdes bokstavelig i alle genererte bilder.
Denne modusen bruker ett startbilde. Det bestemmer utgangsscenen og er ikke en samling uavhengige eksempler for en ny komposisjon. Muligheten til å angi et eget sluttbilde er ikke oppgitt for denne bestemte versjonen.
JPEG, JPG, PNG og WEBP godtas. Hver side av inndatabildet må være minst 300 piksler; tillatt sideforhold er fra 1:2,5 til 2,5:1, og filstørrelsen er opptil 20 MB. Sideforholdet i den ferdige videoen følger det første bildet.
Varigheten velges som et heltall fra 3 til 15 sekunder. Oppløsningene 480P, 720P og 1080P er tilgjengelige; utdataformatet er MP4 med 24 bilder per sekund. Det er støtte for å lage lyd sammen med videoen.
Beskrivelsen kan være på hvilket som helst språk og inneholde opptil 5000 ikke-kinesiske eller 2500 kinesiske tegn. Dersom grensen overskrides, fjernes den overskytende delen. Viktige handlinger og bevegelsesdetaljer bør derfor beskrives innenfor denne grensen. Samme tilfeldige startverdi kan gi lignende videoer, men garanterer ikke at de blir identiske bilde for bilde.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser happyhorse-1.1-i2v | Standard— |
Feltprompt | Typestring | KravValgfritt | Verdier & grenser Minste lengde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 3 Maksimum: 15 Enhet: sekunder | Standard5 |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 480P, 720P, 1080P | Standard720P |
Feltratio | Typestring | KravStøttes ikke | Verdier & grenser | Standard— |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 1 Maksimalt antall dekodede byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Påkrevd: image_urls
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, image_urls |
Parametermaterial_types | Avtaletext, image |
Parameteroptional | Avtaleduration, resolution, ratio, prompt |
Parameterduration_integer_range | Avtale3, 15 |
Parameterdefault_duration | Avtale5 |
Parameterresolution | Avtale480P, 720P, 1080P |
Parameterdefault_resolution | Avtale720P |
Parameterratio | Avtale |
Parameterratio_must_omit | Avtaletrue |
Parameterimage_urls | Avtale{"min_count":1,"max_count":1,"schemes":["https","Rasterdata i base64"],"max_data_image_bytes":20971520} |
Livssyklus: 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
Metodestrukturer og ID-er er eksakte; leverandørens evne er adskilt fra godkjenning av forespørselen.
POST /v1/videos/generationsAiloot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
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\nLagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Bevar hvert returnert dataelement og hver utdataindeks. content_url viser bare til det første; hent hver faktiske innholdssti og ressurs. GET for innhold uten index omfatter ikke alle utdata.
Les den eksisterende opprinnelige jobben; send aldri en forespørsel med ukjent utfall på nytt.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltobject | Typestring |
Feltmodel | Typestring |
Feltstatus | Typestring |
Feltcontent_url | Typesigned URL |
Feltdata[] | Typesigned URL |
Feltusage | Typeobject |
Feltresult_pending_check | Typeboolean |
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldige påkrevde felter, materialrepresentasjon eller parameterverdi | Neste trinnKorriger de angitte feltene før en ny opprettelsesforespørsel. |
Svar409 · video_not_ready | VilkårDet opprinnelige resultatinnholdet er ennå ikke tilgjengelig | Neste trinnSpør jevnlig etter den opprinnelige returnerte ID-en og følg Retry-After. |
Svarserver_error | VilkårDet returnerte svaret angir at operasjonen eller resultatet må kontrolleres | Neste trinnBevar den opprinnelige returnerte operasjons-/oppgave-ID-en, forespørselshodene og svaret; fortsett å lese den opprinnelige operasjonen på de støttede måtene. Ikke send opprettelsesforespørselen på nytt. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Bruk metodestiene som vises ovenfor.
happyhorse-i2vEn modell som animerer et bilde: kildebildet bestemmer det første videobildet, og beskrivelsen styrer bevegelsen videre. Lager en kort video med mulighet for lyd.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
HappyHorse-1.1-I2V er en modell fra Alibaba som starter en videoscene med et ferdig bilde. Bildet blir det første videobildet, mens teksten kan bestemme hva som skjer videre: figurens bevegelser, endringer i scenen og kameraføringen. Dette egner seg til å animere en illustrasjon, et produktfoto eller et visuelt konsept som er laget på forhånd.
En tekstbeskrivelse er ikke påkrevd. Uten tekst utleder modellen selv en mulig bevegelse fra innholdet i startbildet. Når oppgaven er beskrevet eksplisitt, bestemmer kildebildet komposisjonen og objektenes utseende, mens ordene styrer hvordan scenen utvikler seg over tid.
Alibaba fremhever bevaring av figurens utseende, visuell sammenheng, jevne bevegelser og samspillet mellom bilde og lyd. Stabil gjengivelse av tekst og teksturer er også blant målene som oppgis. Dette beskriver hva modellen er utviklet for, og betyr ikke at hver piksel beholdes bokstavelig i alle genererte bilder.
Denne modusen bruker ett startbilde. Det bestemmer utgangsscenen og er ikke en samling uavhengige eksempler for en ny komposisjon. Muligheten til å angi et eget sluttbilde er ikke oppgitt for denne bestemte versjonen.
JPEG, JPG, PNG og WEBP godtas. Hver side av inndatabildet må være minst 300 piksler; tillatt sideforhold er fra 1:2,5 til 2,5:1, og filstørrelsen er opptil 20 MB. Sideforholdet i den ferdige videoen følger det første bildet.
Varigheten velges som et heltall fra 3 til 15 sekunder. Oppløsningene 480P, 720P og 1080P er tilgjengelige; utdataformatet er MP4 med 24 bilder per sekund. Det er støtte for å lage lyd sammen med videoen.
Beskrivelsen kan være på hvilket som helst språk og inneholde opptil 5000 ikke-kinesiske eller 2500 kinesiske tegn. Dersom grensen overskrides, fjernes den overskytende delen. Viktige handlinger og bevegelsesdetaljer bør derfor beskrives innenfor denne grensen. Samme tilfeldige startverdi kan gi lignende videoer, men garanterer ikke at de blir identiske bilde for bilde.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser happyhorse-i2v | Standard— |
Feltprompt | Typestring | KravValgfritt | Verdier & grenser Minste lengde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 3 Maksimum: 15 Enhet: sekunder | Standard5 |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 480P, 720P, 1080P | Standard720P |
Feltratio | Typestring | KravStøttes ikke | Verdier & grenser | Standard— |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 1 Maksimalt antall dekodede byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Påkrevd: image_urls
| Parameter | Avtale |
|---|---|
Parametermaterial_types | Avtaletext, image |
Parameterrequired | Avtalenull |
Parameteroptional_controls | Avtalenull |
Livssyklus: 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
Metodestrukturer og ID-er er eksakte; leverandørens evne er adskilt fra godkjenning av forespørselen.
POST /v1/videos/generationsAiloot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
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\nLagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Bevar hvert returnert dataelement og hver utdataindeks. content_url viser bare til det første; hent hver faktiske innholdssti og ressurs. GET for innhold uten index omfatter ikke alle utdata.
Les den eksisterende opprinnelige jobben; send aldri en forespørsel med ukjent utfall på nytt.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltobject | Typestring |
Feltmodel | Typestring |
Feltstatus | Typestring |
Feltcontent_url | Typesigned URL |
Feltdata[] | Typesigned URL |
Feltusage | Typeobject |
Feltresult_pending_check | Typeboolean |
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldige påkrevde felter, materialrepresentasjon eller parameterverdi | Neste trinnKorriger de angitte feltene før en ny opprettelsesforespørsel. |
Svar409 · video_not_ready | VilkårDet opprinnelige resultatinnholdet er ennå ikke tilgjengelig | Neste trinnSpør jevnlig etter den opprinnelige returnerte ID-en og følg Retry-After. |
Svarserver_error | VilkårDet returnerte svaret angir at operasjonen eller resultatet må kontrolleres | Neste trinnBevar den opprinnelige returnerte operasjons-/oppgave-ID-en, forespørselshodene og svaret; fortsett å lese den opprinnelige operasjonen på de støttede måtene. Ikke send opprettelsesforespørselen på nytt. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Bruk metodestiene som vises ovenfor.
happyhorse-i2v-latestEn modell som animerer et bilde: kildebildet bestemmer det første videobildet, og beskrivelsen styrer bevegelsen videre. Lager en kort video med mulighet for lyd.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
HappyHorse-1.1-I2V er en modell fra Alibaba som starter en videoscene med et ferdig bilde. Bildet blir det første videobildet, mens teksten kan bestemme hva som skjer videre: figurens bevegelser, endringer i scenen og kameraføringen. Dette egner seg til å animere en illustrasjon, et produktfoto eller et visuelt konsept som er laget på forhånd.
En tekstbeskrivelse er ikke påkrevd. Uten tekst utleder modellen selv en mulig bevegelse fra innholdet i startbildet. Når oppgaven er beskrevet eksplisitt, bestemmer kildebildet komposisjonen og objektenes utseende, mens ordene styrer hvordan scenen utvikler seg over tid.
Alibaba fremhever bevaring av figurens utseende, visuell sammenheng, jevne bevegelser og samspillet mellom bilde og lyd. Stabil gjengivelse av tekst og teksturer er også blant målene som oppgis. Dette beskriver hva modellen er utviklet for, og betyr ikke at hver piksel beholdes bokstavelig i alle genererte bilder.
Denne modusen bruker ett startbilde. Det bestemmer utgangsscenen og er ikke en samling uavhengige eksempler for en ny komposisjon. Muligheten til å angi et eget sluttbilde er ikke oppgitt for denne bestemte versjonen.
JPEG, JPG, PNG og WEBP godtas. Hver side av inndatabildet må være minst 300 piksler; tillatt sideforhold er fra 1:2,5 til 2,5:1, og filstørrelsen er opptil 20 MB. Sideforholdet i den ferdige videoen følger det første bildet.
Varigheten velges som et heltall fra 3 til 15 sekunder. Oppløsningene 480P, 720P og 1080P er tilgjengelige; utdataformatet er MP4 med 24 bilder per sekund. Det er støtte for å lage lyd sammen med videoen.
Beskrivelsen kan være på hvilket som helst språk og inneholde opptil 5000 ikke-kinesiske eller 2500 kinesiske tegn. Dersom grensen overskrides, fjernes den overskytende delen. Viktige handlinger og bevegelsesdetaljer bør derfor beskrives innenfor denne grensen. Samme tilfeldige startverdi kan gi lignende videoer, men garanterer ikke at de blir identiske bilde for bilde.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser happyhorse-i2v-latest | Standard— |
Feltprompt | Typestring | KravValgfritt | Verdier & grenser Minste lengde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 3 Maksimum: 15 Enhet: sekunder | Standard5 |
Feltresolution | Typestring | KravValgfritt | Verdier & grenser 480P, 720P, 1080P | Standard720P |
Feltratio | Typestring | KravStøttes ikke | Verdier & grenser | Standard— |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 1 Maksimalt antall dekodede byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Påkrevd: image_urls
| Parameter | Avtale |
|---|---|
Parametermaterial_types | Avtaletext, image |
Parameterrequired | Avtalenull |
Parameteroptional_controls | Avtalenull |
Livssyklus: 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
Metodestrukturer og ID-er er eksakte; leverandørens evne er adskilt fra godkjenning av forespørselen.
POST /v1/videos/generationsAiloot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
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\nLagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Bevar hvert returnert dataelement og hver utdataindeks. content_url viser bare til det første; hent hver faktiske innholdssti og ressurs. GET for innhold uten index omfatter ikke alle utdata.
Les den eksisterende opprinnelige jobben; send aldri en forespørsel med ukjent utfall på nytt.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltobject | Typestring |
Feltmodel | Typestring |
Feltstatus | Typestring |
Feltcontent_url | Typesigned URL |
Feltdata[] | Typesigned URL |
Feltusage | Typeobject |
Feltresult_pending_check | Typeboolean |
| Svar | Vilkår | Neste trinn |
|---|---|---|
Svar400 · invalid_request_error | VilkårUgyldige påkrevde felter, materialrepresentasjon eller parameterverdi | Neste trinnKorriger de angitte feltene før en ny opprettelsesforespørsel. |
Svar409 · video_not_ready | VilkårDet opprinnelige resultatinnholdet er ennå ikke tilgjengelig | Neste trinnSpør jevnlig etter den opprinnelige returnerte ID-en og følg Retry-After. |
Svarserver_error | VilkårDet returnerte svaret angir at operasjonen eller resultatet må kontrolleres | Neste trinnBevar den opprinnelige returnerte operasjons-/oppgave-ID-en, forespørselshodene og svaret; fortsett å lese den opprinnelige operasjonen på de støttede måtene. Ikke send opprettelsesforespørselen på nytt. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Bruk metodestiene som vises ovenfor.