Source: https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/
Canonical: https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/
Language: fi

# ByteDance: Seedance 2.0 Fast

[Markdown](https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/index.md) · [JSON](https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/facts.json)

## [ByteDance: Seedance 2.0 Fast](https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/)

ByteDance Seedance 2.0 Fast luo audiovisuaalisia kohtauksia tekstistä sekä kuva-, video- ja ääniviitteistä. Nopeuteen suunnattu versio tukee liikkeen ja tyylin siirtoa, videomuokkauksia ja jatkamista eteen- tai taaksepäin dokumentoiduilla 480p- ja 720p-tulosteilla.

- [**Ailoot Ultra · Video** `POST /v1/videos` `bytedance/seedance-2.0-fast`](https://ailoot.ai/models/fi/bytedance-seedance-2-0-fast/#method-0)

Tietoa mallista

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

Seedance 2.0 Fast on ByteDance Seedin nopeuteen suunnattu Seedance 2.0 -perheen versio. Se tukee videon ja äänen yhteisgenerointia sekä tekstistä, kuvista, videosta ja äänestä rakennettua multimodaalista tehtävänantoa. Luoviin kykyihin kuuluvat uudet viitevetoiset kohtaukset, olemassa olevan aineiston muokkaukset ja kohtauksen jatkaminen. Dokumentoidut tulostetasot ovat 480p ja 720p.

#### Multimodaalinen viite: aineiston roolien määrittäminen

Kuva voi antaa hahmon, tuotteen, sommittelun tai visuaalisen käsittelyn. Viitevideo voi antaa toiminnan, kameraliikkeen tai tehosteen. Viiteääni voi antaa puheäänen sointivärin, musiikillisen melodian tai vuoropuhelusisällön. Selitä, minkä osan kustakin lähteestä haluat siirtää uuteen kohtaukseen; viite on hyödyllisempi, kun sillä on tietty luova rooli.

Esimerkiksi: ”Käytä Image 1:n keraamista lamppua tuotteena. Seuraa Video 1:n hidasta kameran kiertoa mutta sijoita lamppu rauhalliseen lukunurkkaukseen. Käytä Audio 1:tä musiikilliseen tunnelmaan.” Tarkoitettu tulos on uusi kohtaus, joka yhdistää valitun ulkoasun, liikkeen ja äänisuunnan, ei kaikkien viiteyksityiskohtien määrittelemätön jäljittely.

Dokumentoidut yhdistelmät sisältävät kuvat ja äänen, kuvat ja videon, videon ja äänen sekä kaikki kolme yhdessä. Pelkkää tekstiä ja ääntä tai pelkkää äänisyötettä ei tueta. Malli tukee myös tekstistä videoksi -tilaa ja kuvapohjaista generointia ensimmäisestä ruudusta tai ensimmäisen ja viimeisen ruudun parista. Kun tarkka päätepiste on tehtävänannon ytimessä, käytä erillistä päätepistetyönkulkua; viitekuvan kuvaaminen päätepisteeksi omni-viitekehotteessa on epäsuoraa ohjausta.

#### Olemassa olevan videon muokkaaminen

Malli voi lisätä, poistaa tai muokata elementtejä, korvata kohteen ja piirtää uudelleen tai korjata kohtauksen osia. Määritä lähdevideo, muutettava esine ja säilytettävät elementit. Kuvaa lisäykselle esiintymispaikka ja -aika. Tunnista poistettava esine johdonmukaisesti koko leikkeessä.

Käytännön muokkaustehtävänanto voi korvata esittelyn tavallisen pullon Image 1:n pullolla ja pyytää säilyttämään Video 1:n käden liikkeen, taustan ja kameraradan. Tarkista sekä korvaus että vakaiksi tarkoitetut alueet. Selkeät säilytysohjeet tekevät muokkauksesta helpommin arvioitavan kuin yleinen pyyntö ”parantaa” aineistoa.

#### Leikkeiden jatkaminen ja yhdistäminen

Seedance 2.0 Fast tukee jatkamista eteen- tai taaksepäin sekä kahden tai kolmen leikkeen yhdistämistä generoiduilla siirtymillä. Kerro jatkossa, tapahtuuko uusi toiminta annetun videon edellä vai jälkeen, ja kuvaa toiminta. Anna yhdistämisessä leikkeet tarkoitetussa järjestyksessä ja selitä niitä yhdistävä visuaalinen tapahtuma.

Yksinkertainen jatko palauttaa yleensä alkuperäisen aineiston ympärille kehitetyn uuden jatkon sen sijaan, että koko lähdeleikkeen toistaminen oletettaisiin. Jos tulosteen tulee sisältää alkuperäinen segmentti, kerro se tehtävänannossa. Kahden tai kolmen videon siirtymää täytettäessä dokumentoitu työnkulku voi yhdistää alkuperäistä ja uutta generoitua sisältöä. Tämä auttaa yhdistämään laajan tuotenäkymän yksityiskohtaotokseen tarkoituksellisella kameraliikkeellä.

#### Tuloste ja versioiden erot

Dokumentoitu Fast-tuloste on MP4 nopeudella 24 fps, 480p- tai 720p-tarkkuudella, 8-bittisellä värisyvyydellä ja 4–15 sekunnin leikkeinä. Tuetut suhteet ovat 21:9, 16:9, 4:3, 1:1, 3:4 ja 9:16. Tavallinen Seedance 2.0 -versio luettelee erikseen 1080p- ja 4K-tulosteet; ne eivät kuulu Fast-määritykseen. 2.0-perhe tukee viimeisen generoidun ruudun palauttamista mutta ei erillistä Draft-esikatselutilaa.

Äänen voi generoida aineiston kanssa tai jättää pois hiljaista leikettä varten. Generoitu ääni on mono. Dokumentoidut kehotekielet sisältävät englannin, espanjan, indonesian, portugalin ja japanin. Pidä puhuttu kieli yhtenäisenä vuoropuhelussa; opas neuvoo välttämään kielten sekoittamista erisnimiä lukuun ottamatta. Nimeä puhutun kohtauksen puhuja ja sijoita repliikki lainausmerkkeihin, määritä sitten esitys ja olennaiset äänitehosteet. Sovita vaadittu esitys valittuun leikepituuteen.

#### Viitteiden valmistelu ja syöterajojen huomiointi

Dokumentoidut viiterajat ovat enintään yhdeksän kuvaa, kolme videota ja kolme äänileikettä. Todellisia ihmiskasvoja sisältäviä suoria viitekuva- tai videolatauksia ei hyväksytä tässä dokumentoidussa valmistajaprofiilissa; muotokuvatyö käyttää sen tuettua muotokuva-aineistotyönkulkua. Jokaisen video- tai äänileikkeen tulee olla 2–15 sekuntia pitkä; videoiden yhteiskesto on enintään 15 sekuntia ja äänien yhteiskesto erikseen enintään 15 sekuntia. Videoviitteet käyttävät MP4:ää tai MOV:ia nopeudella 24–60 fps eivätkä saa ylittää 200 MB:tä kukin. Ääniviitteet käyttävät WAV:ia tai MP3:a eivätkä saa ylittää 15 MB:tä kukin. Luetellut kuvamuodot ovat JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC ja HEIF. Kuvien tulee olla kukin alle 30 MB; pyynnön rungon kokonaisraja on 64 MB. Dokumentoidussa viitesyöteprofiilissa kuvan leveyden ja korkeuden on oltava aidosti välillä 300–6 000 pikseliä ja leveyden suhteen korkeuteen aidosti välillä 0.4–2.5. Viitevideot sallivat kussakin suunnassa 300–6 000 pikseliä ja suhteet 0.4–2.5 rajat mukaan lukien, kokonaispikselimäärällä 407 696–8 295 044. MP4- tai MOV-videot käyttävät H.264/AVC- tai H.265/HEVC-videota ja AAC- tai MP3-ääntä.

Järjestä aineistot ja viittaa niihin johdonmukaisesti nimillä Image 1, Video 1 tai Audio 1. Käytä näkyvän kohteen nimeä tai erottavaa piirrettä aineistonumeron lisäksi. Sovita päätepistekuvien rajaus videon tarkoitettuun suhteeseen, sillä ristiriita voi rajata kuvan tai aiheuttaa häiritsevän rajausmuutoksen. Keskity tehtävänannossa siirrettäviin piirteisiin, generoitavaan tapahtumaan ja säilytettäviin asioihin; pitkä kehote voi hajottaa ohjeet ja jättää sivuseikkoja ratkaisematta.

#### Otossuunnittelu, teksti ja tunnetut käyttäytymiset

Jäsennä monimutkainen tehtävänanto muotoon Shot 1, Shot 2 ja Shot 3 ja anna jokaiselle selkeä kohde, toiminta, sijainti ja ääni. Opas suosittelee yhtä kameraliikettä otosta kohden ja kertoo tarkkojen otoskohtaisten aikaleimojen olevan epävakaita. Anna jokaiselle hahmolle vakaa tunniste ja muutama erottava piirre; käytä kasvoidentiteetin ollessa tärkeä erillistä selkeää kasvokuvaa ja kokovartaloviitettä yhdistetyn hahmokääntöarkin sijaan.

Malli voi generoida tavallista tekstiä, kuten iskulauseita, tekstityksiä ja puhekuplia, joiden väriä, tyyliä, sijaintia ja sisääntuloa voidaan ohjata. Tavallisia merkkejä suositaan harvinaisten merkkien ja erikoissymbolien sijaan. Tarkista kirjaimet liikkeessä. Ei-toivotut tekstitykset, logot ja kahdentuneet hahmot ovat dokumentoituja käyttäytymisiä; nimenomaiset rajaukset ja puhtaat viitteet voivat vähentää niitä mutta eivät takaa poissaoloa. Yli neljä viitehenkilöä ilmoitetaan vakausriskiksi, ei kovaksi tiedostomäärärajaksi.

Toistuvat jatkot voivat kasata kuvanlaadun heikkenemistä, ja jatkon liitos voi hypätä tai palata taaksepäin. Rajoita päällekkäisiä jatkoja ja tarkista liitos editoinnissa. Viiteäänen sointiväri voi muuttua, kerronta voi päättyä napsahdukseen ja kiinan monitulkintaiset tai harvinaiset merkit voivat ääntyä väärin. Tarkista puhuttu repliikki ja loppuääni; lyhyt äänihäivytys voi auttaa katkeamiseen. Tarkistukset kuuluvat luovan tuloksen valmisteluun erityisesti silloin, kun puhe tai hahmojatkuvuus kantaa tarinaa.

**Ailoot Ultra · Video** `POST /v1/videos` `bytedance/seedance-2.0-fast`

[`bytedance/seedance-2.0-fast`](https://ailoot.ai/models/fi/#m=bytedance%2Fseedance-2.0-fast&route=Ultra&caller=bytedance%2Fseedance-2.0-fast&fmt=videos)

ByteDance /`bytedance/seedance-2.0-fast`

### Aloitus

ByteDance Seedance 2.0 Fast luo audiovisuaalisia kohtauksia tekstistä sekä kuva-, video- ja ääniviitteistä. Nopeuteen suunnattu versio tukee liikkeen ja tyylin siirtoa, videomuokkauksia ja jatkamista eteen- tai taaksepäin dokumentoiduilla 480p- ja 720p-tulosteilla.

Hyväksytyt syötteet

Teksti · Kuvat · Ääni

Tulokset

Video

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

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

Syötetyypit

`text`, `image`, `audio`

Tulostyypit

`video`

Tulosteen muoto

alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta

| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
| --- | --- | --- | --- | --- |
| Kenttä`model` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat bytedance/seedance-2.0-fast | Oletus— |
| Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat | Oletus— |
| Kenttä`duration` | Tyyppi`integer` | VaatimusPakollinen | Arvot & rajat 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Vähimmäismäärä: 1 Enimmäismäärä: 600 | Oletus— |
| Kenttä`resolution` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 480p, 720p | Oletus— |
| Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, 9:21 | Oletus— |
| Kenttä`generate_audio` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat false, true Ehdot: generate\_audio-kentän pois jättäminen valitsee äänen sisältävän hinnan; false valitsee äänettömän hinnan. Tarkista tuloksen has\_audio-kentästä, palautettiinko ääniraita. | Oletus— |
| Kenttä`frame_images` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 1 Kohteiden enimmäismäärä: 2 Syötteen sisältö: Kuvaolioiden taulukko. Jokaisessa on type=image\_url, url-kentän sisältävä image\_url ja frame\_type=first\_frame tai last\_frame. Kukin rooli esiintyy enintään kerran. Käytä julkisia HTTPS-kuvan URL-osoitteita. Tarkat avaimet: type, image\_url, frame\_type Ehdot: Nämä avaimet koskevat jokaista kuvaoliota. Jätä frame\_images pois pelkkää tekstiä sisältävästä pyynnöstä. | Oletus— |
| Kenttä`input_references` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat Syötteen sisältö: Kuva- tai ääniviiteolioiden taulukko. Aseta type-kentän arvoksi image\_url tai audio\_url ja anna vastaava url-kentän sisältävä URL-olio. Videoviitteitä ei edelleenkään voida hinnoitella. Ehdot: Jätä frame\_images pois käyttääksesi viitetilaa. Käytä julkisia HTTPS-osoitteita. | Oletus— |
| Kenttä`size` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 480x480, 480x640, 480x854, 640x480, 854x480, 1120x480, 720x720, 720x960, 720x1280, 720x1680, 960x720, 1280x720, 1680x720 Merkkijonomalli: ^\[1-9\]\[0-9\]\*x\[1-9\]\[0-9\]\*$ | Oletus— |
| Kenttä`seed` | Tyyppi`integer` | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: −9 223 372 036 854 775 808 Enimmäismäärä: 9 223 372 036 854 775 807 | Oletus— |
| Kenttä`callback_url` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Merkkijonomalli: ^https:// | Oletus— |
| Kenttä`session_id` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`trace` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`user` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |

Syöteaineistojen yhdistelmät

**Tekstistä videoksi** · Kirjoitettu kehote. · Pakollinen: model, prompt, duration

`Anna tekstikehote ja tuettu kesto kokonaisina sekunteina. Käytä täsmälleen lueteltua kokoa tai resoluutiota ja kuvasuhdetta, jotka muodostavat luetellut mitat.`

`model`: Tyyppi: string · bytedance/seedance-2.0-fast

`prompt`: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

**Kuvasta videoksi** · Kirjoitettu kehote ja ruutukuva. · Pakollinen: model, prompt, duration, frame\_images

`frame_images on oliotaulukko, jossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä julkista HTTPS-kuvan URL-osoitetta; first_frame ja last_frame saavat kumpikin esiintyä kerran. Käytä lueteltua tuloskokoa tai yhteensopivia mittoja. Älä lisää videoviitteitä.`

Tarkat avaimet: type, image\_url, frame\_type

`model`: Tyyppi: string · bytedance/seedance-2.0-fast

`prompt`: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

**Reference to video** · Kirjoitettu kehote sekä kuva- tai ääniviitteet. · Pakollinen: model, prompt, duration, input\_references

`input_references on taulukko. Jokaisessa oliossa on type=image_url tai type=audio_url sekä vastaava url-kentän sisältävä URL-olio. Käytä julkisia HTTPS-linkkejä. Jätä frame_images pois valitaksesi viitetilan. Videoviitteitä ei voida hinnoitella.`

`model`: Tyyppi: string · bytedance/seedance-2.0-fast

`prompt`: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä

Menetelmän parametrit ja elinkaari

| Parametri | Sopimus |
| --- | --- |
| Parametri`content_type` | Sopimusapplication/json |
| Parametri`required` | Sopimusmodel, prompt, duration |
| Parametri`material_types` | Sopimustext, image, audio |
| Parametri`additional_properties` | Sopimusfalse |
| Parametri`optional_controls` | Sopimusresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, size, seed, callback\_url, session\_id, trace, user |

Elinkaari: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### 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ä | Laskutusyksikkö | Laskutusehdot | Veloitus |
| --- | --- | --- | --- | --- | --- |
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusyksikkö— | Laskutusehdot— | 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 |
| AsetuksetVideotokenin hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkö1K videotokenia kohden | LaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa. | Veloitus Tuloste · Videotokenin hinta · Arvio vain vertailua varten **$0.0084** 1K videotokenia kohden Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu. |
| AsetuksetVideotokenin hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkö1K videotokenia kohden | Laskutusehdotsyöte: with\_video\_input | Veloitus reference · Videotokenin hinta · Arvio vain vertailua varten **$0.00495** 1K videotokenia kohden Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu. |
| AsetuksetVideotokenin hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkö1K videotokenia kohden | Laskutusehdotääni: without\_audio | Veloitus Tuloste · Videotokenin hinta · Arvio vain vertailua varten **$0.0084** 1K videotokenia kohden Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu. |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Laskutusehdot— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten **$0.18144** 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/)

#### Viitehinnaston tiedot

Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.

Videokokoonpanojen hintaviitteet

#### Hinnat asetusten mukaan

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

| Asetukset | Laskutusehdot | Veloitus |
| --- | --- | --- |
| AsetuksetVideotokenin hinta | LaskutusehdotTässä hinnoitteluavaimessa ei ole ilmoitettu lisäehtoa. | Veloitus Tuloste · Videotokenin hinta **$0.0084** 1K videotokenia kohden Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu. |
| AsetuksetVideotokenin hinta | Laskutusehdotääni: without\_audio | Veloitus Tuloste · Videotokenin hinta **$0.0084** 1K videotokenia kohden Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu. |
| AsetuksetVideotokenin hinta | Laskutusehdotsyöte: with\_video\_input | Veloitus reference · Videotokenin hinta **$0.00495** 1K videotokenia kohden Videotokenin hinta on ensisijainen hintaviite. Otsikossa esitetyt sekuntikohtaiset hinta-arviot ovat erillisiä viitearvoja, eivät lisämaksu. |

### Esimerkkipyynnöt

#### Ailoot Ultra · Video

curl · luo video

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.0-fast","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"480x480","generate_audio":false}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Vastaanota ja tallenna tulokset

#### Ailoot Ultra · Video

allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Tarkista työn tila

GET alkuperäisen toiminnon tila

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Muut sisällön lukukerrat

Tallenna jokainen valmistunut omistamasi tuloste

```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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

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

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

Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.

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

503 result\_pending\_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä

Vastauksen kentät

| Kenttä | Tyyppi | Merkitys |
| --- | --- | --- |
| Kenttä`index` | Tyyppiinteger | MerkitysTämän videon nollasta alkava sijainti tulosluettelossa. |
| Kenttä`content_url` | Tyyppistring | MerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle. |
| Kenttä`sha256` | Tyyppistring \| null | MerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla. |
| Kenttä`size_bytes` | Tyyppiinteger \| null | MerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla. |
| Kenttä`duration_ms` | Tyyppiinteger \| null | MerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla. |
| Kenttä`width` | Tyyppiinteger \| null | MerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla. |
| Kenttä`height` | Tyyppiinteger \| null | MerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla. |
| Kenttä`video_codec` | Tyyppistring \| null | MerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu. |
| Kenttä`has_audio` | Tyyppiboolean \| null | MerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu. |
| Kenttä`audio_codec` | Tyyppistring \| null | MerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu. |

Virheet ja seuraavat vaiheet

| Vastaus | Ehto | Seuraava vaihe |
| --- | --- | --- |
| Vastaus404 · `not_found_error` | EhtoVideoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt. | Seuraava vaiheTarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta. |
| Vastaus401 · `authentication_error` | EhtoAPI-avain ei vastaa todennettua tiliä. | Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä. |
| Vastaus400 · `invalid_request_error` | EhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen. | Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi. |
| Vastaus422 · `price_unavailable` | EhtoValittua videokokoonpanoa ei voida hinnoitella. | Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä. |
| Vastaus422 · `invalid_request_error` | EhtoVideosyöte tai alkuperäinen jatkotehtävä on virheellinen. | Seuraava vaiheKäytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella. |
| Vastaus402 · `billing_error` | EhtoKäytettävissä oleva saldo tai rajoitukset eivät salli katevarausta. | Seuraava vaiheTarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä. |
| Vastaus503 · `server_error` | EhtoVideon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla. | Seuraava vaiheOdota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan. |
| Vastaus503 · `result_pending_check` | EhtoAlkuperäinen videotulos ja veloitus on tarkistettava. | Seuraava vaiheSäilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana. |
| Vastaus503 · `owned_result_unavailable` | EhtoOlemassa olevan videon lataus ei ole tilapäisesti saatavilla. | Seuraava vaiheTarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation. |
| Vastaus409 · `video_not_ready` | EhtoVideosisältöä ei ole julkaistu. | Seuraava vaiheTarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta. |

### Aliakset

#### Mallin aliakset

**Ailoot Ultra** [`bytedance/seedance-2.0-fast`](https://ailoot.ai/models/fi/#m=bytedance%2Fseedance-2.0-fast&route=Ultra&caller=bytedance%2Fseedance-2.0-fast&fmt=videos)

#### Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

#### Liittyvät kutsujan ID:t

[`bytedance/seedance-2.0-fast`](https://ailoot.ai/models/fi/#m=bytedance%2Fseedance-2.0-fast&route=Ultra&caller=bytedance%2Fseedance-2.0-fast&fmt=videos)

FAQ · ByteDance: Seedance 2.0 Fast

Mitä syötteitä ja tuloksia on saatavilla?

`POST /v1/videos` · `bytedance/seedance-2.0-fast`: `text`, `image`, `audio` → `video`

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

`POST /v1/videos` · `bytedance/seedance-2.0-fast`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `size`, `seed`, `callback_url`, `session_id`, `trace`, `user`

Mitä rajoja sovelletaan?

`POST /v1/videos` · `bytedance/seedance-2.0-fast`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

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.