Kling: Video O1

Kling VIDEO O1 je referenčně vedený videomodel Kuaishou pro generování a úpravy scén s textem, obrázky, prvky objektů a zdrojovým klipem. Jeho generovací profil tří až deseti sekund použijte pro vizuální návaznost, řízené přechody snímků a cílené změny existujícího záznamu.

Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1

O modelu

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

Kling VIDEO O1 je sjednocený referenčně vedený videomodel Kuaishou. Spojuje textový popis s obrázky, připravenými prvky objektů nebo zdrojovým videem pro vedení nových scén a cílených změn existujícího záznamu. Základním rozhraním je vizuální zadání: identifikujte referenční materiál, popište jeho roli a uveďte vzhled, akci nebo proměnu požadovanou ve výsledném videu.

Nový záběr může začít textem, úvodním obrázkem nebo sadou vizuálních referencí. Obrázkem stanovte postavu nebo předmět a slovy popište prostředí, akci a pohled. Pokud několik referencí přispívá různými rysy, výslovně přiřaďte jejich role. Původní produktové zadání může převzít předmět z jednoho obrázku a prostředí z druhého a potom popsat pohyb předmětu v tomto prostředí.

Prompt O1 může pojmenovávat obrázky, prvky a videa konkrétními referenčními značkami, například <<<image_1>>> nebo <<<video_1>>>. Tyto značky spojujte se skutečně dodaným podkladem a vysvětlete, co se z něj má převzít. Výrobce umožňuje prompt o 2 500 znacích. Stručný pokyn identifikující objekt a změnu je užitečnější než soubor nesouvisejících stylových výrazů.

U obrazových referencí bez video vstupu je dokumentovaný společný rozpočet až sedm referenčních obrázků a víceobrazových prvků. S referenčním videem je tento rozpočet obrázků a prvků čtyři. Limity se vztahují k obrazovým prvkům; jiné typy prvků mají samostatná pravidla kompatibility. Vyberte materiál dodávající zásadní vzhled nebo informace scény, místo zaplňování rozpočtu nadbytečnými pohledy.

Obrazové vstupy používají JPG, JPEG nebo PNG dodané přístupným URL nebo obrazovými daty, se soubory do 10 MB, rozměry nejméně 300 pixelů a poměrem stran mezi 1:2.5 a 2.5:1. Připravte jasné objekty a v ořezu zachovejte důležité detaily. Potřebuje-li úkol zachovat rozpoznatelnou postavu nebo produkt, uveďte zachovávané rysy a kontrolujte je v celém hotovém klipu.

První a poslední snímek podmiňují přechod mezi vizuálními hranicemi. Dokumentovaný postup hraničních snímků O1 vyžaduje při dodání koncového snímku také počáteční a nepodporuje ovládání prvního a posledního snímku s více než dvěma obrázky v poli. Při použití obou hraničních snímků nejsou další prvky objektů součástí této konfigurace O1. Úkol řízený snímky ponechte oddělený od úpravy dodaného základního videa.

Zdrojové video může mít dvě odlišné role. Jako základní klip představuje upravovaný záznam: určete konkrétní přidání, odstranění, stylové zpracování nebo kompoziční změnu a uveďte, co má zůstat. Úprava sleduje délku vstupního klipu a nekombinuje úkol základního videa s ovládáním hraničních snímků ani generováním více záběrů. Jako reference vlastností video dodává obsah, styl nebo kamerové informace pro nový záběr.

Zadávání s referenčním videem může také požadovat předcházející nebo následující záběr. Identifikujte zdrojový klip a popište novou viditelnou událost, například pokračování akce objektu nebo odhalení okolního prostředí. Reference tak sděluje vizuální informace; před sestavením nového segmentu s původním záznamem zkontrolujte spoj a návaznost objektu.

Profil video vstupu výrobce přijímá jeden zdroj MP4 nebo MOV do 200 MB s minimální délkou tři sekundy. Podrobný vstupní profil stanovuje rozměry od 720 do 2160 pixelů a snímkové frekvence od 24 do 60 fps, s poměrem stran mezi 1:2.5 a 2.5:1. Tento dokumentovaný postup zdrojového videa vrací video 24 fps. Přesná povolená délka klipu závisí také na vybraném profilu modelu. Rozsah nového generování O1 je tři až deset sekund, odlišný od rozsahu délky pozdějšího 3.0 Omni.

Režimy O1 výrobce poskytují výstup 720p Standard nebo 1080p Pro. Rámování nového záběru podporuje dokumentované široké, portrétní a čtvercové volby tam, kde vybraný postup toto ovládání používá; úprava základního videa sleduje rámování zdroje. Zvuk zdrojového videa lze zachovat nebo zahodit. Referenční a editační postup O1 má zůstat oddělený od pozdějšího profilu 3.0 Omni s nativním zvukem a vlastním storyboardem.

Generování vytváří úkol, jehož dokončený výsledek obsahuje video a skutečnou délku. Dokumentace výsledků výrobce uvádí smazání generovaných videí po 30 dnech, proto hotový klip uložte včas. S výsledkem uchovejte zdrojové podklady a zadání a potom zkontrolujte požadovanou změnu, použití referencí a návaznost. U úpravy porovnejte dotčenou oblast i části, které mají zůstat. U nového záběru vedeného referencemi ověřte, zda každý podklad dodal zamýšlené vizuální informace. Hotový klip ponechte dostupný pro následný střih nebo produkční sekvenci.

Ailoot Ultra · Video POST /v1/videos kwaivgi/kling-video-o1

kwaivgi/kling-video-o1

Kuaishou /kwaivgi/kling-video-o1

Úvod

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
Výstupní formát: původní bajty MP4; bez normalizace a překódování

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity kwaivgi/kling-video-o1	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity	Výchozí—
Pole`duration`	Typ`integer`	PožadavekPovinné	Hodnoty a limity 5, 10 Minimum: 1 Maximum: 600	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 720p	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 16:9, 9:16, 1:1	Výchozí—
Pole`generate_audio`	Typ`boolean`	PožadavekVolitelné	Hodnoty a limity false, true	Výchozí—
Pole`frame_images`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 2 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame nebo last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image_url, frame_type Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images.	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`size`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 1280x720, 720x1280, 720x720 Vzor: ^[1-9][0-9]x[1-9][0-9]$	Výchozí—
Pole`callback_url`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Vzor: ^https://	Výchozí—
Pole`session_id`	Typ`string`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`trace`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`user`	Typ`string`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Kombinace vstupních materiálů

Text na video · Textové zadání. · Povinné: model, prompt, duration

Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení; přidejte poměr stran nebo použijte uvedenou velikost.

model: Typ: string · kwaivgi/kling-video-o1

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images

frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame s volitelným last_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Vyberte podporované rozlišení; přidejte poměr stran nebo použijte uvedenou velikost.

Přesné klíče: type, image_url, frame_type

model: Typ: string · kwaivgi/kling-video-o1

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt, duration
Parametr`material_types`	Kontrakttext, image
Parametr`additional_properties`	Kontraktfalse
Parametr`optional_controls`	Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Životní cyklus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

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.

Konfigurace	Tabulka sazeb	Předpokládané množství	Účtovací jednotka	Podmínky účtování	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Podmínky účtování—	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ů
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.224 za sekundu videa
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Podmínky účtování—	Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $1.12 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í →

Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové reference konfigurací videa

Ceny podle konfigurace

Konfigurace	Podmínky účtování	Poplatek
KonfiguraceCena videa	Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka.	Poplatek Výstup · Cena videa $0.224 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.

Příklady požadavků

Ailoot Ultra · Video

curl · vytvořte video

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":5,"model":"kwaivgi/kling-video-o1","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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

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

Ailoot Ultra · Video

podepsané URL obsahu spravovaného službou

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

Ověřit stav úlohy

Získat stav původní operace pomocí GET

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

Další načtení obsahu

Uložte každý dokončený výstup, který vám patří

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

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 každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.

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

503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte

Pole odpovědi

Pole	Typ	Význam
Pole`index`	Typinteger	VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly.
Pole`content_url`	Typstring	VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa.
Pole`sha256`	Typstring \| null	VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný.
Pole`size_bytes`	Typinteger \| null	VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná.
Pole`duration_ms`	Typinteger \| null	VýznamNaměřená délka videa v milisekundách; null, není-li dostupná.
Pole`width`	Typinteger \| null	VýznamŠířka videa v pixelech; null, není-li dostupná.
Pole`height`	Typinteger \| null	VýznamVýška videa v pixelech; null, není-li dostupná.
Pole`video_codec`	Typstring \| null	VýznamIdentifikátor video kodeku; null, není-li zaznamenán.
Pole`has_audio`	Typboolean \| null	VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno.
Pole`audio_codec`	Typstring \| null	VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán.

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď404 · `not_found_error`	PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno.	Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.
Odpověď401 · `authentication_error`	PodmínkaKlíč API neodpovídá ověřenému účtu.	Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu.
Odpověď400 · `invalid_request_error`	PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný.	Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.
Odpověď422 · `price_unavailable`	PodmínkaVybranou konfiguraci videa nelze ocenit.	Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.
Odpověď422 · `invalid_request_error`	PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné.	Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.
Odpověď402 · `billing_error`	PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci.	Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.
Odpověď503 · `server_error`	PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.	Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.
Odpověď503 · `result_pending_check`	PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.	Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.
Odpověď503 · `owned_result_unavailable`	PodmínkaStávající video je dočasně nedostupné ke stažení.	Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.
Odpověď409 · `video_not_ready`	PodmínkaObsah videa nebyl zveřejněn.	Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.

Aliasy

Aliasy modelu

Ailoot Ultra kwaivgi/kling-video-o1

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

kwaivgi/kling-video-o1

FAQ · Kling: Video O1

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos · kwaivgi/kling-video-o1: text, image → video
Jaká pole požadavek používá?: POST /v1/videos · kwaivgi/kling-video-o1: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user
Jaké limity platí?: POST /v1/videos · kwaivgi/kling-video-o1: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

Kling: Video O1

Kling: Video O1

Úvod

Dostupné v Ailoot · vstupy a metody

Tarify

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

Odhadované sazby pro srovnání

Ceny podle konfigurace

Podrobnosti referenčního tarifu

Ceny podle konfigurace

Příklady požadavků

Ailoot Ultra · Video

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

Ailoot Ultra · Video

Ověřit stav úlohy

Uchovejte všechny dokončené výsledky

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

Aliasy

Aliasy modelu

Aliasy cest metod

Související ID modelů

Společnost a její portfolio projektů

Nakupujte tokeny se slevou.

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