HappyHorse-1.1-I2V er en model fra Alibaba, der begynder en videoscene med et færdigt billede. Billedet bliver første frame, og teksten kan fastlægge den efterfølgende handling: figurens bevægelse, ændringer i scenen og kameraets retning. Det egner sig til at gøre en illustration, et produktfoto eller et forberedt visuelt koncept levende.
Tekstbeskrivelsen er valgfri. Uden den udleder modellen selv mulig bevægelse fra indholdet i startbilledet. Med en udtrykkelig instruktion fastlægger udgangsbilledet kompositionen og objekternes udseende, mens ordene styrer scenens udvikling over tid.
Alibaba fremhæver bevarelse af figurens udseende, visuel sammenhæng, jævn bevægelse og kombinationen af billede og lyd. Blandt de beskrevne fokusområder er også stabile tekster og overfladestrukturer. Disse egenskaber vedrører modellens udformning og betyder ikke, at hver pixel bevares bogstaveligt i alle genererede frames.
Denne tilstand bruger ét startbillede. Det angiver udgangsscenen og er ikke et sæt uafhængige eksempler til en ny komposition. Muligheden for at angive en særskilt slutframe er ikke beskrevet for denne version.
JPEG, JPG, PNG og WEBP accepteres. Hver side af inputbilledet skal være mindst 300 pixels; det tilladte billedformat er fra 1:2,5 til 2,5:1, og filstørrelsen højst 20 MB. Den færdige videos billedformat følger første frame.
Varigheden vælges som et heltal fra 3 til 15 sekunder. Opløsningerne 480P, 720P og 1080P er tilgængelige; outputformatet er MP4 med 24 frames i sekundet. Lyd kan genereres sammen med videoen.
Beskrivelsen kan være på ethvert sprog og indeholde op til 5000 ikke-kinesiske eller 2500 kinesiske tegn. Overskrides grænsen, kasseres den overskydende del, så vigtige handlinger og bevægelsesegenskaber bør beskrives inden for opgavens rammer. Samme tilfældighedsseed kan give lignende videoer, men garanterer ikke, at de er ens frame for frame.
", "aboutText": "HappyHorse-1.1-I2V er en model fra Alibaba, der begynder en videoscene med et færdigt billede. Billedet bliver første frame, og teksten kan fastlægge den efterfølgende handling: figurens bevægelse, ændringer i scenen og kameraets retning. Det egner sig til at gøre en illustration, et produktfoto eller et forberedt visuelt koncept levende.\n\nTekstbeskrivelsen er valgfri. Uden den udleder modellen selv mulig bevægelse fra indholdet i startbilledet. Med en udtrykkelig instruktion fastlægger udgangsbilledet kompositionen og objekternes udseende, mens ordene styrer scenens udvikling over tid.\n\n### Fra første frame til bevægelse\n\nAlibaba fremhæver bevarelse af figurens udseende, visuel sammenhæng, jævn bevægelse og kombinationen af billede og lyd. Blandt de beskrevne fokusområder er også stabile tekster og overfladestrukturer. Disse egenskaber vedrører modellens udformning og betyder ikke, at hver pixel bevares bogstaveligt i alle genererede frames.\n\nDenne tilstand bruger ét startbillede. Det angiver udgangsscenen og er ikke et sæt uafhængige eksempler til en ny komposition. Muligheden for at angive en særskilt slutframe er ikke beskrevet for denne version.\n\nJPEG, JPG, PNG og WEBP accepteres. Hver side af inputbilledet skal være mindst 300 pixels; det tilladte billedformat er fra 1:2,5 til 2,5:1, og filstørrelsen højst 20 MB. Den færdige videos billedformat følger første frame.\n\n### Videoens parametre\n\nVarigheden vælges som et heltal fra 3 til 15 sekunder. Opløsningerne 480P, 720P og 1080P er tilgængelige; outputformatet er MP4 med 24 frames i sekundet. Lyd kan genereres sammen med videoen.\n\nBeskrivelsen kan være på ethvert sprog og indeholde op til 5000 ikke-kinesiske eller 2500 kinesiske tegn. Overskrides grænsen, kasseres den overskydende del, så vigtige handlinger og bevægelsesegenskaber bør beskrives inden for opgavens rammer. Samme tilfældighedsseed kan give lignende videoer, men garanterer ikke, at de er ens frame for frame.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3977e2b78dd5ee024526ca5fa2d394deabccc00f0bb1f66358a6644aa7a1b31a", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "da", "methods": [ { "html": "happyhorse-1.1-i2vModel, der gør et billede levende: udgangsbilledet angiver første frame, mens beskrivelsen styrer den efterfølgende bevægelse. Skaber en kort video med mulighed for lyd.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HappyHorse-1.1-I2V er en model fra Alibaba, der begynder en videoscene med et færdigt billede. Billedet bliver første frame, og teksten kan fastlægge den efterfølgende handling: figurens bevægelse, ændringer i scenen og kameraets retning. Det egner sig til at gøre en illustration, et produktfoto eller et forberedt visuelt koncept levende.
Tekstbeskrivelsen er valgfri. Uden den udleder modellen selv mulig bevægelse fra indholdet i startbilledet. Med en udtrykkelig instruktion fastlægger udgangsbilledet kompositionen og objekternes udseende, mens ordene styrer scenens udvikling over tid.
Alibaba fremhæver bevarelse af figurens udseende, visuel sammenhæng, jævn bevægelse og kombinationen af billede og lyd. Blandt de beskrevne fokusområder er også stabile tekster og overfladestrukturer. Disse egenskaber vedrører modellens udformning og betyder ikke, at hver pixel bevares bogstaveligt i alle genererede frames.
Denne tilstand bruger ét startbillede. Det angiver udgangsscenen og er ikke et sæt uafhængige eksempler til en ny komposition. Muligheden for at angive en særskilt slutframe er ikke beskrevet for denne version.
JPEG, JPG, PNG og WEBP accepteres. Hver side af inputbilledet skal være mindst 300 pixels; det tilladte billedformat er fra 1:2,5 til 2,5:1, og filstørrelsen højst 20 MB. Den færdige videos billedformat følger første frame.
Varigheden vælges som et heltal fra 3 til 15 sekunder. Opløsningerne 480P, 720P og 1080P er tilgængelige; outputformatet er MP4 med 24 frames i sekundet. Lyd kan genereres sammen med videoen.
Beskrivelsen kan være på ethvert sprog og indeholde op til 5000 ikke-kinesiske eller 2500 kinesiske tegn. Overskrides grænsen, kasseres den overskydende del, så vigtige handlinger og bevægelsesegenskaber bør beskrives inden for opgavens rammer. Samme tilfældighedsseed kan give lignende videoer, men garanterer ikke, at de er ens frame for frame.
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-i2v | Standard— |
Feltprompt | Typestring | KravValgfrit | 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 | KravIkke understøttet | Værdier og grænser | Standard— |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 1 Maksimalt antal afkodede bytes: 20.971.520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Påkrævet: image_urls
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, image_urls |
Parametermaterial_types | Kontrakttext, image |
Parameteroptional | Kontraktduration, resolution, ratio, prompt |
Parameterduration_integer_range | Kontrakt3, 15 |
Parameterdefault_duration | Kontrakt5 |
Parameterresolution | Kontrakt480P, 720P, 1080P |
Parameterdefault_resolution | Kontrakt720P |
Parameterratio | Kontrakt |
Parameterratio_must_omit | Kontrakttrue |
Parameterimage_urls | Kontrakt{"min_count":1,"max_count":1,"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_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\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Brug metodestierne vist ovenfor.
happyhorse-i2vModel, der gør et billede levende: udgangsbilledet angiver første frame, mens beskrivelsen styrer den efterfølgende bevægelse. Skaber en kort video med mulighed for lyd.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HappyHorse-1.1-I2V er en model fra Alibaba, der begynder en videoscene med et færdigt billede. Billedet bliver første frame, og teksten kan fastlægge den efterfølgende handling: figurens bevægelse, ændringer i scenen og kameraets retning. Det egner sig til at gøre en illustration, et produktfoto eller et forberedt visuelt koncept levende.
Tekstbeskrivelsen er valgfri. Uden den udleder modellen selv mulig bevægelse fra indholdet i startbilledet. Med en udtrykkelig instruktion fastlægger udgangsbilledet kompositionen og objekternes udseende, mens ordene styrer scenens udvikling over tid.
Alibaba fremhæver bevarelse af figurens udseende, visuel sammenhæng, jævn bevægelse og kombinationen af billede og lyd. Blandt de beskrevne fokusområder er også stabile tekster og overfladestrukturer. Disse egenskaber vedrører modellens udformning og betyder ikke, at hver pixel bevares bogstaveligt i alle genererede frames.
Denne tilstand bruger ét startbillede. Det angiver udgangsscenen og er ikke et sæt uafhængige eksempler til en ny komposition. Muligheden for at angive en særskilt slutframe er ikke beskrevet for denne version.
JPEG, JPG, PNG og WEBP accepteres. Hver side af inputbilledet skal være mindst 300 pixels; det tilladte billedformat er fra 1:2,5 til 2,5:1, og filstørrelsen højst 20 MB. Den færdige videos billedformat følger første frame.
Varigheden vælges som et heltal fra 3 til 15 sekunder. Opløsningerne 480P, 720P og 1080P er tilgængelige; outputformatet er MP4 med 24 frames i sekundet. Lyd kan genereres sammen med videoen.
Beskrivelsen kan være på ethvert sprog og indeholde op til 5000 ikke-kinesiske eller 2500 kinesiske tegn. Overskrides grænsen, kasseres den overskydende del, så vigtige handlinger og bevægelsesegenskaber bør beskrives inden for opgavens rammer. Samme tilfældighedsseed kan give lignende videoer, men garanterer ikke, at de er ens frame for frame.
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-i2v | Standard— |
Feltprompt | Typestring | KravValgfrit | 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 | KravIkke understøttet | Værdier og grænser | Standard— |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 1 Maksimalt antal afkodede bytes: 20.971.520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Påkrævet: 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_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\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Brug metodestierne vist ovenfor.
happyhorse-i2v-latestModel, der gør et billede levende: udgangsbilledet angiver første frame, mens beskrivelsen styrer den efterfølgende bevægelse. Skaber en kort video med mulighed for lyd.
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
HappyHorse-1.1-I2V er en model fra Alibaba, der begynder en videoscene med et færdigt billede. Billedet bliver første frame, og teksten kan fastlægge den efterfølgende handling: figurens bevægelse, ændringer i scenen og kameraets retning. Det egner sig til at gøre en illustration, et produktfoto eller et forberedt visuelt koncept levende.
Tekstbeskrivelsen er valgfri. Uden den udleder modellen selv mulig bevægelse fra indholdet i startbilledet. Med en udtrykkelig instruktion fastlægger udgangsbilledet kompositionen og objekternes udseende, mens ordene styrer scenens udvikling over tid.
Alibaba fremhæver bevarelse af figurens udseende, visuel sammenhæng, jævn bevægelse og kombinationen af billede og lyd. Blandt de beskrevne fokusområder er også stabile tekster og overfladestrukturer. Disse egenskaber vedrører modellens udformning og betyder ikke, at hver pixel bevares bogstaveligt i alle genererede frames.
Denne tilstand bruger ét startbillede. Det angiver udgangsscenen og er ikke et sæt uafhængige eksempler til en ny komposition. Muligheden for at angive en særskilt slutframe er ikke beskrevet for denne version.
JPEG, JPG, PNG og WEBP accepteres. Hver side af inputbilledet skal være mindst 300 pixels; det tilladte billedformat er fra 1:2,5 til 2,5:1, og filstørrelsen højst 20 MB. Den færdige videos billedformat følger første frame.
Varigheden vælges som et heltal fra 3 til 15 sekunder. Opløsningerne 480P, 720P og 1080P er tilgængelige; outputformatet er MP4 med 24 frames i sekundet. Lyd kan genereres sammen med videoen.
Beskrivelsen kan være på ethvert sprog og indeholde op til 5000 ikke-kinesiske eller 2500 kinesiske tegn. Overskrides grænsen, kasseres den overskydende del, så vigtige handlinger og bevægelsesegenskaber bør beskrives inden for opgavens rammer. Samme tilfældighedsseed kan give lignende videoer, men garanterer ikke, at de er ens frame for frame.
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-i2v-latest | Standard— |
Feltprompt | Typestring | KravValgfrit | 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 | KravIkke understøttet | Værdier og grænser | Standard— |
Feltimage_urls | Typehttps_url|data_image_url[] | KravPåkrævet | Værdier og grænser Minimumsantal elementer: 1 Maksimalt antal elementer: 1 Maksimalt antal afkodede bytes: 20.971.520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Påkrævet: 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_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\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-i2v, happyhorse-i2v, happyhorse-i2v-latest
Brug metodestierne vist ovenfor.