modely

vidu-q2-reference

Markdown · JSON

vidu-q2-reference

Vidu Q2 Reference spojuje písemné zadání videa s volitelnými obrazovými referencemi a koncovým obrázkem. Prostřednictvím Ailoot zvolte rámování, rozlišení a délku čtyři nebo osm sekund.

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

Použijte vidu-q2-reference s poli model a prompt na /v1/videos. Požadavek zpřístupňuje image jako řetězec nebo pole až deseti řetězců, end_image, aspect_ratio, duration a resolution. Zvolte čtyři nebo osm sekund, 360p, 720p nebo 1080p a rámování 16:9, 1:1 nebo 9:16.

Popište pohyb vedený referencí a konečnou kompozici. Při dodání obrázků určete roli každé reference a detaily objektu k zachování. Akci a pokyny pro kameru zadejte odděleně a poté definujte konečnou pózu nebo rámování. Vybrané obrázky, prompt a volitelný koncový obrázek uchovejte s požadavkem, aby bylo možné dokončené video porovnat se stejnými podklady.

Odešlete záběr jednou prostřednictvím /v1/videos a uchovejte vrácené ID požadavku. Na stav stejné operace se dotazujte přes /v1/videos/{request_id} a poté uložte každý dokončený video výstup i celou odpověď. Celou akci a konečnou kompozici posuďte podle dodaných podkladů a zadání.

Ailoot Ultra · Video POST /v1/videos vidu-q2-reference

vidu-q2-reference

Ostatní /vidu-q2-reference

Úvod

Vidu Q2 Reference spojuje písemné zadání videa s volitelnými obrazovými referencemi a koncovým obrázkem. Prostřednictvím Ailoot zvolte rámování, rozlišení a délku čtyři nebo osm sekund.

Přijímané vstupy
Text · Obrázky
Výsledky
Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Video POST /v1/videos
Vstup
text, image
Výstup
video
PoleTypPožadavekHodnoty a limityVýchozí
PolemodelTypstringPožadavekPovinnéHodnoty a limity
vidu-q2-reference
Podmínky: Použijte přesně tento směrovací selektor Ailoot.
Výchozí—
Poleaspect_ratioTypstringPožadavekVolitelnéHodnoty a limity
16:9, 1:1, 9:16
Podmínky: Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte.
Výchozí—
PoledurationTypintegerPožadavekVolitelnéHodnoty a limity
4, 8
Podmínky: Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte.
Výchozí—
Poleend_imageTypstringPožadavekVolitelnéHodnoty a limity
Podmínky: Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte.
Výchozí—
PoleimageTypstring or array<string>PožadavekVolitelnéHodnoty a limity
Podmínky: Zadejte skutečnou dostupnou URL obrázku. Seznam je přijatelný pouze tehdy, když schéma parametru uvádí pole.
Výchozí—
PolepromptTypstringPožadavekPovinnéHodnoty a limity
Podmínky: Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte.
Výchozí—
PoleresolutionTypstringPožadavekVolitelnéHodnoty a limity
360p, 720p, 1080p
Podmínky: Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte.
Výchozí—
Parametry a životní cyklus metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt
ParametroptionalKontraktaspect_ratio, duration, end_image, image, resolution
Parametrmaterial_typesKontrakttext, image
ParametrconditionsKontraktPoužijte přesně tento směrovací selektor Ailoot., Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte., Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte., Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte., Zadejte skutečnou dostupnou URL obrázku. Seznam je přijatelný pouze tehdy, když schéma parametru uvádí pole., Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte., Použijte dokumentované pole pro vybraný model a uvedené možnosti; nezadanou volitelnou hodnotu vynechte.

Aliasy metody: /v1/videos/generations

Životní cyklus: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Tarify

Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim
Neuvedeno Při výběru rychlého režimu
Režim flex
Neuvedeno Při výběru režimu flex
Maximální intenzita uvažování
Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

Odhadované sazby pro srovnání

Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

KonfiguraceTabulka sazebPředpokládané množstvíPoplatek
KonfiguraceZákladní sazby za tokenyTabulka sazebZákladní sazbaPředpokládané množství—Poplatek
Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů
Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů
Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů
KonfiguraceOdhadovaná cena generováníTabulka sazeb—Předpokládané množstvíodhad pro jedno generováníPoplatek
Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.2 odhad před generováním

Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování.

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →

Příklady požadavků

Ailoot Ultra · Video

curl · vytvořte jednou a uchovejte úplný výsledekNačtěte původní úlohuUložte každý dokončený výstup, který vlastníte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "vidu-q2-reference", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
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 \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Přijímání a ukládání výsledků

Ailoot Ultra · Video

  • GET /v1/videos/{request_id}
  • GET /v1/videos/generations/{request_id}
  • GET /v1/videos/{request_id}/content
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Uchovejte celou odpověď a hlavičky, původní identifikátory, každý skutečný výstup a všechna pole využití a účtování. Uložte každý jedinečný soubor spravovaný službou a zachovejte každou roli, která na něj odkazuje.

Pokud je nutné ověřit původní odpověď

Uchovejte vrácené veřejné id úlohy nebo operace a všechny hlavičky. Načítejte pouze původní úlohu; unknown ani result_pending_check neopravňují k dalšímu vytvoření.

Pole odpovědi
PoleTyp
PoleidTypstring
Polepolling_urlTypstring
Poleprovider_task_idTypstring
Poletask_idTypstring
PolestatusTypstring
Polevideo_urlTypstring
Chyby a další kroky
OdpověďPodmínkaDalší krok
Odpověď400 · invalid_request_errorPodmínkaPovinné pole, selektor modelu, typ nebo podoba vstupu jsou neplatné.Další krokPřed přípravou samostatného požadavku si prohlédněte vrácené podrobnosti validace.
OdpověďPodmínkaPůvodní požadavek nebo výsledek je neznámý nebo vyžaduje kontrolu.Další krokZachovejte původní identifikátory a hlavičky; čtěte pouze podporované záznamy o stavu nebo záznamy knihovny. Požadavek na vytvoření znovu neodesílejte.

Aliasy

Aliasy modelu

Ailoot Ultra vidu-q2-reference

Aliasy cest metod

/v1/videos/generations

Související ID modelů

vidu-q2-reference

FAQ · vidu-q2-reference
Jaké vstupy a výsledky jsou dostupné?

POST /v1/videos · vidu-q2-reference: text, image → video

Jaká pole požadavek používá?

POST /v1/videos · vidu-q2-reference: model, aspect_ratio, duration, end_image, image, prompt, resolution

Další podrobnosti

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné
Pro pravidelné požadavky vyberte tarif se slevou.
Promo kód až 50%
Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.
Výdaje v historii
U každého požadavku se uloží model, tokeny a částka.

Vybrat předplatné · Zobrazit ceny modelů

Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace
Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.
Licence pro přeprodejce
Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.
Dokumenty na webu
Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

Požádat o licenci přeprodejce · Nabídka a licenční smlouva