HappyHorse-1.1-I2V is een model van Alibaba dat een videoscène begint met een bestaande afbeelding. Die afbeelding wordt het eerste frame; de tekst kan de verdere actie bepalen: de beweging van het personage, veranderingen in de scène en de richting van de camera. Dit is geschikt om een illustratie, productfoto of vooraf uitgewerkt visueel concept tot leven te brengen.
Een tekstbeschrijving is niet verplicht. Zonder beschrijving leidt het model zelf een mogelijke beweging af uit de inhoud van de beginafbeelding. Bij een expliciete opdracht bepaalt de bronafbeelding de compositie en het uiterlijk van de objecten, terwijl de woorden het verloop van de scène in de tijd sturen.
Alibaba benadrukt het behoud van het uiterlijk van personages, visuele samenhang, vloeiende beweging en de combinatie van beeld en geluid. Ook de consistentie van tekst en texturen wordt als doel genoemd. Dit zijn ontwerpdoelen van het model; ze betekenen niet dat elke pixel letterlijk behouden blijft in alle gegenereerde frames.
Deze modus gebruikt één beginafbeelding. Die bepaalt de uitgangsscène en is geen verzameling losse voorbeelden voor een nieuwe compositie. Voor deze specifieke versie is de mogelijkheid om een afzonderlijk eindframe op te geven niet aangekondigd.
JPEG, JPG, PNG en WEBP worden geaccepteerd. Elke zijde van de invoerafbeelding moet minimaal 300 pixels zijn; de toegestane beeldverhouding loopt van 1:2,5 tot 2,5:1 en de bestandsgrootte is maximaal 20 MB. De beeldverhouding van de uiteindelijke video volgt het eerste frame.
De duur wordt gekozen als een geheel getal van 3 tot 15 seconden. De resoluties 480P, 720P en 1080P zijn beschikbaar; het uitvoerformaat is MP4 met 24 frames per seconde. Het genereren van geluid samen met het beeld wordt ondersteund.
De beschrijving mag in elke taal zijn en bevat maximaal 5000 niet-Chinese of 2500 Chinese tekens. Bij overschrijding wordt het overtollige deel verwijderd; belangrijke acties en bewegingskenmerken moeten dus binnen die grens worden beschreven. Dezelfde willekeurige seed kan vergelijkbare video's opleveren, maar garandeert geen overeenkomst frame voor frame.
", "aboutText": "HappyHorse-1.1-I2V is een model van Alibaba dat een videoscène begint met een bestaande afbeelding. Die afbeelding wordt het eerste frame; de tekst kan de verdere actie bepalen: de beweging van het personage, veranderingen in de scène en de richting van de camera. Dit is geschikt om een illustratie, productfoto of vooraf uitgewerkt visueel concept tot leven te brengen.\n\nEen tekstbeschrijving is niet verplicht. Zonder beschrijving leidt het model zelf een mogelijke beweging af uit de inhoud van de beginafbeelding. Bij een expliciete opdracht bepaalt de bronafbeelding de compositie en het uiterlijk van de objecten, terwijl de woorden het verloop van de scène in de tijd sturen.\n\n### Van het eerste frame naar beweging\n\nAlibaba benadrukt het behoud van het uiterlijk van personages, visuele samenhang, vloeiende beweging en de combinatie van beeld en geluid. Ook de consistentie van tekst en texturen wordt als doel genoemd. Dit zijn ontwerpdoelen van het model; ze betekenen niet dat elke pixel letterlijk behouden blijft in alle gegenereerde frames.\n\nDeze modus gebruikt één beginafbeelding. Die bepaalt de uitgangsscène en is geen verzameling losse voorbeelden voor een nieuwe compositie. Voor deze specifieke versie is de mogelijkheid om een afzonderlijk eindframe op te geven niet aangekondigd.\n\nJPEG, JPG, PNG en WEBP worden geaccepteerd. Elke zijde van de invoerafbeelding moet minimaal 300 pixels zijn; de toegestane beeldverhouding loopt van 1:2,5 tot 2,5:1 en de bestandsgrootte is maximaal 20 MB. De beeldverhouding van de uiteindelijke video volgt het eerste frame.\n\n### Videoparameters\n\nDe duur wordt gekozen als een geheel getal van 3 tot 15 seconden. De resoluties 480P, 720P en 1080P zijn beschikbaar; het uitvoerformaat is MP4 met 24 frames per seconde. Het genereren van geluid samen met het beeld wordt ondersteund.\n\nDe beschrijving mag in elke taal zijn en bevat maximaal 5000 niet-Chinese of 2500 Chinese tekens. Bij overschrijding wordt het overtollige deel verwijderd; belangrijke acties en bewegingskenmerken moeten dus binnen die grens worden beschreven. Dezelfde willekeurige seed kan vergelijkbare video's opleveren, maar garandeert geen overeenkomst frame voor frame.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "77fdf865ea0572fc0a3596ac706b095b93f5ab00a3c442416d23e66b84192e14", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl", "methods": [ { "html": "happyhorse-1.1-i2vEen model om een afbeelding tot leven te brengen: de bronafbeelding bepaalt het eerste frame en de beschrijving stuurt de verdere beweging. Het maakt een korte video met de mogelijkheid om geluid toe te voegen.
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-I2V is een model van Alibaba dat een videoscène begint met een bestaande afbeelding. Die afbeelding wordt het eerste frame; de tekst kan de verdere actie bepalen: de beweging van het personage, veranderingen in de scène en de richting van de camera. Dit is geschikt om een illustratie, productfoto of vooraf uitgewerkt visueel concept tot leven te brengen.
Een tekstbeschrijving is niet verplicht. Zonder beschrijving leidt het model zelf een mogelijke beweging af uit de inhoud van de beginafbeelding. Bij een expliciete opdracht bepaalt de bronafbeelding de compositie en het uiterlijk van de objecten, terwijl de woorden het verloop van de scène in de tijd sturen.
Alibaba benadrukt het behoud van het uiterlijk van personages, visuele samenhang, vloeiende beweging en de combinatie van beeld en geluid. Ook de consistentie van tekst en texturen wordt als doel genoemd. Dit zijn ontwerpdoelen van het model; ze betekenen niet dat elke pixel letterlijk behouden blijft in alle gegenereerde frames.
Deze modus gebruikt één beginafbeelding. Die bepaalt de uitgangsscène en is geen verzameling losse voorbeelden voor een nieuwe compositie. Voor deze specifieke versie is de mogelijkheid om een afzonderlijk eindframe op te geven niet aangekondigd.
JPEG, JPG, PNG en WEBP worden geaccepteerd. Elke zijde van de invoerafbeelding moet minimaal 300 pixels zijn; de toegestane beeldverhouding loopt van 1:2,5 tot 2,5:1 en de bestandsgrootte is maximaal 20 MB. De beeldverhouding van de uiteindelijke video volgt het eerste frame.
De duur wordt gekozen als een geheel getal van 3 tot 15 seconden. De resoluties 480P, 720P en 1080P zijn beschikbaar; het uitvoerformaat is MP4 met 24 frames per seconde. Het genereren van geluid samen met het beeld wordt ondersteund.
De beschrijving mag in elke taal zijn en bevat maximaal 5000 niet-Chinese of 2500 Chinese tekens. Bij overschrijding wordt het overtollige deel verwijderd; belangrijke acties en bewegingskenmerken moeten dus binnen die grens worden beschreven. Dezelfde willekeurige seed kan vergelijkbare video's opleveren, maar garandeert geen overeenkomst frame voor frame.
POST /v1/videos/generationstext, imagevideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten happyhorse-1.1-i2v | Standaard— |
Veldprompt | Typestring | VereisteOptioneel | 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 | VereisteNiet ondersteund | Waarden en limieten | Standaard— |
Veldimage_urls | Typehttps_url|data_image_url[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/jpeg, image/png, image/webp | Standaard— |
first_frame_to_video · Vereist: image_urls
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, image_urls |
Parametermaterial_types | Contracttext, image |
Parameteroptional | Contractduration, resolution, ratio, prompt |
Parameterduration_integer_range | Contract3, 15 |
Parameterdefault_duration | Contract5 |
Parameterresolution | Contract480P, 720P, 1080P |
Parameterdefault_resolution | Contract720P |
Parameterratio | Contract |
Parameterratio_must_omit | Contracttrue |
Parameterimage_urls | Contract{"min_count":1,"max_count":1,"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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-1.1-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gebruik de hierboven getoonde methodepaden.
happyhorse-i2vEen model om een afbeelding tot leven te brengen: de bronafbeelding bepaalt het eerste frame en de beschrijving stuurt de verdere beweging. Het maakt een korte video met de mogelijkheid om geluid toe te voegen.
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-I2V is een model van Alibaba dat een videoscène begint met een bestaande afbeelding. Die afbeelding wordt het eerste frame; de tekst kan de verdere actie bepalen: de beweging van het personage, veranderingen in de scène en de richting van de camera. Dit is geschikt om een illustratie, productfoto of vooraf uitgewerkt visueel concept tot leven te brengen.
Een tekstbeschrijving is niet verplicht. Zonder beschrijving leidt het model zelf een mogelijke beweging af uit de inhoud van de beginafbeelding. Bij een expliciete opdracht bepaalt de bronafbeelding de compositie en het uiterlijk van de objecten, terwijl de woorden het verloop van de scène in de tijd sturen.
Alibaba benadrukt het behoud van het uiterlijk van personages, visuele samenhang, vloeiende beweging en de combinatie van beeld en geluid. Ook de consistentie van tekst en texturen wordt als doel genoemd. Dit zijn ontwerpdoelen van het model; ze betekenen niet dat elke pixel letterlijk behouden blijft in alle gegenereerde frames.
Deze modus gebruikt één beginafbeelding. Die bepaalt de uitgangsscène en is geen verzameling losse voorbeelden voor een nieuwe compositie. Voor deze specifieke versie is de mogelijkheid om een afzonderlijk eindframe op te geven niet aangekondigd.
JPEG, JPG, PNG en WEBP worden geaccepteerd. Elke zijde van de invoerafbeelding moet minimaal 300 pixels zijn; de toegestane beeldverhouding loopt van 1:2,5 tot 2,5:1 en de bestandsgrootte is maximaal 20 MB. De beeldverhouding van de uiteindelijke video volgt het eerste frame.
De duur wordt gekozen als een geheel getal van 3 tot 15 seconden. De resoluties 480P, 720P en 1080P zijn beschikbaar; het uitvoerformaat is MP4 met 24 frames per seconde. Het genereren van geluid samen met het beeld wordt ondersteund.
De beschrijving mag in elke taal zijn en bevat maximaal 5000 niet-Chinese of 2500 Chinese tekens. Bij overschrijding wordt het overtollige deel verwijderd; belangrijke acties en bewegingskenmerken moeten dus binnen die grens worden beschreven. Dezelfde willekeurige seed kan vergelijkbare video's opleveren, maar garandeert geen overeenkomst frame voor frame.
POST /v1/videos/generationstext, imagevideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten happyhorse-i2v | Standaard— |
Veldprompt | Typestring | VereisteOptioneel | 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 | VereisteNiet ondersteund | Waarden en limieten | Standaard— |
Veldimage_urls | Typehttps_url|data_image_url[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/jpeg, image/png, image/webp | Standaard— |
first_frame_to_video · Vereist: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gebruik de hierboven getoonde methodepaden.
happyhorse-i2v-latestEen model om een afbeelding tot leven te brengen: de bronafbeelding bepaalt het eerste frame en de beschrijving stuurt de verdere beweging. Het maakt een korte video met de mogelijkheid om geluid toe te voegen.
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-I2V is een model van Alibaba dat een videoscène begint met een bestaande afbeelding. Die afbeelding wordt het eerste frame; de tekst kan de verdere actie bepalen: de beweging van het personage, veranderingen in de scène en de richting van de camera. Dit is geschikt om een illustratie, productfoto of vooraf uitgewerkt visueel concept tot leven te brengen.
Een tekstbeschrijving is niet verplicht. Zonder beschrijving leidt het model zelf een mogelijke beweging af uit de inhoud van de beginafbeelding. Bij een expliciete opdracht bepaalt de bronafbeelding de compositie en het uiterlijk van de objecten, terwijl de woorden het verloop van de scène in de tijd sturen.
Alibaba benadrukt het behoud van het uiterlijk van personages, visuele samenhang, vloeiende beweging en de combinatie van beeld en geluid. Ook de consistentie van tekst en texturen wordt als doel genoemd. Dit zijn ontwerpdoelen van het model; ze betekenen niet dat elke pixel letterlijk behouden blijft in alle gegenereerde frames.
Deze modus gebruikt één beginafbeelding. Die bepaalt de uitgangsscène en is geen verzameling losse voorbeelden voor een nieuwe compositie. Voor deze specifieke versie is de mogelijkheid om een afzonderlijk eindframe op te geven niet aangekondigd.
JPEG, JPG, PNG en WEBP worden geaccepteerd. Elke zijde van de invoerafbeelding moet minimaal 300 pixels zijn; de toegestane beeldverhouding loopt van 1:2,5 tot 2,5:1 en de bestandsgrootte is maximaal 20 MB. De beeldverhouding van de uiteindelijke video volgt het eerste frame.
De duur wordt gekozen als een geheel getal van 3 tot 15 seconden. De resoluties 480P, 720P en 1080P zijn beschikbaar; het uitvoerformaat is MP4 met 24 frames per seconde. Het genereren van geluid samen met het beeld wordt ondersteund.
De beschrijving mag in elke taal zijn en bevat maximaal 5000 niet-Chinese of 2500 Chinese tekens. Bij overschrijding wordt het overtollige deel verwijderd; belangrijke acties en bewegingskenmerken moeten dus binnen die grens worden beschreven. Dezelfde willekeurige seed kan vergelijkbare video's opleveren, maar garandeert geen overeenkomst frame voor frame.
POST /v1/videos/generationstext, imagevideo| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten happyhorse-i2v-latest | Standaard— |
Veldprompt | Typestring | VereisteOptioneel | 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 | VereisteNiet ondersteund | Waarden en limieten | Standaard— |
Veldimage_urls | Typehttps_url|data_image_url[] | VereisteVereist | Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 Maximumaantal gedecodeerde bytes: 20.971.520 MIME-typen: image/jpeg, image/png, image/webp | Standaard— |
first_frame_to_video · Vereist: 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_URL:?Set the HTTPS URL of your actual first-frame image}"\nexport AILOOT_IMAGE_URL\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "happyhorse-i2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')\nfrom urllib.parse import urlsplit\nu=os.environ["AILOOT_IMAGE_URL"]\nz=urlsplit(u)\nif z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Set the actual HTTPS image URL")\np["image_urls"]=[u]\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("result.json").read_text())\nprint(json.dumps(r))\nPY_RESULT\nmp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json\npython3 - <<'PY_STATUS'\nimport json\nfrom pathlib import Path\nr=json.loads(Path("status.json").read_text())\nprint(json.dumps(r))\nif r.get("status")=="completed":\n for x in r.get("data",[]):print(x)\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"\nexport AILOOT_OPERATION_ID\noperation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Gebruik de hierboven getoonde methodepaden.