HappyHorse-1.1-I2V är en modell från Alibaba som inleder en videoscen med en färdig bild. Bilden blir den första bildrutan, och texten kan ange vad som sedan händer: karaktärens rörelser, förändringar i scenen och kamerans riktning. Det passar för att ge liv åt en illustration, ett produktfoto eller ett visuellt koncept som har förberetts i förväg.
Textbeskrivningen är valfri. Om den saknas härleder modellen själv möjliga rörelser ur innehållet i den första bilden. Med en uttrycklig instruktion anger ursprungsbilden kompositionen och objektens utseende, medan orden styr hur scenen utvecklas över tid.
Alibaba framhåller bevarandet av karaktärens utseende, visuell sammanhållning, jämna rörelser och kombinationen av bild och ljud. Även stabila texter och texturer ingår bland de angivna egenskaperna. Egenskaperna beskriver modellens avsikt och innebär inte att varje pixel bevaras exakt i alla genererade bildrutor.
Det här läget använder en enda startbild. Den anger den ursprungliga scenen och utgör inte en uppsättning fristående referenser för en ny komposition. Möjligheten att ange en separat slutbildruta har inte uppgetts för just den här versionen.
JPEG, JPG, PNG och WEBP accepteras. Varje sida av indatabilden måste vara minst 300 pixlar. Tillåtet bildförhållande är från 1:2,5 till 2,5:1 och filstorleken högst 20 MB. Den färdiga videons bildförhållande följer den första bildrutan.
Längden väljs som ett heltal från 3 till 15 sekunder. Upplösningarna 480P, 720P och 1080P finns tillgängliga. Utdataformatet är MP4 med 24 bildrutor per sekund. Ljud kan skapas tillsammans med videon.
Beskrivningen kan vara på vilket språk som helst och innehålla upp till 5000 icke-kinesiska eller 2500 kinesiska tecken. Överskrids gränsen tas den överskjutande delen bort. Viktiga handlingar och rörelser bör därför beskrivas inom instruktionens gräns. Samma inledande slumpfrö kan ge liknande videor men garanterar inte att de blir identiska bildruta för bildruta.
", "aboutText": "HappyHorse-1.1-I2V är en modell från Alibaba som inleder en videoscen med en färdig bild. Bilden blir den första bildrutan, och texten kan ange vad som sedan händer: karaktärens rörelser, förändringar i scenen och kamerans riktning. Det passar för att ge liv åt en illustration, ett produktfoto eller ett visuellt koncept som har förberetts i förväg.\n\nTextbeskrivningen är valfri. Om den saknas härleder modellen själv möjliga rörelser ur innehållet i den första bilden. Med en uttrycklig instruktion anger ursprungsbilden kompositionen och objektens utseende, medan orden styr hur scenen utvecklas över tid.\n\n### Från första bildrutan till rörelse\n\nAlibaba framhåller bevarandet av karaktärens utseende, visuell sammanhållning, jämna rörelser och kombinationen av bild och ljud. Även stabila texter och texturer ingår bland de angivna egenskaperna. Egenskaperna beskriver modellens avsikt och innebär inte att varje pixel bevaras exakt i alla genererade bildrutor.\n\nDet här läget använder en enda startbild. Den anger den ursprungliga scenen och utgör inte en uppsättning fristående referenser för en ny komposition. Möjligheten att ange en separat slutbildruta har inte uppgetts för just den här versionen.\n\nJPEG, JPG, PNG och WEBP accepteras. Varje sida av indatabilden måste vara minst 300 pixlar. Tillåtet bildförhållande är från 1:2,5 till 2,5:1 och filstorleken högst 20 MB. Den färdiga videons bildförhållande följer den första bildrutan.\n\n### Videons parametrar\n\nLängden väljs som ett heltal från 3 till 15 sekunder. Upplösningarna 480P, 720P och 1080P finns tillgängliga. Utdataformatet är MP4 med 24 bildrutor per sekund. Ljud kan skapas tillsammans med videon.\n\nBeskrivningen kan vara på vilket språk som helst och innehålla upp till 5000 icke-kinesiska eller 2500 kinesiska tecken. Överskrids gränsen tas den överskjutande delen bort. Viktiga handlingar och rörelser bör därför beskrivas inom instruktionens gräns. Samma inledande slumpfrö kan ge liknande videor men garanterar inte att de blir identiska bildruta för bildruta.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "cf3baf2bb43e326fe44dea23cdbb29ea06cd9b4822182c383b22a0469098c520", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "sv", "methods": [ { "html": "happyhorse-1.1-i2vModell som ger liv åt en bild: den ursprungliga bilden anger den första bildrutan, medan beskrivningen styr den fortsatta rörelsen. Skapar en kort video med möjlighet till ljud.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HappyHorse-1.1-I2V är en modell från Alibaba som inleder en videoscen med en färdig bild. Bilden blir den första bildrutan, och texten kan ange vad som sedan händer: karaktärens rörelser, förändringar i scenen och kamerans riktning. Det passar för att ge liv åt en illustration, ett produktfoto eller ett visuellt koncept som har förberetts i förväg.
Textbeskrivningen är valfri. Om den saknas härleder modellen själv möjliga rörelser ur innehållet i den första bilden. Med en uttrycklig instruktion anger ursprungsbilden kompositionen och objektens utseende, medan orden styr hur scenen utvecklas över tid.
Alibaba framhåller bevarandet av karaktärens utseende, visuell sammanhållning, jämna rörelser och kombinationen av bild och ljud. Även stabila texter och texturer ingår bland de angivna egenskaperna. Egenskaperna beskriver modellens avsikt och innebär inte att varje pixel bevaras exakt i alla genererade bildrutor.
Det här läget använder en enda startbild. Den anger den ursprungliga scenen och utgör inte en uppsättning fristående referenser för en ny komposition. Möjligheten att ange en separat slutbildruta har inte uppgetts för just den här versionen.
JPEG, JPG, PNG och WEBP accepteras. Varje sida av indatabilden måste vara minst 300 pixlar. Tillåtet bildförhållande är från 1:2,5 till 2,5:1 och filstorleken högst 20 MB. Den färdiga videons bildförhållande följer den första bildrutan.
Längden väljs som ett heltal från 3 till 15 sekunder. Upplösningarna 480P, 720P och 1080P finns tillgängliga. Utdataformatet är MP4 med 24 bildrutor per sekund. Ljud kan skapas tillsammans med videon.
Beskrivningen kan vara på vilket språk som helst och innehålla upp till 5000 icke-kinesiska eller 2500 kinesiska tecken. Överskrids gränsen tas den överskjutande delen bort. Viktiga handlingar och rörelser bör därför beskrivas inom instruktionens gräns. Samma inledande slumpfrö kan ge liknande videor men garanterar inte att de blir identiska bildruta för bildruta.
POST /v1/videos/generationstext, imagevideo| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser happyhorse-1.1-i2v | Standard— |
Fältprompt | Typstring | KravValfritt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 3 Maximum: 15 Enhet: sekunder | Standard5 |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480P, 720P, 1080P | Standard720P |
Fältratio | Typstring | KravStöds inte | Värden & gränser | Standard— |
Fältimage_urls | Typhttps_url|data_image_url[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 1 Maximalt antal avkodade byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Krävs: image_urls
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, image_urls |
Parametermaterial_types | Avtaltext, image |
Parameteroptional | Avtalduration, resolution, ratio, prompt |
Parameterduration_integer_range | Avtal3, 15 |
Parameterdefault_duration | Avtal5 |
Parameterresolution | Avtal480P, 720P, 1080P |
Parameterdefault_resolution | Avtal720P |
Parameterratio | Avtal |
Parameterratio_must_omit | Avtaltrue |
Parameterimage_urls | Avtal{"min_count":1,"max_count":1,"schemes":["https","data för rasterbild i base64"],"max_data_image_bytes":20971520} |
Livscykel: 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
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
POST /v1/videos/generationsAiloot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nSpara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Bevara varje returnerad datapost och utdataindex. content_url avser endast det första; hämta varje faktisk innehållssökväg och tillgång. GET av innehåll utan index omfattar inte alla resultat.
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältobject | Typstring |
Fältmodel | Typstring |
Fältstatus | Typstring |
Fältcontent_url | Typsigned URL |
Fältdata[] | Typsigned URL |
Fältusage | Typobject |
Fältresult_pending_check | Typboolean |
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Använd metodsökvägarna som visas ovan.
happyhorse-i2vModell som ger liv åt en bild: den ursprungliga bilden anger den första bildrutan, medan beskrivningen styr den fortsatta rörelsen. Skapar en kort video med möjlighet till ljud.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HappyHorse-1.1-I2V är en modell från Alibaba som inleder en videoscen med en färdig bild. Bilden blir den första bildrutan, och texten kan ange vad som sedan händer: karaktärens rörelser, förändringar i scenen och kamerans riktning. Det passar för att ge liv åt en illustration, ett produktfoto eller ett visuellt koncept som har förberetts i förväg.
Textbeskrivningen är valfri. Om den saknas härleder modellen själv möjliga rörelser ur innehållet i den första bilden. Med en uttrycklig instruktion anger ursprungsbilden kompositionen och objektens utseende, medan orden styr hur scenen utvecklas över tid.
Alibaba framhåller bevarandet av karaktärens utseende, visuell sammanhållning, jämna rörelser och kombinationen av bild och ljud. Även stabila texter och texturer ingår bland de angivna egenskaperna. Egenskaperna beskriver modellens avsikt och innebär inte att varje pixel bevaras exakt i alla genererade bildrutor.
Det här läget använder en enda startbild. Den anger den ursprungliga scenen och utgör inte en uppsättning fristående referenser för en ny komposition. Möjligheten att ange en separat slutbildruta har inte uppgetts för just den här versionen.
JPEG, JPG, PNG och WEBP accepteras. Varje sida av indatabilden måste vara minst 300 pixlar. Tillåtet bildförhållande är från 1:2,5 till 2,5:1 och filstorleken högst 20 MB. Den färdiga videons bildförhållande följer den första bildrutan.
Längden väljs som ett heltal från 3 till 15 sekunder. Upplösningarna 480P, 720P och 1080P finns tillgängliga. Utdataformatet är MP4 med 24 bildrutor per sekund. Ljud kan skapas tillsammans med videon.
Beskrivningen kan vara på vilket språk som helst och innehålla upp till 5000 icke-kinesiska eller 2500 kinesiska tecken. Överskrids gränsen tas den överskjutande delen bort. Viktiga handlingar och rörelser bör därför beskrivas inom instruktionens gräns. Samma inledande slumpfrö kan ge liknande videor men garanterar inte att de blir identiska bildruta för bildruta.
POST /v1/videos/generationstext, imagevideo| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser happyhorse-i2v | Standard— |
Fältprompt | Typstring | KravValfritt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 3 Maximum: 15 Enhet: sekunder | Standard5 |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480P, 720P, 1080P | Standard720P |
Fältratio | Typstring | KravStöds inte | Värden & gränser | Standard— |
Fältimage_urls | Typhttps_url|data_image_url[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 1 Maximalt antal avkodade byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Krävs: image_urls
| Parameter | Avtal |
|---|---|
Parametermaterial_types | Avtaltext, image |
Parameterrequired | Avtalnull |
Parameteroptional_controls | Avtalnull |
Livscykel: 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
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
POST /v1/videos/generationsAiloot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nSpara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Bevara varje returnerad datapost och utdataindex. content_url avser endast det första; hämta varje faktisk innehållssökväg och tillgång. GET av innehåll utan index omfattar inte alla resultat.
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältobject | Typstring |
Fältmodel | Typstring |
Fältstatus | Typstring |
Fältcontent_url | Typsigned URL |
Fältdata[] | Typsigned URL |
Fältusage | Typobject |
Fältresult_pending_check | Typboolean |
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Använd metodsökvägarna som visas ovan.
happyhorse-i2v-latestModell som ger liv åt en bild: den ursprungliga bilden anger den första bildrutan, medan beskrivningen styr den fortsatta rörelsen. Skapar en kort video med möjlighet till ljud.
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
HappyHorse-1.1-I2V är en modell från Alibaba som inleder en videoscen med en färdig bild. Bilden blir den första bildrutan, och texten kan ange vad som sedan händer: karaktärens rörelser, förändringar i scenen och kamerans riktning. Det passar för att ge liv åt en illustration, ett produktfoto eller ett visuellt koncept som har förberetts i förväg.
Textbeskrivningen är valfri. Om den saknas härleder modellen själv möjliga rörelser ur innehållet i den första bilden. Med en uttrycklig instruktion anger ursprungsbilden kompositionen och objektens utseende, medan orden styr hur scenen utvecklas över tid.
Alibaba framhåller bevarandet av karaktärens utseende, visuell sammanhållning, jämna rörelser och kombinationen av bild och ljud. Även stabila texter och texturer ingår bland de angivna egenskaperna. Egenskaperna beskriver modellens avsikt och innebär inte att varje pixel bevaras exakt i alla genererade bildrutor.
Det här läget använder en enda startbild. Den anger den ursprungliga scenen och utgör inte en uppsättning fristående referenser för en ny komposition. Möjligheten att ange en separat slutbildruta har inte uppgetts för just den här versionen.
JPEG, JPG, PNG och WEBP accepteras. Varje sida av indatabilden måste vara minst 300 pixlar. Tillåtet bildförhållande är från 1:2,5 till 2,5:1 och filstorleken högst 20 MB. Den färdiga videons bildförhållande följer den första bildrutan.
Längden väljs som ett heltal från 3 till 15 sekunder. Upplösningarna 480P, 720P och 1080P finns tillgängliga. Utdataformatet är MP4 med 24 bildrutor per sekund. Ljud kan skapas tillsammans med videon.
Beskrivningen kan vara på vilket språk som helst och innehålla upp till 5000 icke-kinesiska eller 2500 kinesiska tecken. Överskrids gränsen tas den överskjutande delen bort. Viktiga handlingar och rörelser bör därför beskrivas inom instruktionens gräns. Samma inledande slumpfrö kan ge liknande videor men garanterar inte att de blir identiska bildruta för bildruta.
POST /v1/videos/generationstext, imagevideo| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser happyhorse-i2v-latest | Standard— |
Fältprompt | Typstring | KravValfritt | Värden & gränser Minsta längd: 1 | Standard— |
Fältduration | Typinteger | KravValfritt | Värden & gränser Minimum: 3 Maximum: 15 Enhet: sekunder | Standard5 |
Fältresolution | Typstring | KravValfritt | Värden & gränser 480P, 720P, 1080P | Standard720P |
Fältratio | Typstring | KravStöds inte | Värden & gränser | Standard— |
Fältimage_urls | Typhttps_url|data_image_url[] | KravObligatoriskt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 1 Maximalt antal avkodade byte: 20 971 520 MIME-typer: image/jpeg, image/png, image/webp | Standard— |
first_frame_to_video · Krävs: image_urls
| Parameter | Avtal |
|---|---|
Parametermaterial_types | Avtaltext, image |
Parameterrequired | Avtalnull |
Parameteroptional_controls | Avtalnull |
Livscykel: 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
Metodernas strukturer och ID:n är exakta; leverantörens funktioner är åtskilda från att begäran tillåts.
POST /v1/videos/generationsAiloot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
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\nSpara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Bevara varje returnerad datapost och utdataindex. content_url avser endast det första; hämta varje faktisk innehållssökväg och tillgång. GET av innehåll utan index omfattar inte alla resultat.
Läs det befintliga ursprungliga jobbet; skicka aldrig en oklar sändning igen.
| Fält | Typ |
|---|---|
Fältid | Typstring |
Fältobject | Typstring |
Fältmodel | Typstring |
Fältstatus | Typstring |
Fältcontent_url | Typsigned URL |
Fältdata[] | Typsigned URL |
Fältusage | Typobject |
Fältresult_pending_check | Typboolean |
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar400 · invalid_request_error | VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde | Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa. |
Svar409 · video_not_ready | VillkorDet ursprungliga resultatinnehållet är ännu inte tillgängligt | Nästa stegKontrollera det ursprungliga returnerade ID:t och följ Retry-After. |
Svarserver_error | VillkorDet returnerade svaret anger att operationen eller resultatet behöver kontrolleras | Nästa stegSpara det ursprungliga operations- eller uppgifts-ID som returnerades, förfrågans headers och svaret. Fortsätt att läsa den ursprungliga operationen med de läsmetoder som stöds. Skicka inte skapandeförfrågan igen. |
Ailoot happyhorse-1.1-i2v, happyhorse-i2v, happyhorse-i2v-latest
Använd metodsökvägarna som visas ovan.