kling-v1-6
Profil kling-v1-6 generuje video z písomného opisu scény. Naplánujte krátky záber s jasným hlavným motívom, akciou a vedením kamery a využite zdokumentované možnosti päťsekundového alebo desaťsekundového trvania. Generovanie je asynchrónne: uchovajte vrátenú identitu úlohy a hotové video načítajte po úspechu pôvodnej úlohy.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Presný selektor kling-v1-6 označuje profil Kling na vytváranie videa z textu. Odošlite JSON na POST /v1/videos/generations s model nastaveným na kling-v1-6 a písomnou scénou v prompt. POST /v1/videos prijíma rovnakú požiadavku na generovanie. Jasná požiadavka opisuje, čo je viditeľné, čo sa počas záberu deje a ako to kamera sleduje. Minimálna požiadavka na scénu zadáva selektor modelu a prompt, pričom ďalšie nastavenia záberu ponecháva neurčené.
Pri produktovom zábere opíšte predmet, povrch, osvetlenie a jednu viditeľnú akciu, napríklad pomalé otočenie alebo zmenu polohy kamery. Pri koncepte scény určte prostredie, hlavný motív a pohyb v zábere. Akcia má byť v požadovanom klipe zrozumiteľná. Zadanie môže opisovať malú loď prechádzajúcu pokojným jazerom, široký pohľad z brehu, skoré ranné svetlo a stabilnú kameru sledujúcu smer lode.
Limit prompt je 500 znakov. Voliteľný negative_prompt môže obsahovať až 200 znakov a opisuje nežiaduce prvky. Zdokumentované možnosti duration pre tento profil sú 5 a 10 sekúnd. Hodnoty mode sú std a pro. cfg_scale je číslo od 0 do 1; dokumentácia opisuje vyššie hodnoty ako silnejšie dodržiavanie textu. Nastavenia vyberajte pre konkrétny záber a odoslané hodnoty uchovajte spolu s výsledkom.
Zdokumentovaný objekt camera_control uvádza typy kamery simple, down_back, forward_up, right_turn_forward a left_turn_forward. Jeho konfigurácia simple pomenúva nastavenia horizontal, vertical, pan, tilt, roll a zoom. Minimálny textový príklad poskytuje užitočný východiskový bod, keď možno scénu opísať bez samostatného objektu ovládania kamery. Pohybu kamery dajte v zadaní jasný účel, napríklad odhalenie hlavného motívu alebo sledovanie jeho pohybu.
Odoslanie spustí asynchrónnu úlohu. Uchovajte vrátené id, hlavičku X-Ailoot-Task-Id a polling_url a potom použite GET na tomto polling_url s rovnakým kľúčom API Ailoot na načítanie pôvodnej úlohy. Stav úlohy je v data.task_status: submitted a processing znamenajú čakanie, succeed znamená úspech a failed neúspech. Potvrdenie odoslania je preto priebežným výsledkom. Pri úspechu načítajte každú URL v data.task_result.videos[].url; sú to odkazy na výsledné súbory spravované Ailoot. GET /v1/videos/{id}/content načíta prvý výstup a jeho parameter dopytu index vyberá vrátený výstup podľa indexu počítaného od nuly. Odpoveď so stavom uchovajte spolu s vybraným klipom. Ak nastane časový limit alebo odpoveď result_pending_check, zachovajte pôvodnú vrátenú identitu a skontrolujte túto operáciu namiesto opätovného odoslania záberu.
Dokončený záznam skontrolujte v celej jeho dĺžke: zamýšľaná akcia, vzhľad hlavného motívu, rámovanie a pohyb patria do zadania záberu. Presne tento profil poskytuje tu opísaný postup vytvárania videa z textu. Vrátenú úlohu, ktorá ešte vyžaduje kontrolu stavu, sledujte pomocou jej pôvodnej identity aj vtedy, keď požiadavka klienta prekročí časový limit; tieto informácie o úlohe zachovajte pred uvažovaním o novej požiadavke na generovanie.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Úvod
Profil kling-v1-6 generuje video z písomného opisu scény. Naplánujte krátky záber s jasným hlavným motívom, akciou a vedením kamery a využite zdokumentované možnosti päťsekundového alebo desaťsekundového trvania. Generovanie je asynchrónne: uchovajte vrátenú identitu úlohy a hotové video načítajte po úspechu pôvodnej úlohy.
- Povolené vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity kling-v1-6 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Polemode | Typstring | PožiadavkaPovinné | Hodnoty a limity std, pro | Predvolené— |
Polemodel_name | Typstring | PožiadavkaVoliteľné | Hodnoty a limity kling-v1-6 | Predvolené— |
Polecfg_scale | Typnumber | PožiadavkaVoliteľné | Hodnoty a limity Minimum: 0 Maximum: 1 | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polenegative_prompt | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleduration | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity 5, 10 | Predvolené— |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, mode |
Parameteroptional | Špecifikáciamodel_name, cfg_scale, aspect_ratio, negative_prompt, duration |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | Špecifikáciamodel selects this model. An omitted model_name uses the selected model; an explicit native model_name override is preserved. |
Aliasy metódy: /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}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Poplatok |
|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaEstimated generation cost | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Poplatok Vstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $6 odhad pred generovaním This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
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.
Prijať a uložiť výsledky
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}
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Ak treba overiť pôvodnú odpoveď
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.
Polia odpovede
| Pole | Typ |
|---|---|
Poledata.task_result.videos[].url | Typstring or array, as returned |
Aliasy
Aliasy modelov
Ailoot Ultra kling-v1-6
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · kling-v1-6
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·kling-v1-6:text→video- Aké polia používa požiadavka?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Aké limity platia?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1