HappyHorse-1.1-R2V lager en ny videoscene fra referansebilder og en tekstbeskrivelse. Alibaba retter modellen mot å bevare gjenkjennelige figurer, objekter og visuell stil når bevegelse genereres. Referansene bestemmer scenens innhold og utseende, mens teksten beskriver hvordan elementene skal samhandle.
Det kan brukes fra ett til ni bilder. De kan angi en figur, gjenstand, omgivelse eller kunstnerisk utforming. Beskrivelsen kan nevne referansens nummer og et bestemt objekt i den, slik at det visuelle materialet knyttes til riktig del av handlingen. Dette er særlig nyttig når elementer fra flere bilder skal samles i én komposisjon.
I motsetning til modusen med et startbilde fungerer referansene her som grunnlag for innholdet i en ny scene. En tekstbeskrivelse er påkrevd: den knytter objektenes utseende til handlingen, kamerabevegelsen og iscenesettelsen som helhet. Produsenten fremhever visuell sammenheng og filmatiske bevegelser; resultatet er fortsatt generert video, ikke en montasje av kildebildene.
JPEG, JPG, PNG og WEBP godtas, med opptil 20 MB per bilde. Bildets korteste side må være minst 400 piksler; materiale på 720P eller høyere anbefales. Inndata i denne modusen består nettopp av bilder og tekst.
Resultatet lagres som MP4 med 24 bilder per sekund. Varigheten angis som et heltall fra 3 til 15 sekunder. Oppløsningen kan velges mellom 480P, 720P og 1080P; lydgenerering støttes.
Horisontale, vertikale og kvadratiske bildeformater er tilgjengelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Valg av format bidrar til å bestemme komposisjonsrommet for den nye scenen på forhånd.
Teksten kan være på hvilket som helst språk. Grensen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; overskytende tekst fjernes. Referansenes viktigste roller, handlingen og bevegelsen må få plass innenfor denne grensen. En tilfeldig startverdi kan styre likheten mellom varianter, men garanterer ikke at en video gjenskapes nøyaktig.
", "aboutText": "HappyHorse-1.1-R2V lager en ny videoscene fra referansebilder og en tekstbeskrivelse. Alibaba retter modellen mot å bevare gjenkjennelige figurer, objekter og visuell stil når bevegelse genereres. Referansene bestemmer scenens innhold og utseende, mens teksten beskriver hvordan elementene skal samhandle.\n\n### Rollen til visuelle eksempler\n\nDet kan brukes fra ett til ni bilder. De kan angi en figur, gjenstand, omgivelse eller kunstnerisk utforming. Beskrivelsen kan nevne referansens nummer og et bestemt objekt i den, slik at det visuelle materialet knyttes til riktig del av handlingen. Dette er særlig nyttig når elementer fra flere bilder skal samles i én komposisjon.\n\nI motsetning til modusen med et startbilde fungerer referansene her som grunnlag for innholdet i en ny scene. En tekstbeskrivelse er påkrevd: den knytter objektenes utseende til handlingen, kamerabevegelsen og iscenesettelsen som helhet. Produsenten fremhever visuell sammenheng og filmatiske bevegelser; resultatet er fortsatt generert video, ikke en montasje av kildebildene.\n\nJPEG, JPG, PNG og WEBP godtas, med opptil 20 MB per bilde. Bildets korteste side må være minst 400 piksler; materiale på 720P eller høyere anbefales. Inndata i denne modusen består nettopp av bilder og tekst.\n\n### Varighet, bildeformat og lyd\n\nResultatet lagres som MP4 med 24 bilder per sekund. Varigheten angis som et heltall fra 3 til 15 sekunder. Oppløsningen kan velges mellom 480P, 720P og 1080P; lydgenerering støttes.\n\nHorisontale, vertikale og kvadratiske bildeformater er tilgjengelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Valg av format bidrar til å bestemme komposisjonsrommet for den nye scenen på forhånd.\n\nTeksten kan være på hvilket som helst språk. Grensen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; overskytende tekst fjernes. Referansenes viktigste roller, handlingen og bevegelsen må få plass innenfor denne grensen. En tilfeldig startverdi kan styre likheten mellom varianter, men garanterer ikke at en video gjenskapes nøyaktig.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "c3feb14a47e64e82274577ee1143b97db95f7739beb14b4ffde737d3ff4e064e", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nb", "methods": [ { "html": "happyhorse-1.1-r2vEn modell som genererer video fra referansebilder og et tekstbasert scenario. Hjelper med å bevare figurenes utseende, gjenstander og visuell stil i en ny scene.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
HappyHorse-1.1-R2V lager en ny videoscene fra referansebilder og en tekstbeskrivelse. Alibaba retter modellen mot å bevare gjenkjennelige figurer, objekter og visuell stil når bevegelse genereres. Referansene bestemmer scenens innhold og utseende, mens teksten beskriver hvordan elementene skal samhandle.
Det kan brukes fra ett til ni bilder. De kan angi en figur, gjenstand, omgivelse eller kunstnerisk utforming. Beskrivelsen kan nevne referansens nummer og et bestemt objekt i den, slik at det visuelle materialet knyttes til riktig del av handlingen. Dette er særlig nyttig når elementer fra flere bilder skal samles i én komposisjon.
I motsetning til modusen med et startbilde fungerer referansene her som grunnlag for innholdet i en ny scene. En tekstbeskrivelse er påkrevd: den knytter objektenes utseende til handlingen, kamerabevegelsen og iscenesettelsen som helhet. Produsenten fremhever visuell sammenheng og filmatiske bevegelser; resultatet er fortsatt generert video, ikke en montasje av kildebildene.
JPEG, JPG, PNG og WEBP godtas, med opptil 20 MB per bilde. Bildets korteste side må være minst 400 piksler; materiale på 720P eller høyere anbefales. Inndata i denne modusen består nettopp av bilder og tekst.
Resultatet lagres som MP4 med 24 bilder per sekund. Varigheten angis som et heltall fra 3 til 15 sekunder. Oppløsningen kan velges mellom 480P, 720P og 1080P; lydgenerering støttes.
Horisontale, vertikale og kvadratiske bildeformater er tilgjengelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Valg av format bidrar til å bestemme komposisjonsrommet for den nye scenen på forhånd.
Teksten kan være på hvilket som helst språk. Grensen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; overskytende tekst fjernes. Referansenes viktigste roller, handlingen og bevegelsen må få plass innenfor denne grensen. En tilfeldig startverdi kan styre likheten mellom varianter, men garanterer ikke at en video gjenskapes nøyaktig.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser happyhorse-1.1-r2v | Standard— |
Feltprompt | Typestring | KravPåkrevd | 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 | KravValgfritt | Verdier & grenser 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 9 Maksimalt antall dekodede byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Påkrevd: prompt, image_urls
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt, image_urls |
Parametermaterial_types | Avtaletext, image |
Parameteroptional | Avtaleduration, resolution, ratio |
Parameterduration_integer_range | Avtale3, 15 |
Parameterdefault_duration | Avtale5 |
Parameterresolution | Avtale480P, 720P, 1080P |
Parameterdefault_resolution | Avtale720P |
Parameterratio | Avtale16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Avtalefalse |
Parameterimage_urls | Avtale{"min_count":1,"max_count":9,"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_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\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-r2v, happyhorse-r2v, happyhorse-r2v-latest
Bruk metodestiene som vises ovenfor.
happyhorse-r2vEn modell som genererer video fra referansebilder og et tekstbasert scenario. Hjelper med å bevare figurenes utseende, gjenstander og visuell stil i en ny scene.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
HappyHorse-1.1-R2V lager en ny videoscene fra referansebilder og en tekstbeskrivelse. Alibaba retter modellen mot å bevare gjenkjennelige figurer, objekter og visuell stil når bevegelse genereres. Referansene bestemmer scenens innhold og utseende, mens teksten beskriver hvordan elementene skal samhandle.
Det kan brukes fra ett til ni bilder. De kan angi en figur, gjenstand, omgivelse eller kunstnerisk utforming. Beskrivelsen kan nevne referansens nummer og et bestemt objekt i den, slik at det visuelle materialet knyttes til riktig del av handlingen. Dette er særlig nyttig når elementer fra flere bilder skal samles i én komposisjon.
I motsetning til modusen med et startbilde fungerer referansene her som grunnlag for innholdet i en ny scene. En tekstbeskrivelse er påkrevd: den knytter objektenes utseende til handlingen, kamerabevegelsen og iscenesettelsen som helhet. Produsenten fremhever visuell sammenheng og filmatiske bevegelser; resultatet er fortsatt generert video, ikke en montasje av kildebildene.
JPEG, JPG, PNG og WEBP godtas, med opptil 20 MB per bilde. Bildets korteste side må være minst 400 piksler; materiale på 720P eller høyere anbefales. Inndata i denne modusen består nettopp av bilder og tekst.
Resultatet lagres som MP4 med 24 bilder per sekund. Varigheten angis som et heltall fra 3 til 15 sekunder. Oppløsningen kan velges mellom 480P, 720P og 1080P; lydgenerering støttes.
Horisontale, vertikale og kvadratiske bildeformater er tilgjengelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Valg av format bidrar til å bestemme komposisjonsrommet for den nye scenen på forhånd.
Teksten kan være på hvilket som helst språk. Grensen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; overskytende tekst fjernes. Referansenes viktigste roller, handlingen og bevegelsen må få plass innenfor denne grensen. En tilfeldig startverdi kan styre likheten mellom varianter, men garanterer ikke at en video gjenskapes nøyaktig.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser happyhorse-r2v | Standard— |
Feltprompt | Typestring | KravPåkrevd | 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 | KravValgfritt | Verdier & grenser 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 9 Maksimalt antall dekodede byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Påkrevd: prompt, 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_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\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-r2v, happyhorse-r2v, happyhorse-r2v-latest
Bruk metodestiene som vises ovenfor.
happyhorse-r2v-latestEn modell som genererer video fra referansebilder og et tekstbasert scenario. Hjelper med å bevare figurenes utseende, gjenstander og visuell stil i en ny scene.
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
HappyHorse-1.1-R2V lager en ny videoscene fra referansebilder og en tekstbeskrivelse. Alibaba retter modellen mot å bevare gjenkjennelige figurer, objekter og visuell stil når bevegelse genereres. Referansene bestemmer scenens innhold og utseende, mens teksten beskriver hvordan elementene skal samhandle.
Det kan brukes fra ett til ni bilder. De kan angi en figur, gjenstand, omgivelse eller kunstnerisk utforming. Beskrivelsen kan nevne referansens nummer og et bestemt objekt i den, slik at det visuelle materialet knyttes til riktig del av handlingen. Dette er særlig nyttig når elementer fra flere bilder skal samles i én komposisjon.
I motsetning til modusen med et startbilde fungerer referansene her som grunnlag for innholdet i en ny scene. En tekstbeskrivelse er påkrevd: den knytter objektenes utseende til handlingen, kamerabevegelsen og iscenesettelsen som helhet. Produsenten fremhever visuell sammenheng og filmatiske bevegelser; resultatet er fortsatt generert video, ikke en montasje av kildebildene.
JPEG, JPG, PNG og WEBP godtas, med opptil 20 MB per bilde. Bildets korteste side må være minst 400 piksler; materiale på 720P eller høyere anbefales. Inndata i denne modusen består nettopp av bilder og tekst.
Resultatet lagres som MP4 med 24 bilder per sekund. Varigheten angis som et heltall fra 3 til 15 sekunder. Oppløsningen kan velges mellom 480P, 720P og 1080P; lydgenerering støttes.
Horisontale, vertikale og kvadratiske bildeformater er tilgjengelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Valg av format bidrar til å bestemme komposisjonsrommet for den nye scenen på forhånd.
Teksten kan være på hvilket som helst språk. Grensen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; overskytende tekst fjernes. Referansenes viktigste roller, handlingen og bevegelsen må få plass innenfor denne grensen. En tilfeldig startverdi kan styre likheten mellom varianter, men garanterer ikke at en video gjenskapes nøyaktig.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser happyhorse-r2v-latest | Standard— |
Feltprompt | Typestring | KravPåkrevd | 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 | KravValgfritt | Verdier & grenser 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standard16:9 |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrevd | Verdier & grenser Minste antall elementer: 1 Maksimalt antall elementer: 9 Maksimalt antall dekodede byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Påkrevd: prompt, 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_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\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-r2v, happyhorse-r2v, happyhorse-r2v-latest
Bruk metodestiene som vises ovenfor.