happyhorse-1.1-t2v
Rövid, hangos videót készítő modell szöveges leírás alapján. Olyan jelenetekhez alkalmas, amelyekben a mozgást, a kompozíciót és a vizuális stílust szavak határozzák meg.
- Ailoot · Videó
POST /v1/videos/generationshappyhorse-1.1-t2v - Ailoot · Videó
POST /v1/videos/generationshappyhorse-t2v - Ailoot · Videó
POST /v1/videos/generationshappyhorse-t2v-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-T2V az Alibaba modellje rövid videojelenetek szövegből történő létrehozásához. A leírás adja meg a szereplőket, a cselekményt, a környezetet és a vizuális megjelenítést; ehhez a módhoz nincs szükség kiinduló képre. A modell elkészíti a képsorokat, és kísérőhangot is generálhat.
A gyártó a jelenet jelentésének megértését, a filmszerű beállításokat és a kifejező mozgást emeli ki. A szöveg meghatározhatja a hangulatot, a szereplő cselekedeteit, az objektumok viselkedését és a fizikai dinamikát. Így a jelenet a kívánt történések köré építhető, majd a világítással, a nézőponttal és a kameramozgással tovább alakítható.
Jelenetbeállítás szavakkal
Az utasítás kötelező, és bármilyen nyelvű lehet. Legfeljebb 5000 nem kínai vagy 2500 kínai karaktert tartalmazhat; a többlet levágásra kerül. A cselekményt, a környezetet és a fontos vizuális részleteket ezen a kereten belül kell leírni. Ez a megközelítés teret hagy a modellnek egy új jelenet létrehozására, ahelyett hogy kész első képkockát adna meg.
Ebben a módban a szöveg a fő irányító bemenet. Egy szereplő vagy tárgy konkrét megjelenése szavakkal írható le; a megjelenést külön képekkel megadó lehetőség a család egy másik módjához tartozik. Az eredmény a teljes utasítástól függ, ezért az azonos kezdő véletlenmag segíthet hasonló változatokat készíteni, de nem garantálja a pontos megismétlést.
Videó és kísérőhang
A HappyHorse-1.1 videóinak időtartama 3 és 15 másodperc közötti egész számként választható meg. A támogatott felbontások: 480P, 720P és 1080P. Az elkészült fájl MP4 formátumú, másodpercenként 24 képkockával. A modell a képpel együtt hangot is generálhat, a kísérőhangot a jelenet történéseihez kapcsolva.
A képarány előre megadható. Az elérhető arányok: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21 és 21:9 — a széles, filmszerű képtől a nyújtott, álló videóig. A felbontás, a formátum és az időtartam határozza meg az eredmény méreteit; a tartalmat és a mozgást a szöveg adja meg.
Ez a változat új jelenet készítésére szolgál egy szavakban megfogalmazott elképzelésből. Rövid epizódhoz, vizuális ötlethez vagy hangulatos videóhoz alkalmas, amelynek beállításait szövegben kell megadni.
Ailoot · Videó POST /v1/videos/generations happyhorse-1.1-t2v
happyhorse-1.1-t2vhappyhorse-1.1-t2vhappyhorse-t2vhappyhorse-t2v-latest
Kezdő lépések
Rövid, hangos videót készítő modell szöveges leírás alapján. Olyan jelenetekhez alkalmas, amelyekben a mozgást, a kompozíciót és a vizuális stílust szavak határozzák meg.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Videó POST /v1/videos/generations
- Bemenet
text- 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-t2v | 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ényOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 0 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
Szövegből videó · Kötelező: prompt
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt |
Paramétermaterial_types | Szerződéstext |
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{"max_count":0} |
É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_PROMPT_FILE:?Set your actual UTF-8 scene brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-1.1-t2v", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
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
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
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-t2v, happyhorse-t2v, happyhorse-t2v-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-t2v
happyhorse-t2vhappyhorse-1.1-t2vhappyhorse-t2vhappyhorse-t2v-latest
Kezdő lépések
Rövid, hangos videót készítő modell szöveges leírás alapján. Olyan jelenetekhez alkalmas, amelyekben a mozgást, a kompozíciót és a vizuális stílust szavak határozzák meg.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Videó POST /v1/videos/generations
- Bemenet
text- 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-t2v | 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ényOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 0 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
Szövegből videó · Kötelező: prompt
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext |
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_PROMPT_FILE:?Set your actual UTF-8 scene brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-t2v", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
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
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
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-t2v, happyhorse-t2v, happyhorse-t2v-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-t2v-latest
happyhorse-t2v-latesthappyhorse-1.1-t2vhappyhorse-t2vhappyhorse-t2v-latest
Kezdő lépések
Rövid, hangos videót készítő modell szöveges leírás alapján. Olyan jelenetekhez alkalmas, amelyekben a mozgást, a kompozíciót és a vizuális stílust szavak határozzák meg.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot · Videó POST /v1/videos/generations
- Bemenet
text- 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-t2v-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ényOpcionális | Értékek és korlátok Minimális elemszám: 0 Maximális elemszám: 0 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
Szövegből videó · Kötelező: prompt
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétermaterial_types | Szerződéstext |
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_PROMPT_FILE:?Set your actual UTF-8 scene brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "happyhorse-t2v-latest", "prompt": "", "duration": 5, "resolution": "720P", "ratio": "16:9"}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
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
print(json.dumps(json.loads(Path("result.json").read_text()),ensure_ascii=False,indent=2))
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-t2v, happyhorse-t2v, happyhorse-t2v-latest
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · happyhorse-1.1-t2v
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos/generations·happyhorse-1.1-t2v:text→videoPOST /v1/videos/generations·happyhorse-t2v:text→videoPOST /v1/videos/generations·happyhorse-t2v-latest:text→video- Mely mezőket használja a kérés?
POST /v1/videos/generations·happyhorse-1.1-t2v:model,prompt,duration,resolution,ratio,image_urlsPOST /v1/videos/generations·happyhorse-t2v:model,prompt,duration,resolution,ratio,image_urlsPOST /v1/videos/generations·happyhorse-t2v-latest:model,prompt,duration,resolution,ratio,image_urls- Milyen korlátok érvényesek?
POST /v1/videos/generations·happyhorse-1.1-t2v:duration.minimum:3;duration.maximum:15POST /v1/videos/generations·happyhorse-t2v:duration.minimum:3;duration.maximum:15POST /v1/videos/generations·happyhorse-t2v-latest:duration.minimum:3;duration.maximum:15