HappyHorse-1.1-R2V skaber en ny videoscene ud fra referencebilleder og en tekstinstruktion. Alibaba retter modellen mod at bevare genkendelige figurer, objekter og visuel stil ved generering af bevægelse. Referencerne fastlægger scenens indhold og udseende, mens teksten beskriver, hvordan elementerne skal samspille.
Der kan bruges fra ét til ni billeder. De kan fastlægge en figur, en genstand, omgivelserne eller det kunstneriske udtryk. Beskrivelsen kan angive referencens nummer og et bestemt objekt i den, så det visuelle materiale knyttes til den rette del af handlingen. Det er især nyttigt, når elementer fra flere billeder skal samles i én komposition.
I modsætning til tilstanden med en startframe fungerer referencerne her som grundlag for en ny scenes indhold. Tekstinstruktionen er obligatorisk: den forbinder objekternes udseende med handling, kamerabevægelse og samlet iscenesættelse. Producenten fremhæver visuel sammenhæng og filmisk bevægelse; resultatet er stadig en generering, ikke en montage af udgangsbillederne.
JPEG, JPG, PNG og WEBP på højst 20 MB hver accepteres. Billedets korte side skal være mindst 400 pixels; materiale i 720P eller højere anbefales. Input til denne tilstand består netop af billeder og tekst.
Resultatet gemmes som MP4 med 24 frames i sekundet. Varigheden angives som et heltal fra 3 til 15 sekunder. Opløsningen kan vælges mellem 480P, 720P og 1080P; generering af ledsagende lyd understøttes.
Vandrette, lodrette og kvadratiske billedformater er tilgængelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Formatvalget hjælper med at fastlægge den nye scenes kompositionsrum på forhånd.
Teksten kan være på ethvert sprog. Grænsen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; den overskydende del kasseres. Referencernes vigtigste roller, handlingen og bevægelsen skal kunne beskrives inden for denne mængde. Tilfældighedsseedet kan styre ligheden mellem varianter, men garanterer ikke en nøjagtig gentagelse af en video.
", "aboutText": "HappyHorse-1.1-R2V skaber en ny videoscene ud fra referencebilleder og en tekstinstruktion. Alibaba retter modellen mod at bevare genkendelige figurer, objekter og visuel stil ved generering af bevægelse. Referencerne fastlægger scenens indhold og udseende, mens teksten beskriver, hvordan elementerne skal samspille.\n\n### De visuelle eksemplers roller\n\nDer kan bruges fra ét til ni billeder. De kan fastlægge en figur, en genstand, omgivelserne eller det kunstneriske udtryk. Beskrivelsen kan angive referencens nummer og et bestemt objekt i den, så det visuelle materiale knyttes til den rette del af handlingen. Det er især nyttigt, når elementer fra flere billeder skal samles i én komposition.\n\nI modsætning til tilstanden med en startframe fungerer referencerne her som grundlag for en ny scenes indhold. Tekstinstruktionen er obligatorisk: den forbinder objekternes udseende med handling, kamerabevægelse og samlet iscenesættelse. Producenten fremhæver visuel sammenhæng og filmisk bevægelse; resultatet er stadig en generering, ikke en montage af udgangsbillederne.\n\nJPEG, JPG, PNG og WEBP på højst 20 MB hver accepteres. Billedets korte side skal være mindst 400 pixels; materiale i 720P eller højere anbefales. Input til denne tilstand består netop af billeder og tekst.\n\n### Varighed, billedformat og lyd\n\nResultatet gemmes som MP4 med 24 frames i sekundet. Varigheden angives som et heltal fra 3 til 15 sekunder. Opløsningen kan vælges mellem 480P, 720P og 1080P; generering af ledsagende lyd understøttes.\n\nVandrette, lodrette og kvadratiske billedformater er tilgængelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Formatvalget hjælper med at fastlægge den nye scenes kompositionsrum på forhånd.\n\nTeksten kan være på ethvert sprog. Grænsen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; den overskydende del kasseres. Referencernes vigtigste roller, handlingen og bevægelsen skal kunne beskrives inden for denne mængde. Tilfældighedsseedet kan styre ligheden mellem varianter, men garanterer ikke en nøjagtig gentagelse af en video.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "467f1f87063f53f04598eae2dd0c358cbe9a1a805b733eb08331dd88bab12781", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "da", "methods": [ { "html": "happyhorse-1.1-r2vModel til videogenerering ud fra referencebilleder og et tekstbaseret scenarie. Hjælper med at bevare figurernes udseende, genstande og visuel stil i en ny scene.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HappyHorse-1.1-R2V skaber en ny videoscene ud fra referencebilleder og en tekstinstruktion. Alibaba retter modellen mod at bevare genkendelige figurer, objekter og visuel stil ved generering af bevægelse. Referencerne fastlægger scenens indhold og udseende, mens teksten beskriver, hvordan elementerne skal samspille.
Der kan bruges fra ét til ni billeder. De kan fastlægge en figur, en genstand, omgivelserne eller det kunstneriske udtryk. Beskrivelsen kan angive referencens nummer og et bestemt objekt i den, så det visuelle materiale knyttes til den rette del af handlingen. Det er især nyttigt, når elementer fra flere billeder skal samles i én komposition.
I modsætning til tilstanden med en startframe fungerer referencerne her som grundlag for en ny scenes indhold. Tekstinstruktionen er obligatorisk: den forbinder objekternes udseende med handling, kamerabevægelse og samlet iscenesættelse. Producenten fremhæver visuel sammenhæng og filmisk bevægelse; resultatet er stadig en generering, ikke en montage af udgangsbillederne.
JPEG, JPG, PNG og WEBP på højst 20 MB hver accepteres. Billedets korte side skal være mindst 400 pixels; materiale i 720P eller højere anbefales. Input til denne tilstand består netop af billeder og tekst.
Resultatet gemmes som MP4 med 24 frames i sekundet. Varigheden angives som et heltal fra 3 til 15 sekunder. Opløsningen kan vælges mellem 480P, 720P og 1080P; generering af ledsagende lyd understøttes.
Vandrette, lodrette og kvadratiske billedformater er tilgængelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Formatvalget hjælper med at fastlægge den nye scenes kompositionsrum på forhånd.
Teksten kan være på ethvert sprog. Grænsen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; den overskydende del kasseres. Referencernes vigtigste roller, handlingen og bevægelsen skal kunne beskrives inden for denne mængde. Tilfældighedsseedet kan styre ligheden mellem varianter, men garanterer ikke en nøjagtig gentagelse af en video.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser happyhorse-1.1-r2v | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 3 Maksimum: 15 Enhed: sekunder | Standard5 |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 480P, 720P, 1080P | Standard720P |
Feltratio | Typestring | KravValgfrit | Værdier og grænser 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åkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 9 Maksimalt antal afkodede bytes: 20.971.520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Påkrævet: prompt, image_urls
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt, image_urls |
Parametermaterial_types | Kontrakttext, image |
Parameteroptional | Kontraktduration, resolution, ratio |
Parameterduration_integer_range | Kontrakt3, 15 |
Parameterdefault_duration | Kontrakt5 |
Parameterresolution | Kontrakt480P, 720P, 1080P |
Parameterdefault_resolution | Kontrakt720P |
Parameterratio | Kontrakt16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Kontraktfalse |
Parameterimage_urls | Kontrakt{"min_count":1,"max_count":9,"schemes":["https","base64-kodede rasterdata"],"max_data_image_bytes":20971520} |
Livscyklus: 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
Metodernes strukturer og ID’er er præcise; leverandørens muligheder er adskilt fra adgangstilladelse.
POST /v1/videos/generationsAiloot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
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\nGem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Bevar hvert returneret dataelement og outputindeks. content_url omfatter kun det første; hent hver faktisk indholdssti og hvert aktiv. GET af indhold uden index giver ikke alle output.
Læs det eksisterende oprindelige job; indsend aldrig en afsendelse med ukendt udfald igen.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltobject | Typestring |
Feltmodel | Typestring |
Feltstatus | Typestring |
Feltcontent_url | Typesigned URL |
Feltdata[] | Typesigned URL |
Feltusage | Typeobject |
Feltresult_pending_check | Typeboolean |
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldige obligatoriske felter, materialerepræsentation eller parameterværdi | Næste trinRet de angivne felter før en ny oprettelsesanmodning. |
Svar409 · video_not_ready | BetingelseDet oprindelige resultatindhold er endnu ikke tilgængeligt | Næste trinForespørg på status med det oprindeligt returnerede ID, og overhold Retry-After. |
Svarserver_error | BetingelseDet returnerede svar angiver, at operationen eller resultatet skal kontrolleres | Næste trinGem det oprindeligt returnerede operations-/opgave-ID, anmodningens headere og svaret; fortsæt med de understøttede læseanmodninger for den oprindelige operation. Send ikke oprettelsesanmodningen igen. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Brug metodestierne vist ovenfor.
happyhorse-r2vModel til videogenerering ud fra referencebilleder og et tekstbaseret scenarie. Hjælper med at bevare figurernes udseende, genstande og visuel stil i en ny scene.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HappyHorse-1.1-R2V skaber en ny videoscene ud fra referencebilleder og en tekstinstruktion. Alibaba retter modellen mod at bevare genkendelige figurer, objekter og visuel stil ved generering af bevægelse. Referencerne fastlægger scenens indhold og udseende, mens teksten beskriver, hvordan elementerne skal samspille.
Der kan bruges fra ét til ni billeder. De kan fastlægge en figur, en genstand, omgivelserne eller det kunstneriske udtryk. Beskrivelsen kan angive referencens nummer og et bestemt objekt i den, så det visuelle materiale knyttes til den rette del af handlingen. Det er især nyttigt, når elementer fra flere billeder skal samles i én komposition.
I modsætning til tilstanden med en startframe fungerer referencerne her som grundlag for en ny scenes indhold. Tekstinstruktionen er obligatorisk: den forbinder objekternes udseende med handling, kamerabevægelse og samlet iscenesættelse. Producenten fremhæver visuel sammenhæng og filmisk bevægelse; resultatet er stadig en generering, ikke en montage af udgangsbillederne.
JPEG, JPG, PNG og WEBP på højst 20 MB hver accepteres. Billedets korte side skal være mindst 400 pixels; materiale i 720P eller højere anbefales. Input til denne tilstand består netop af billeder og tekst.
Resultatet gemmes som MP4 med 24 frames i sekundet. Varigheden angives som et heltal fra 3 til 15 sekunder. Opløsningen kan vælges mellem 480P, 720P og 1080P; generering af ledsagende lyd understøttes.
Vandrette, lodrette og kvadratiske billedformater er tilgængelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Formatvalget hjælper med at fastlægge den nye scenes kompositionsrum på forhånd.
Teksten kan være på ethvert sprog. Grænsen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; den overskydende del kasseres. Referencernes vigtigste roller, handlingen og bevægelsen skal kunne beskrives inden for denne mængde. Tilfældighedsseedet kan styre ligheden mellem varianter, men garanterer ikke en nøjagtig gentagelse af en video.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser happyhorse-r2v | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 3 Maksimum: 15 Enhed: sekunder | Standard5 |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 480P, 720P, 1080P | Standard720P |
Feltratio | Typestring | KravValgfrit | Værdier og grænser 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åkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 9 Maksimalt antal afkodede bytes: 20.971.520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Påkrævet: prompt, image_urls
| Parameter | Kontrakt |
|---|---|
Parametermaterial_types | Kontrakttext, image |
Parameterrequired | Kontraktnull |
Parameteroptional_controls | Kontraktnull |
Livscyklus: 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
Metodernes strukturer og ID’er er præcise; leverandørens muligheder er adskilt fra adgangstilladelse.
POST /v1/videos/generationsAiloot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
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\nGem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Bevar hvert returneret dataelement og outputindeks. content_url omfatter kun det første; hent hver faktisk indholdssti og hvert aktiv. GET af indhold uden index giver ikke alle output.
Læs det eksisterende oprindelige job; indsend aldrig en afsendelse med ukendt udfald igen.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltobject | Typestring |
Feltmodel | Typestring |
Feltstatus | Typestring |
Feltcontent_url | Typesigned URL |
Feltdata[] | Typesigned URL |
Feltusage | Typeobject |
Feltresult_pending_check | Typeboolean |
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldige obligatoriske felter, materialerepræsentation eller parameterværdi | Næste trinRet de angivne felter før en ny oprettelsesanmodning. |
Svar409 · video_not_ready | BetingelseDet oprindelige resultatindhold er endnu ikke tilgængeligt | Næste trinForespørg på status med det oprindeligt returnerede ID, og overhold Retry-After. |
Svarserver_error | BetingelseDet returnerede svar angiver, at operationen eller resultatet skal kontrolleres | Næste trinGem det oprindeligt returnerede operations-/opgave-ID, anmodningens headere og svaret; fortsæt med de understøttede læseanmodninger for den oprindelige operation. Send ikke oprettelsesanmodningen igen. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Brug metodestierne vist ovenfor.
happyhorse-r2v-latestModel til videogenerering ud fra referencebilleder og et tekstbaseret scenarie. Hjælper med at bevare figurernes udseende, genstande og visuel stil i en ny scene.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HappyHorse-1.1-R2V skaber en ny videoscene ud fra referencebilleder og en tekstinstruktion. Alibaba retter modellen mod at bevare genkendelige figurer, objekter og visuel stil ved generering af bevægelse. Referencerne fastlægger scenens indhold og udseende, mens teksten beskriver, hvordan elementerne skal samspille.
Der kan bruges fra ét til ni billeder. De kan fastlægge en figur, en genstand, omgivelserne eller det kunstneriske udtryk. Beskrivelsen kan angive referencens nummer og et bestemt objekt i den, så det visuelle materiale knyttes til den rette del af handlingen. Det er især nyttigt, når elementer fra flere billeder skal samles i én komposition.
I modsætning til tilstanden med en startframe fungerer referencerne her som grundlag for en ny scenes indhold. Tekstinstruktionen er obligatorisk: den forbinder objekternes udseende med handling, kamerabevægelse og samlet iscenesættelse. Producenten fremhæver visuel sammenhæng og filmisk bevægelse; resultatet er stadig en generering, ikke en montage af udgangsbillederne.
JPEG, JPG, PNG og WEBP på højst 20 MB hver accepteres. Billedets korte side skal være mindst 400 pixels; materiale i 720P eller højere anbefales. Input til denne tilstand består netop af billeder og tekst.
Resultatet gemmes som MP4 med 24 frames i sekundet. Varigheden angives som et heltal fra 3 til 15 sekunder. Opløsningen kan vælges mellem 480P, 720P og 1080P; generering af ledsagende lyd understøttes.
Vandrette, lodrette og kvadratiske billedformater er tilgængelige: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 og 21:9. Formatvalget hjælper med at fastlægge den nye scenes kompositionsrum på forhånd.
Teksten kan være på ethvert sprog. Grænsen er 5000 ikke-kinesiske eller 2500 kinesiske tegn; den overskydende del kasseres. Referencernes vigtigste roller, handlingen og bevægelsen skal kunne beskrives inden for denne mængde. Tilfældighedsseedet kan styre ligheden mellem varianter, men garanterer ikke en nøjagtig gentagelse af en video.
POST /v1/videos/generationstext, imagevideo| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser happyhorse-r2v-latest | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltduration | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 3 Maksimum: 15 Enhed: sekunder | Standard5 |
Feltresolution | Typestring | KravValgfrit | Værdier og grænser 480P, 720P, 1080P | Standard720P |
Feltratio | Typestring | KravValgfrit | Værdier og grænser 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åkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 9 Maksimalt antal afkodede bytes: 20.971.520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
reference_images_to_video · Påkrævet: prompt, image_urls
| Parameter | Kontrakt |
|---|---|
Parametermaterial_types | Kontrakttext, image |
Parameterrequired | Kontraktnull |
Parameteroptional_controls | Kontraktnull |
Livscyklus: 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
Metodernes strukturer og ID’er er præcise; leverandørens muligheder er adskilt fra adgangstilladelse.
POST /v1/videos/generationsAiloot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
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\nGem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Bevar hvert returneret dataelement og outputindeks. content_url omfatter kun det første; hent hver faktisk indholdssti og hvert aktiv. GET af indhold uden index giver ikke alle output.
Læs det eksisterende oprindelige job; indsend aldrig en afsendelse med ukendt udfald igen.
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltobject | Typestring |
Feltmodel | Typestring |
Feltstatus | Typestring |
Feltcontent_url | Typesigned URL |
Feltdata[] | Typesigned URL |
Feltusage | Typeobject |
Feltresult_pending_check | Typeboolean |
| Svar | Betingelse | Næste trin |
|---|---|---|
Svar400 · invalid_request_error | BetingelseUgyldige obligatoriske felter, materialerepræsentation eller parameterværdi | Næste trinRet de angivne felter før en ny oprettelsesanmodning. |
Svar409 · video_not_ready | BetingelseDet oprindelige resultatindhold er endnu ikke tilgængeligt | Næste trinForespørg på status med det oprindeligt returnerede ID, og overhold Retry-After. |
Svarserver_error | BetingelseDet returnerede svar angiver, at operationen eller resultatet skal kontrolleres | Næste trinGem det oprindeligt returnerede operations-/opgave-ID, anmodningens headere og svaret; fortsæt med de understøttede læseanmodninger for den oprindelige operation. Send ikke oprettelsesanmodningen igen. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Brug metodestierne vist ovenfor.