HappyHorse-1.1-R2V maakt een nieuwe videoscène op basis van referentieafbeeldingen en een tekstuele opdracht. Alibaba richt het model op het behoud van herkenbare personages, objecten en visuele stijl bij het genereren van beweging. De referenties bepalen de inhoud en het uiterlijk van de scène, terwijl de tekst beschrijft hoe die elementen met elkaar moeten omgaan.
Er kunnen één tot negen afbeeldingen worden gebruikt. Ze kunnen een personage, voorwerp, omgeving of artistieke uitwerking bepalen. In de beschrijving kan het nummer van een referentie en een specifiek object erop worden genoemd om het visuele materiaal aan het juiste deel van de actie te koppelen. Dit is vooral nuttig wanneer elementen uit meerdere afbeeldingen in één compositie moeten worden samengebracht.
Anders dan in de modus met een beginframe dienen de referenties hier als houvast voor de inhoud van een nieuwe scène. Een tekstuele opdracht is verplicht: die verbindt het uiterlijk van de objecten met de actie, de camerabeweging en de algehele enscenering. De fabrikant benadrukt visuele samenhang en filmische beweging; het resultaat blijft gegenereerde video en is geen montage van de bronafbeeldingen.
JPEG, JPG, PNG en WEBP worden geaccepteerd, elk tot 20 MB. De korte zijde van de afbeelding moet minimaal 400 pixels zijn; materiaal van 720P of hoger wordt aanbevolen. De invoer van deze modus bestaat specifiek uit afbeeldingen en tekst.
Het resultaat wordt opgeslagen als MP4 met 24 frames per seconde. De duur wordt opgegeven als een geheel getal van 3 tot 15 seconden. De resolutie kan worden gekozen uit 480P, 720P en 1080P; het genereren van geluid wordt ondersteund.
Horizontale, verticale en vierkante beeldformaten zijn beschikbaar: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 en 21:9. De formaatkeuze helpt vooraf de compositieruimte van de nieuwe scène te bepalen.
De tekst mag in elke taal zijn. De grens is 5000 niet-Chinese of 2500 Chinese tekens; het overtollige deel wordt verwijderd. De belangrijkste rollen van de referenties, acties en bewegingen moeten binnen dit volume passen. Een willekeurige seed kan de gelijkenis tussen varianten sturen, maar garandeert geen exacte herhaling van een video.
", "aboutText": "HappyHorse-1.1-R2V maakt een nieuwe videoscène op basis van referentieafbeeldingen en een tekstuele opdracht. Alibaba richt het model op het behoud van herkenbare personages, objecten en visuele stijl bij het genereren van beweging. De referenties bepalen de inhoud en het uiterlijk van de scène, terwijl de tekst beschrijft hoe die elementen met elkaar moeten omgaan.\n\n### De rol van visuele voorbeelden\n\nEr kunnen één tot negen afbeeldingen worden gebruikt. Ze kunnen een personage, voorwerp, omgeving of artistieke uitwerking bepalen. In de beschrijving kan het nummer van een referentie en een specifiek object erop worden genoemd om het visuele materiaal aan het juiste deel van de actie te koppelen. Dit is vooral nuttig wanneer elementen uit meerdere afbeeldingen in één compositie moeten worden samengebracht.\n\nAnders dan in de modus met een beginframe dienen de referenties hier als houvast voor de inhoud van een nieuwe scène. Een tekstuele opdracht is verplicht: die verbindt het uiterlijk van de objecten met de actie, de camerabeweging en de algehele enscenering. De fabrikant benadrukt visuele samenhang en filmische beweging; het resultaat blijft gegenereerde video en is geen montage van de bronafbeeldingen.\n\nJPEG, JPG, PNG en WEBP worden geaccepteerd, elk tot 20 MB. De korte zijde van de afbeelding moet minimaal 400 pixels zijn; materiaal van 720P of hoger wordt aanbevolen. De invoer van deze modus bestaat specifiek uit afbeeldingen en tekst.\n\n### Duur, beeldformaat en geluid\n\nHet resultaat wordt opgeslagen als MP4 met 24 frames per seconde. De duur wordt opgegeven als een geheel getal van 3 tot 15 seconden. De resolutie kan worden gekozen uit 480P, 720P en 1080P; het genereren van geluid wordt ondersteund.\n\nHorizontale, verticale en vierkante beeldformaten zijn beschikbaar: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 en 21:9. De formaatkeuze helpt vooraf de compositieruimte van de nieuwe scène te bepalen.\n\nDe tekst mag in elke taal zijn. De grens is 5000 niet-Chinese of 2500 Chinese tekens; het overtollige deel wordt verwijderd. De belangrijkste rollen van de referenties, acties en bewegingen moeten binnen dit volume passen. Een willekeurige seed kan de gelijkenis tussen varianten sturen, maar garandeert geen exacte herhaling van een video.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "41ba878e48e5ad8c8a268e4019f14cdf1311a817c7ec794e2d7bd57533d35e79", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "happyhorse-1.1-r2vEen model voor videogeneratie op basis van referentieafbeeldingen en een tekstueel scenario. Het helpt het uiterlijk van personages, objecten en de visuele stijl in een nieuwe scène consistent te houden.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
HappyHorse-1.1-R2V maakt een nieuwe videoscène op basis van referentieafbeeldingen en een tekstuele opdracht. Alibaba richt het model op het behoud van herkenbare personages, objecten en visuele stijl bij het genereren van beweging. De referenties bepalen de inhoud en het uiterlijk van de scène, terwijl de tekst beschrijft hoe die elementen met elkaar moeten omgaan.
Er kunnen één tot negen afbeeldingen worden gebruikt. Ze kunnen een personage, voorwerp, omgeving of artistieke uitwerking bepalen. In de beschrijving kan het nummer van een referentie en een specifiek object erop worden genoemd om het visuele materiaal aan het juiste deel van de actie te koppelen. Dit is vooral nuttig wanneer elementen uit meerdere afbeeldingen in één compositie moeten worden samengebracht.
Anders dan in de modus met een beginframe dienen de referenties hier als houvast voor de inhoud van een nieuwe scène. Een tekstuele opdracht is verplicht: die verbindt het uiterlijk van de objecten met de actie, de camerabeweging en de algehele enscenering. De fabrikant benadrukt visuele samenhang en filmische beweging; het resultaat blijft gegenereerde video en is geen montage van de bronafbeeldingen.
JPEG, JPG, PNG en WEBP worden geaccepteerd, elk tot 20 MB. De korte zijde van de afbeelding moet minimaal 400 pixels zijn; materiaal van 720P of hoger wordt aanbevolen. De invoer van deze modus bestaat specifiek uit afbeeldingen en tekst.
Het resultaat wordt opgeslagen als MP4 met 24 frames per seconde. De duur wordt opgegeven als een geheel getal van 3 tot 15 seconden. De resolutie kan worden gekozen uit 480P, 720P en 1080P; het genereren van geluid wordt ondersteund.
Horizontale, verticale en vierkante beeldformaten zijn beschikbaar: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 en 21:9. De formaatkeuze helpt vooraf de compositieruimte van de nieuwe scène te bepalen.
De tekst mag in elke taal zijn. De grens is 5000 niet-Chinese of 2500 Chinese tekens; het overtollige deel wordt verwijderd. De belangrijkste rollen van de referenties, acties en bewegingen moeten binnen dit volume passen. Een willekeurige seed kan de gelijkenis tussen varianten sturen, maar garandeert geen exacte herhaling van een video.
POST /v1/videos/generationstext, imagevideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten happyhorse-1.1-r2v | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldduration | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 3 Maximum: 15 Eenheid: seconden | Standaard5 |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 480P, 720P, 1080P | Standaard720P |
Veldratio | Typestring | VereisteOptioneel | Waarden en limieten 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standaard16:9 |
Veldimage_urls | Typehttps_url|data_image_url[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 9 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/jpeg, image/png, image/webp | Standaard— |
reference_images_to_video · Vereist: prompt, image_urls
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, prompt, image_urls |
Parametermaterial_types | Contracttext, image |
Parameteroptional | Contractduration, resolution, ratio |
Parameterduration_integer_range | Contract3, 15 |
Parameterdefault_duration | Contract5 |
Parameterresolution | Contract480P, 720P, 1080P |
Parameterdefault_resolution | Contract720P |
Parameterratio | Contract16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Parameterratio_must_omit | Contractfalse |
Parameterimage_urls | Contract{"min_count":1,"max_count":9,"schemes":["https","rastergegevens in base64"],"max_data_image_bytes":20971520} |
Levenscyclus: 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
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/videos/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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\nSla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Behoud elk geretourneerd data-item en elke uitvoerindex. content_url verwijst alleen naar het eerste resultaat; haal elk daadwerkelijk inhoudspad en elke asset op. Een GET-verzoek voor inhoud zonder index levert niet alle uitvoer op.
Lees de bestaande oorspronkelijke taak; dien een onzekere verzending nooit opnieuw in.
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldobject | Typestring |
Veldmodel | Typestring |
Veldstatus | Typestring |
Veldcontent_url | Typesigned URL |
Velddata[] | Typesigned URL |
Veldusage | Typeobject |
Veldresult_pending_check | Typeboolean |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoord409 · video_not_ready | VoorwaardeOorspronkelijke resultaatinhoud nog niet beschikbaar | Volgende stapVraag de oorspronkelijke geretourneerde ID periodiek op en respecteer Retry-After. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gebruik de hierboven getoonde methodepaden.
happyhorse-r2vEen model voor videogeneratie op basis van referentieafbeeldingen en een tekstueel scenario. Het helpt het uiterlijk van personages, objecten en de visuele stijl in een nieuwe scène consistent te houden.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
HappyHorse-1.1-R2V maakt een nieuwe videoscène op basis van referentieafbeeldingen en een tekstuele opdracht. Alibaba richt het model op het behoud van herkenbare personages, objecten en visuele stijl bij het genereren van beweging. De referenties bepalen de inhoud en het uiterlijk van de scène, terwijl de tekst beschrijft hoe die elementen met elkaar moeten omgaan.
Er kunnen één tot negen afbeeldingen worden gebruikt. Ze kunnen een personage, voorwerp, omgeving of artistieke uitwerking bepalen. In de beschrijving kan het nummer van een referentie en een specifiek object erop worden genoemd om het visuele materiaal aan het juiste deel van de actie te koppelen. Dit is vooral nuttig wanneer elementen uit meerdere afbeeldingen in één compositie moeten worden samengebracht.
Anders dan in de modus met een beginframe dienen de referenties hier als houvast voor de inhoud van een nieuwe scène. Een tekstuele opdracht is verplicht: die verbindt het uiterlijk van de objecten met de actie, de camerabeweging en de algehele enscenering. De fabrikant benadrukt visuele samenhang en filmische beweging; het resultaat blijft gegenereerde video en is geen montage van de bronafbeeldingen.
JPEG, JPG, PNG en WEBP worden geaccepteerd, elk tot 20 MB. De korte zijde van de afbeelding moet minimaal 400 pixels zijn; materiaal van 720P of hoger wordt aanbevolen. De invoer van deze modus bestaat specifiek uit afbeeldingen en tekst.
Het resultaat wordt opgeslagen als MP4 met 24 frames per seconde. De duur wordt opgegeven als een geheel getal van 3 tot 15 seconden. De resolutie kan worden gekozen uit 480P, 720P en 1080P; het genereren van geluid wordt ondersteund.
Horizontale, verticale en vierkante beeldformaten zijn beschikbaar: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 en 21:9. De formaatkeuze helpt vooraf de compositieruimte van de nieuwe scène te bepalen.
De tekst mag in elke taal zijn. De grens is 5000 niet-Chinese of 2500 Chinese tekens; het overtollige deel wordt verwijderd. De belangrijkste rollen van de referenties, acties en bewegingen moeten binnen dit volume passen. Een willekeurige seed kan de gelijkenis tussen varianten sturen, maar garandeert geen exacte herhaling van een video.
POST /v1/videos/generationstext, imagevideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten happyhorse-r2v | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldduration | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 3 Maximum: 15 Eenheid: seconden | Standaard5 |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 480P, 720P, 1080P | Standaard720P |
Veldratio | Typestring | VereisteOptioneel | Waarden en limieten 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standaard16:9 |
Veldimage_urls | Typehttps_url|data_image_url[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 9 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/jpeg, image/png, image/webp | Standaard— |
reference_images_to_video · Vereist: prompt, image_urls
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext, image |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Levenscyclus: 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
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/videos/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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\nSla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Behoud elk geretourneerd data-item en elke uitvoerindex. content_url verwijst alleen naar het eerste resultaat; haal elk daadwerkelijk inhoudspad en elke asset op. Een GET-verzoek voor inhoud zonder index levert niet alle uitvoer op.
Lees de bestaande oorspronkelijke taak; dien een onzekere verzending nooit opnieuw in.
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldobject | Typestring |
Veldmodel | Typestring |
Veldstatus | Typestring |
Veldcontent_url | Typesigned URL |
Velddata[] | Typesigned URL |
Veldusage | Typeobject |
Veldresult_pending_check | Typeboolean |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoord409 · video_not_ready | VoorwaardeOorspronkelijke resultaatinhoud nog niet beschikbaar | Volgende stapVraag de oorspronkelijke geretourneerde ID periodiek op en respecteer Retry-After. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gebruik de hierboven getoonde methodepaden.
happyhorse-r2v-latestEen model voor videogeneratie op basis van referentieafbeeldingen en een tekstueel scenario. Het helpt het uiterlijk van personages, objecten en de visuele stijl in een nieuwe scène consistent te houden.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
HappyHorse-1.1-R2V maakt een nieuwe videoscène op basis van referentieafbeeldingen en een tekstuele opdracht. Alibaba richt het model op het behoud van herkenbare personages, objecten en visuele stijl bij het genereren van beweging. De referenties bepalen de inhoud en het uiterlijk van de scène, terwijl de tekst beschrijft hoe die elementen met elkaar moeten omgaan.
Er kunnen één tot negen afbeeldingen worden gebruikt. Ze kunnen een personage, voorwerp, omgeving of artistieke uitwerking bepalen. In de beschrijving kan het nummer van een referentie en een specifiek object erop worden genoemd om het visuele materiaal aan het juiste deel van de actie te koppelen. Dit is vooral nuttig wanneer elementen uit meerdere afbeeldingen in één compositie moeten worden samengebracht.
Anders dan in de modus met een beginframe dienen de referenties hier als houvast voor de inhoud van een nieuwe scène. Een tekstuele opdracht is verplicht: die verbindt het uiterlijk van de objecten met de actie, de camerabeweging en de algehele enscenering. De fabrikant benadrukt visuele samenhang en filmische beweging; het resultaat blijft gegenereerde video en is geen montage van de bronafbeeldingen.
JPEG, JPG, PNG en WEBP worden geaccepteerd, elk tot 20 MB. De korte zijde van de afbeelding moet minimaal 400 pixels zijn; materiaal van 720P of hoger wordt aanbevolen. De invoer van deze modus bestaat specifiek uit afbeeldingen en tekst.
Het resultaat wordt opgeslagen als MP4 met 24 frames per seconde. De duur wordt opgegeven als een geheel getal van 3 tot 15 seconden. De resolutie kan worden gekozen uit 480P, 720P en 1080P; het genereren van geluid wordt ondersteund.
Horizontale, verticale en vierkante beeldformaten zijn beschikbaar: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 en 21:9. De formaatkeuze helpt vooraf de compositieruimte van de nieuwe scène te bepalen.
De tekst mag in elke taal zijn. De grens is 5000 niet-Chinese of 2500 Chinese tekens; het overtollige deel wordt verwijderd. De belangrijkste rollen van de referenties, acties en bewegingen moeten binnen dit volume passen. Een willekeurige seed kan de gelijkenis tussen varianten sturen, maar garandeert geen exacte herhaling van een video.
POST /v1/videos/generationstext, imagevideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten happyhorse-r2v-latest | Standaard— |
Veldprompt | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldduration | Typeinteger | VereisteOptioneel | Waarden en limieten Minimum: 3 Maximum: 15 Eenheid: seconden | Standaard5 |
Veldresolution | Typestring | VereisteOptioneel | Waarden en limieten 480P, 720P, 1080P | Standaard720P |
Veldratio | Typestring | VereisteOptioneel | Waarden en limieten 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Standaard16:9 |
Veldimage_urls | Typehttps_url|data_image_url[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 9 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/jpeg, image/png, image/webp | Standaard— |
reference_images_to_video · Vereist: prompt, image_urls
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext, image |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Levenscyclus: 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
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
POST /v1/videos/generationsAiloot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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\nSla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.
Behoud elk geretourneerd data-item en elke uitvoerindex. content_url verwijst alleen naar het eerste resultaat; haal elk daadwerkelijk inhoudspad en elke asset op. Een GET-verzoek voor inhoud zonder index levert niet alle uitvoer op.
Lees de bestaande oorspronkelijke taak; dien een onzekere verzending nooit opnieuw in.
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldobject | Typestring |
Veldmodel | Typestring |
Veldstatus | Typestring |
Veldcontent_url | Typesigned URL |
Velddata[] | Typesigned URL |
Veldusage | Typeobject |
Veldresult_pending_check | Typeboolean |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoord409 · video_not_ready | VoorwaardeOorspronkelijke resultaatinhoud nog niet beschikbaar | Volgende stapVraag de oorspronkelijke geretourneerde ID periodiek op en respecteer Retry-After. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Gebruik de hierboven getoonde methodepaden.