kling-v1-6
Profil kling-v1-6 generuje video z písemného popisu scény. Naplánujte krátký záběr s jasným subjektem, akcí a vedením kamery a využijte dokumentované možnosti délky pěti nebo deseti sekund. Generování je asynchronní: uchovejte vrácenou identitu úlohy a dokončené video načtěte po úspěšném dokončení původní úlohy.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Přesný selektor kling-v1-6 označuje profil Kling pro převod textu na video. Odešlete JSON na POST /v1/videos/generations s parametrem model nastaveným na kling-v1-6 a písemným popisem scény v parametru prompt. POST /v1/videos přijímá stejný požadavek na generování. Jasný požadavek popisuje, co je vidět, co se během záběru děje a jak to kamera pozoruje. Minimální požadavek na scénu poskytuje selektor modelu a prompt a další ovládání záběru ponechává nespecifikované.
U produktového záběru popište předmět, povrch, osvětlení a jednu viditelnou akci, například pomalé otočení nebo změnu polohy kamery. U konceptu scény určete prostředí, hlavní subjekt a pohyb v rámu. Zachovejte srozumitelnost akce v požadovaném klipu. Zadání může popisovat malý člun přejíždějící klidné jezero, široký pohled ze břehu, časné ranní světlo a stabilní kameru sledující směr člunu.
Limit parametru prompt je 500 znaků. Volitelný negative_prompt může obsahovat až 200 znaků a popisuje nežádoucí prvky. Dokumentovanými volbami duration pro tento profil jsou 5 a 10 sekund. Hodnoty mode jsou std a pro. cfg_scale je číslo od 0 do 1; dokumentace popisuje vyšší hodnoty jako silnější dodržování textu. Ovládací prvky vyberte pro konkrétní záběr a odeslané hodnoty uchovejte spolu s výsledkem.
Dokumentovaný objekt camera_control uvádí typy kamery simple, down_back, forward_up, right_turn_forward a left_turn_forward. Jeho konfigurace simple pojmenovává ovládací prvky horizontal, vertical, pan, tilt, roll a zoom. Minimální textový příklad poskytuje užitečný výchozí bod, když lze scénu popsat bez samostatného objektu ovládání kamery. Pohybu kamery v zadání dejte jasný účel, například odhalení subjektu nebo sledování jeho pohybu.
Odeslání spouští asynchronní úlohu. Uchovejte vrácené id, hlavičku X-Ailoot-Task-Id a polling_url a poté použijte GET na toto polling_url se stejným klíčem API Ailoot pro načtení původní úlohy. Stav úlohy je v data.task_status: submitted a processing znamenají čekající zpracování, succeed znamená úspěch a failed neúspěch. Potvrzení přijetí je tedy mezivýsledkem. Při úspěchu načtěte každé URL v data.task_result.videos[].url; jde o odkazy na výsledné soubory spravované Ailoot. GET /v1/videos/{id}/content načte první výstup a jeho parametr dotazu index vybere vrácený výstup podle indexu počítaného od nuly. Odpověď se stavem uchovejte s vybraným klipem. Pokud nastane vypršení časového limitu nebo odpověď result_pending_check, uchovejte původní vrácenou identitu a zkontrolujte tuto operaci, místo abyste záběr odeslali znovu.
Zkontrolujte dokončené záběry v celé jejich délce: zamýšlená akce, vzhled subjektu, rámování i pohyb patří do zadání záběru. Tento přesný profil poskytuje zde popsaný postup převodu textu na video. Vrácenou úlohu, která stále vyžaduje kontrolu stavu, je třeba sledovat pomocí její původní identity, i když klientský požadavek překročí časový limit; před zvažováním nového požadavku na generování uchovejte informace o této úloze.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Úvod
Profil kling-v1-6 generuje video z písemného popisu scény. Naplánujte krátký záběr s jasným subjektem, akcí a vedením kamery a využijte dokumentované možnosti délky pěti nebo deseti sekund. Generování je asynchronní: uchovejte vrácenou identitu úlohy a dokončené video načtěte po úspěšném dokončení původní úlohy.
- Přijímané vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Video POST /v1/videos
- Vstup
text- Výstup
video
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity kling-v1-6 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Polemode | Typstring | PožadavekPovinné | Hodnoty a limity std, pro | Výchozí— |
Polemodel_name | Typstring | PožadavekVolitelné | Hodnoty a limity kling-v1-6 | Výchozí— |
Polecfg_scale | Typnumber | PožadavekVolitelné | Hodnoty a limity Minimum: 0 Maximum: 1 | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polenegative_prompt | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleduration | Typinteger | PožadavekVolitelné | Hodnoty a limity 5, 10 | Výchozí— |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, mode |
Parametroptional | Kontraktmodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | Kontraktmodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
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.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Poplatek |
|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Př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ů |
| KonfiguraceEstimated generation cost | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Poplatek Vstup · Odhadovaná cena generování · Odhad pouze pro srovnání $6 odhad před generováním This estimate is not an additional charge or a fixed rate for the completed generation. |
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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "kling-v1-6", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}')
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.
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}/contentGET /v1/media/assetsGET /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.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Pokud je nutné ověřit původní odpověď
Keep the returned public task or operation id and all headers. Read only the original task; unknown or result_pending_check does not authorize another creation.
Pole odpovědi
| Pole | Typ |
|---|---|
Poledata.task_result.videos[].url | Typstring or array, as returned |
Aliasy
Aliasy modelu
Ailoot Ultra kling-v1-6
Aliasy cest metod
/v1/videos/generations
Související ID modelů
FAQ · kling-v1-6
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·kling-v1-6:text→video- Jaká pole požadavek používá?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Jaké limity platí?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1