Source: https://ailoot.ai/models/fi/vidu-q1-reference/
Canonical: https://ailoot.ai/models/fi/vidu-q1-reference/
Language: fi

# Vidu Q1 Reference

[Markdown](https://ailoot.ai/models/fi/vidu-q1-reference/index.md) · [JSON](https://ailoot.ai/models/fi/vidu-q1-reference/facts.json)

## [Vidu Q1 Reference](https://ailoot.ai/models/fi/vidu-q1-reference/)

Vidu Q1 Reference yhdistää kirjallisen videokuvauksen valinnaisiin kuvareferensseihin ja loppukuvaan. Valitse Ailootissa rajaus, tarkkuus ja neljän tai kahdeksan sekunnin kesto.

- [**Ailoot Ultra · Video** `POST /v1/videos` `vidu-q1-reference`](https://ailoot.ai/models/fi/vidu-q1-reference/#method-0)

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

Käytä vidu-q1-reference-mallia /v1/videos-rajapinnassa kentillä model ja prompt. Pyyntö tarjoaa image-kenttään merkkijonon tai enintään kymmenen merkkijonon taulukon sekä kentät end\_image, aspect\_ratio, duration ja resolution. Valitse neljä tai kahdeksan sekuntia, 360p, 720p tai 1080p sekä rajaus 16:9, 1:1 tai 9:16.

Kuvaile kohtaus, jossa referenssin kohde pysyy tunnistettavana. Kun annat kuvia, nimeä kunkin referenssin rooli ja säilytettävät kohteen yksityiskohdat. Anna toiminnalle ja kameran ohjaukselle erilliset ohjeet ja määrittele sitten loppuasento tai rajaus. Pidä valitut kuvat, kehote ja valinnainen loppukuva pyynnön yhteydessä, jotta valmista videota voi verrata samaan aineistoon.

Lähetä otos kerran /v1/videos-rajapinnan kautta ja säilytä palautettu pyyntötunnus. Kysy saman toiminnon tilaa osoitteesta /v1/videos/{request\_id} ja tallenna sitten jokainen valmis videotuloste ja täydellinen vastaus. Arvioi koko toiminta ja lopullinen sommittelu annettua aineistoa ja tehtävänantoa vasten.

**Ailoot Ultra · Video** `POST /v1/videos` `vidu-q1-reference`

[`vidu-q1-reference`](https://ailoot.ai/models/fi/#m=vidu-q1-reference&route=Ultra&caller=vidu-q1-reference&fmt=videos)

Muu /`vidu-q1-reference`

### Aloitus

Vidu Q1 Reference yhdistää kirjallisen videokuvauksen valinnaisiin kuvareferensseihin ja loppukuvaan. Valitse Ailootissa rajaus, tarkkuus ja neljän tai kahdeksan sekunnin kesto.

Hyväksytyt syötteet

Teksti · Kuvat

Tulokset

Video

### Saatavilla Ailootissa · syötteet & menetelmät

**Ailoot Ultra · Video** `POST /v1/videos`

Syötetyypit

`text`, `image`

Tulostyypit

`video`

| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
| --- | --- | --- | --- | --- |
| Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat vidu-q1-reference Ehdot: Käytä täsmälleen tätä Ailoot-reititysvalitsinta. | Oletus— |
| Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 16:9, 1:1, 9:16 Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— |
| Kenttä`duration` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat 4, 8 Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— |
| Kenttä`end_image` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— |
| Kenttä`image` | Tyyppi`string or array<string>` | VaatimusValinnainen | Arvot & rajat Ehdot: Anna kuvan todellinen, saavutettava URL-osoite. Luettelo hyväksytään vain, jos parametrin skeema määrittelee taulukon. | Oletus— |
| Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— |
| Kenttä`resolution` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 360p, 720p, 1080p Ehdot: Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. | Oletus— |

Menetelmän parametrit ja elinkaari

| Parametri | Sopimus |
| --- | --- |
| Parametri`content_type` | Sopimusapplication/json |
| Parametri`required` | Sopimusmodel, prompt |
| Parametri`optional` | Sopimusaspect\_ratio, duration, end\_image, image, resolution |
| Parametri`material_types` | Sopimustext, image |
| Parametri`conditions` | SopimusKäytä täsmälleen tätä Ailoot-reititysvalitsinta., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Anna kuvan todellinen, saavutettava URL-osoite. Luettelo hyväksytään vain, jos parametrin skeema määrittelee taulukon., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois., Käytä valitulle mallille dokumentoitua kenttää ja lueteltuja vaihtoehtoja; jätä määrittämätön valinnainen arvo pois. |

Menetelmien aliakset: `/v1/videos/generations`

Elinkaari: `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}`

### Hinnoittelu

##### Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila

Ei määritetty Kun nopea tila on valittu

Flex-tila

Ei määritetty Kun flex-tila on valittu

Päättelyn enimmäisteho

Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

#### Arvioidut vertailuhinnat

#### Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

| Asetukset | Hinnasto | Ennustettu määrä | Laskutusmäärä | Veloitus |
| --- | --- | --- | --- | --- |
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusmäärä— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten **—** / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten **—** / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten **—** / 1K tokenia |
| AsetuksetPyyntöä kohden | Hinnasto— | Ennustettu määrä— | Laskutusmääräyksi pyyntö | Veloitus Syöte · Arvio vain vertailua varten **$0.8** pyyntöä kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusmäärä— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$0.8** arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. [Varauksen ja lopullisen veloituksen toiminta →](https://ailoot.ai/docs/fi/billing/reserve/)

### Esimerkkipyynnöt

#### Ailoot Ultra · Video

curl · luo vain kerran ja säilytä koko tulosLue alkuperäinen tehtäväTallenna kaikki valmistuneet omat tuotokset

```bash
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-q1-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.
```

```bash
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
```

```bash
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
```

### Vastaanota ja tallenna tulokset

#### 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}`

##### Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.

Säilytä koko vastaus ja otsakkeet, alkuperäiset tunnisteet, jokainen todellinen tulos sekä kaikki käyttö- ja veloitustietokentät. Tallenna jokainen yksilöllinen käyttäjälle kuuluva aineisto ja säilytä kaikki siihen viittaavat roolit.

##### Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu julkinen tehtävän tai operaation id ja kaikki otsakkeet. Lue vain alkuperäisen tehtävän tietoja; unknown tai result\_pending\_check ei oikeuta uuteen luontipyyntöön.

Vastauksen kentät

| Kenttä | Tyyppi |
| --- | --- |
| Kenttä`id` | Tyyppistring |
| Kenttä`polling_url` | Tyyppistring |
| Kenttä`provider_task_id` | Tyyppistring |
| Kenttä`task_id` | Tyyppistring |
| Kenttä`status` | Tyyppistring |
| Kenttä`video_url` | Tyyppistring |

Virheet ja seuraavat vaiheet

| Vastaus | Ehto | Seuraava vaihe |
| --- | --- | --- |
| Vastaus400 · `invalid_request_error` | EhtoPakollinen kenttä, mallivalitsin, tyyppi tai syötteen esitysmuoto on virheellinen. | Seuraava vaiheTarkista palautetut validointitiedot ennen erillisen pyynnön valmistelua. |
| Vastaus`` | EhtoAlkuperäinen pyyntö tai tulos on tuntematon tai vaatii tarkistuksen. | Seuraava vaiheSäilytä alkuperäiset tunnisteet ja otsakkeet; lue vain tuettuja tila- tai kirjastotietueita. Älä lähetä luontipyyntöä uudelleen. |

### Aliakset

#### Mallin aliakset

**Ailoot Ultra** [`vidu-q1-reference`](https://ailoot.ai/models/fi/#m=vidu-q1-reference&route=Ultra&caller=vidu-q1-reference&fmt=videos)

#### Menetelmäpolkujen aliakset

`/v1/videos/generations`

#### Liittyvät kutsujan ID:t

[`vidu-q1-reference`](https://ailoot.ai/models/fi/#m=vidu-q1-reference&route=Ultra&caller=vidu-q1-reference&fmt=videos)

FAQ · Vidu Q1 Reference

Mitä syötteitä ja tuloksia on saatavilla?

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

Mitä kenttiä pyyntö käyttää?

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

Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi.

## Yritys ja sen projektisalkku

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

## Osta tokenit alennuksella.

Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista.

Tilaus

Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten.

Kampanjakoodi jopa 50%

Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan.

Kulut historiassa

Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle.

[Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/)

## Yhdistä API tuotteeseen, jonka myyt.

SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi.

Kaupallinen sovellus

Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin.

Jälleenmyyjälisenssi

Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot.

Asiakirjat verkkosivustolla

Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä.

[Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.