happyhorse-1.1-r2v
Referenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
- Ailoot · Videó
POST /v1/videos/generationshappyhorse-1.1-r2v - Ailoot · Videó
POST /v1/videos/generationshappyhorse-r2v - Ailoot · Videó
POST /v1/videos/generationshappyhorse-r2v-latest
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
A HappyHorse-1.1-R2V referenciaképek és szöveges utasítás alapján készít új videojelenetet. Az Alibaba a felismerhető szereplők, objektumok és vizuális stílus megőrzésére tervezte a modellt a mozgás generálása során. A referenciák a jelenet tartalmát és megjelenését határozzák meg, a szöveg pedig azt írja le, hogyan lépjenek kölcsönhatásba ezek az elemek.
A vizuális minták szerepe
Egy és kilenc közötti számú kép használható. Megadhatják a szereplőt, a tárgyat, a környezetet vagy a művészi megjelenítést. A leírásban hivatkozni lehet a referencia sorszámára és a rajta látható konkrét objektumra, így a vizuális anyag összekapcsolható a cselekmény megfelelő részével. Ez különösen hasznos, ha több kép elemeit kell egy kompozícióban egyesíteni.
A kezdőképkockás móddal szemben a referenciák itt az új jelenet tartalmának támpontjai. A szöveges utasítás kötelező: összekapcsolja az objektumok megjelenését a cselekménnyel, a kameramozgással és a teljes jelenet beállításával. A gyártó a vizuális összhangot és a filmszerű mozgást emeli ki; az eredmény generálás útján jön létre, nem a kiinduló képek összevágásával.
JPEG, JPG, PNG és WEBP fogadható el, egyenként legfeljebb 20 MB méretben. A kép rövidebb oldalának legalább 400 pixelesnek kell lennie; 720P vagy nagyobb felbontású anyagok ajánlottak. E mód bemenete kifejezetten képekből és szövegből áll.
Időtartam, képarány és hang
Az eredmény MP4 formátumban, másodpercenként 24 képkockával kerül mentésre. Az időtartam 3 és 15 másodperc közötti egész számként adható meg. A felbontás 480P, 720P vagy 1080P lehet; hang generálása is támogatott.
Fekvő, álló és négyzetes képarányok érhetők el: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9. A formátum kiválasztásával előre meghatározható az új jelenet kompozíciós tere.
A szöveg bármilyen nyelvű lehet. A korlát 5000 nem kínai vagy 2500 kínai karakter, a többlet levágásra kerül. A referenciák legfontosabb szerepeinek, a cselekménynek és a mozgásnak ezen a kereten belül kell elférniük. A kezdő véletlenmag befolyásolhatja a változatok hasonlóságát, de nem garantálja egy adott videó pontos megismétlését.
Ailoot · Videó POST /v1/videos/generations happyhorse-1.1-r2v
happyhorse-1.1-r2vhappyhorse-1.1-r2vhappyhorse-r2vhappyhorse-r2v-latest
Kezdő lépések
Referenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Videó POST /v1/videos/generations
- Bemenet
text,image- Kimenet
video- Kimeneti formátum
- mp4
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok happyhorse-1.1-r2v | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett5 |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480P, 720P, 1080P | Alapértelmezett720P |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Alapértelmezett16:9 |
Mezőimage_urls | Típushttps_url|data_image_url[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 9 Maximális dekódolt bájtszám: 20 971 520 MIME-típusok: image/jpeg, image/png, image/webp | Alapértelmezett— |
Bemeneti anyagok kombinációi
reference_images_to_video · Kötelező: prompt, image_urls
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, image_urls |
Paramétermaterial_types | Szerződéstext, image |
Paraméteroptional | Szerződésduration, resolution, ratio |
Paraméterduration_integer_range | Szerződés3, 15 |
Paraméterdefault_duration | Szerződés5 |
Paraméterresolution | Szerződés480P, 720P, 1080P |
Paraméterdefault_resolution | Szerződés720P |
Paraméterratio | Szerződés16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 |
Paraméterratio_must_omit | Szerződésfalse |
Paraméterimage_urls | Szerződés{"min_count":1,"max_count":9,"schemes":["https","raszteres képadatok base64 formában"],"max_data_image_bytes":20971520} |
Életciklus: 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
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
Díjcsomagok
Ailoot-metódusok díjai
POST /v1/videos/generations- Kimenet
- 0,18 USD másodpercenként, 1080p felbontáson
- Kimenet
- 0,07 USD másodpercenként, 480p felbontáson
- Kimenet
- 0,14 USD másodpercenként, 720p felbontáson
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot · Videó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"
export AILOOT_IMAGE_URLS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-1.1-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')
from urllib.parse import urlsplit
f=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")
urls=json.loads(f.read_text())
if not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")
for u in urls:
z=urlsplit(u) if isinstance(u,str) else None
if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")
p["image_urls"]=urls
p["ratio"]="16:9"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
print(json.dumps(r))
PY_RESULT
Eredmények fogadása és mentése
Ailoot · Videó
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Mentsen minden elkészült médiafájlt
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if 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")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
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")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
További tartalomlekérések
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizzen meg minden visszaadott adatelemet és kimeneti indexet. A content_url csak az elsőt jelöli; kérje le az összes tényleges tartalomútvonalat és médiaállományt. Az index nélküli GET content nem adja vissza az összes kimenetet.
Ha az eredeti választ ellenőrizni kell
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőobject | Típusstring |
Mezőmodel | Típusstring |
Mezőstatus | Típusstring |
Mezőcontent_url | Típussigned URL |
Meződata[] | Típussigned URL |
Mezőusage | Típusobject |
Mezőresult_pending_check | Típusboolean |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
Ailoot · Videó POST /v1/videos/generations happyhorse-r2v
happyhorse-r2vhappyhorse-1.1-r2vhappyhorse-r2vhappyhorse-r2v-latest
Kezdő lépések
Referenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Videó POST /v1/videos/generations
- Bemenet
text,image- Kimenet
video- Kimeneti formátum
- mp4
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok happyhorse-r2v | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett5 |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480P, 720P, 1080P | Alapértelmezett720P |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Alapértelmezett16:9 |
Mezőimage_urls | Típushttps_url|data_image_url[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 9 Maximális dekódolt bájtszám: 20 971 520 MIME-típusok: image/jpeg, image/png, image/webp | Alapértelmezett— |
Bemeneti anyagok kombinációi
reference_images_to_video · Kötelező: prompt, image_urls
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext, image |
Paraméterrequired | Szerződésnull |
Paraméteroptional_controls | Szerződésnull |
Életciklus: 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
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
Díjcsomagok
Ailoot-metódusok díjai
POST /v1/videos/generations- Kimenet
- 0,18 USD másodpercenként, 1080p felbontáson
- Kimenet
- 0,07 USD másodpercenként, 480p felbontáson
- Kimenet
- 0,14 USD másodpercenként, 720p felbontáson
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot · Videó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"
export AILOOT_IMAGE_URLS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-r2v", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')
from urllib.parse import urlsplit
f=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")
urls=json.loads(f.read_text())
if not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")
for u in urls:
z=urlsplit(u) if isinstance(u,str) else None
if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")
p["image_urls"]=urls
p["ratio"]="16:9"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
print(json.dumps(r))
PY_RESULT
Eredmények fogadása és mentése
Ailoot · Videó
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Mentsen minden elkészült médiafájlt
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if 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")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
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")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
További tartalomlekérések
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizzen meg minden visszaadott adatelemet és kimeneti indexet. A content_url csak az elsőt jelöli; kérje le az összes tényleges tartalomútvonalat és médiaállományt. Az index nélküli GET content nem adja vissza az összes kimenetet.
Ha az eredeti választ ellenőrizni kell
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőobject | Típusstring |
Mezőmodel | Típusstring |
Mezőstatus | Típusstring |
Mezőcontent_url | Típussigned URL |
Meződata[] | Típussigned URL |
Mezőusage | Típusobject |
Mezőresult_pending_check | Típusboolean |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
Ailoot · Videó POST /v1/videos/generations happyhorse-r2v-latest
happyhorse-r2v-latesthappyhorse-1.1-r2vhappyhorse-r2vhappyhorse-r2v-latest
Kezdő lépések
Referenciaképek és szöveges forgatókönyv alapján videót generáló modell. Segít megőrizni a szereplők megjelenését, a tárgyakat és a vizuális stílust egy új jelenetben.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Videó POST /v1/videos/generations
- Bemenet
text,image- Kimenet
video- Kimeneti formátum
- mp4
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok happyhorse-r2v-latest | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Minimális hossz: 1 | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményOpcionális | Értékek és korlátok Minimum: 3 Maximum: 15 Egység: másodperc | Alapértelmezett5 |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 480P, 720P, 1080P | Alapértelmezett720P |
Mezőratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 | Alapértelmezett16:9 |
Mezőimage_urls | Típushttps_url|data_image_url[] | KövetelményKötelező | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 9 Maximális dekódolt bájtszám: 20 971 520 MIME-típusok: image/jpeg, image/png, image/webp | Alapértelmezett— |
Bemeneti anyagok kombinációi
reference_images_to_video · Kötelező: prompt, image_urls
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext, image |
Paraméterrequired | Szerződésnull |
Paraméteroptional_controls | Szerződésnull |
Életciklus: 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
A metódusok szerkezete és azonosítói pontosak; a beszállítói képesség különbözik a kérelmek befogadásától.
Díjcsomagok
Ailoot-metódusok díjai
POST /v1/videos/generations- Kimenet
- 0,18 USD másodpercenként, 1080p felbontáson
- Kimenet
- 0,07 USD másodpercenként, 480p felbontáson
- Kimenet
- 0,14 USD másodpercenként, 720p felbontáson
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
Példakérések
Ailoot · Videó
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URLS_FILE:?Set a JSON file containing your actual reference-image URLs}"
export AILOOT_IMAGE_URLS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-r2v-latest", "prompt": "The subject walks slowly toward the camera.", "duration": 5, "resolution": "720P"}')
from urllib.parse import urlsplit
f=Path(os.environ["AILOOT_IMAGE_URLS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual reference URL JSON file")
urls=json.loads(f.read_text())
if not isinstance(urls,list) or not 1<=len(urls)<=9:raise SystemExit("Provide one to nine reference-image URLs")
for u in urls:
z=urlsplit(u) if isinstance(u,str) else None
if not z or z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Each reference must be an actual HTTPS image URL")
p["image_urls"]=urls
p["ratio"]="16:9"
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
print(json.dumps(r))
PY_RESULT
Eredmények fogadása és mentése
Ailoot · Videó
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Mentsen minden elkészült médiafájlt
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if 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")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
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")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
További tartalomlekérések
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/generations/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizzen meg minden visszaadott adatelemet és kimeneti indexet. A content_url csak az elsőt jelöli; kérje le az összes tényleges tartalomútvonalat és médiaállományt. Az index nélküli GET content nem adja vissza az összes kimenetet.
Ha az eredeti választ ellenőrizni kell
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
Válaszmezők
| Mező | Típus |
|---|---|
Mezőid | Típusstring |
Mezőobject | Típusstring |
Mezőmodel | Típusstring |
Mezőstatus | Típusstring |
Mezőcontent_url | Típussigned URL |
Meződata[] | Típussigned URL |
Mezőusage | Típusobject |
Mezőresult_pending_check | Típusboolean |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételÉrvénytelen kötelező mezők, az anyag érvénytelen reprezentációja vagy érvénytelen paraméterérték | Következő lépésJavítsa a jelzett mezőket egy új létrehozási kérés előtt. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Álnevek
Modell álnevei
Ailoot happyhorse-1.1-r2v, happyhorse-r2v, happyhorse-r2v-latest
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · happyhorse-1.1-r2v
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos/generations·happyhorse-1.1-r2v:text,image→videoPOST /v1/videos/generations·happyhorse-r2v:text,image→videoPOST /v1/videos/generations·happyhorse-r2v-latest:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos/generations·happyhorse-1.1-r2v:model,prompt,duration,resolution,ratio,image_urlsPOST /v1/videos/generations·happyhorse-r2v:model,prompt,duration,resolution,ratio,image_urlsPOST /v1/videos/generations·happyhorse-r2v-latest:model,prompt,duration,resolution,ratio,image_urls- Milyen korlátok érvényesek?
POST /v1/videos/generations·happyhorse-1.1-r2v:duration.minimum:3;duration.maximum:15POST /v1/videos/generations·happyhorse-r2v:duration.minimum:3;duration.maximum:15POST /v1/videos/generations·happyhorse-r2v-latest:duration.minimum:3;duration.maximum:15