kling-v1-6
Profil kling-v1-6 generuje wideo z pisemnego opisu sceny. Zaplanuj krótkie ujęcie z wyraźnym tematem, akcją i kierunkiem pracy kamery, korzystając z udokumentowanych opcji długości pięciu lub dziesięciu sekund. Generowanie jest asynchroniczne: zachowaj zwróconą tożsamość zadania i pobierz gotowe wideo po powodzeniu pierwotnego zadania.
O modelu
Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.
Dokładny selektor kling-v1-6 identyfikuje profil Kling do tworzenia wideo z tekstu. Wyślij JSON do POST /v1/videos/generations z polem model ustawionym na kling-v1-6 i pisemnym opisem sceny w polu prompt. POST /v1/videos przyjmuje również to samo żądanie generowania. Jasne żądanie opisuje, co jest widoczne, co dzieje się podczas ujęcia i jak obserwuje to kamera. Minimalne żądanie sceny zawiera selektor modelu i prompt, pozostawiając dodatkowe parametry ujęcia nieokreślone.
W ujęciu produktowym opisz przedmiot, powierzchnię, oświetlenie i jedną widoczną czynność, na przykład powolny obrót lub zmianę pozycji kamery. W koncepcji sceny określ otoczenie, główny temat i ruch przez kadr. Akcja powinna pozostać czytelna w żądanym klipie. prompt może opisywać małą łódź przepływającą przez spokojne jezioro, szeroki widok z brzegu, światło wczesnego poranka i stabilną kamerę podążającą w kierunku ruchu łodzi.
Limit pola prompt wynosi 500 znaków. Opcjonalny negative_prompt może zawierać do 200 znaków i opisuje niepożądane elementy. Udokumentowane czasy duration dla tego profilu wynoszą 5 i 10 sekund. Wartości mode to std i pro. cfg_scale to liczba od 0 do 1; dokumentacja opisuje wyższe wartości jako silniejsze trzymanie się tekstu. Wybierz parametry dla konkretnego ujęcia i zachowaj wysłane wartości wraz z wynikiem.
Udokumentowany obiekt camera_control wymienia typy kamery simple, down_back, forward_up, right_turn_forward i left_turn_forward. Jego konfiguracja simple określa parametry horizontal, vertical, pan, tilt, roll i zoom. Minimalny przykład tekstowy stanowi przydatny punkt wyjścia, gdy scenę można opisać bez oddzielnego obiektu sterowania kamerą. Nadaj ruchowi kamery w polu prompt wyraźny cel, taki jak odsłonięcie tematu lub podążanie za jego ruchem.
Wysłanie rozpoczyna zadanie asynchroniczne. Zachowaj zwrócone id, nagłówek X-Ailoot-Task-Id i polling_url, a następnie używaj GET pod tym polling_url z tym samym kluczem API Ailoot, aby odczytywać pierwotne zadanie. Stan zadania znajduje się w data.task_status: submitted i processing oznaczają oczekiwanie, succeed oznacza powodzenie, a failed oznacza niepowodzenie. Potwierdzenie przyjęcia jest zatem wynikiem pośrednim. Po powodzeniu pobierz każdy adres URL z data.task_result.videos[].url; są to łącza do plików wynikowych zarządzanych przez Ailoot. GET /v1/videos/{id}/content pobiera pierwszy wynik, a jego parametr zapytania index wybiera zwrócony wynik według indeksu liczonego od zera. Zachowaj odpowiedź o stanie wraz z wybranym klipem. Jeśli wystąpi przekroczenie czasu lub odpowiedź result_pending_check, zachowaj pierwotnie zwróconą tożsamość i sprawdź tę operację, zamiast ponownie wysyłać ujęcie.
Oceń gotowy materiał na całej długości: zamierzona akcja, wygląd tematu, kadrowanie i ruch należą do opisu ujęcia. Ten konkretny profil udostępnia opisany tutaj przepływ tworzenia wideo z tekstu. Zwrócone zadanie, które nadal wymaga sprawdzenia stanu, należy śledzić z użyciem jego pierwotnej tożsamości, również po przekroczeniu czasu żądania klienta; zachowaj te informacje o zadaniu przed rozważeniem nowego żądania generowania.
Ailoot Ultra · Video POST /v1/videos kling-v1-6
kling-v1-6Start
Profil kling-v1-6 generuje wideo z pisemnego opisu sceny. Zaplanuj krótkie ujęcie z wyraźnym tematem, akcją i kierunkiem pracy kamery, korzystając z udokumentowanych opcji długości pięciu lub dziesięciu sekund. Generowanie jest asynchroniczne: zachowaj zwróconą tożsamość zadania i pobierz gotowe wideo po powodzeniu pierwotnego zadania.
- Akceptowane dane wejściowe
- Tekst
- Wyniki
- Wideo
Dostępne w Ailoot · dane wejściowe i metody
Ailoot Ultra · Video POST /v1/videos
- Wejście
text- Wyjście
video
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity kling-v1-6 | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Polemode | Typstring | WymaganieWymagane | Wartości i limity std, pro | Domyślnie— |
Polemodel_name | Typstring | WymaganieOpcjonalne | Wartości i limity kling-v1-6 | Domyślnie— |
Polecfg_scale | Typnumber | WymaganieOpcjonalne | Wartości i limity Minimum: 0 Maksimum: 1 | Domyślnie— |
Poleaspect_ratio | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polenegative_prompt | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poleduration | Typinteger | WymaganieOpcjonalne | Wartości i limity 5, 10 | Domyślnie— |
Parametry i cykl życia 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
Cykl życia: 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}
Cennik
Jak obliczana jest ostateczna opłata
Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.
Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.
- Tryb szybki
- Nie określono Gdy wybrany jest tryb szybki
- Tryb flex
- Nie określono Gdy wybrany jest tryb flex
- Maksymalna intensywność rozumowania
- Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)
Szacunkowe stawki do porównania
Ceny według konfiguracji
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Opłata |
|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów |
| KonfiguracjaEstimated generation cost | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Opłata Wejście · Szacowany koszt generowania · Szacunek tylko do porównania $6 szacunek przed generowaniem This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →
Przykładowe żądania
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.
Odbieranie i zapisywanie wyników
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}
Zachowaj wszystkie ukończone wyniki
Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.
Retain the complete response, all actual results, original identifiers, usage and response headers.
Jeśli trzeba sprawdzić pierwotną odpowiedź
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.
Pola odpowiedzi
| Pole | Typ |
|---|---|
Poledata.task_result.videos[].url | Typstring or array, as returned |
Aliasy
Aliasy modelu
Ailoot Ultra kling-v1-6
Aliasy ścieżek metod
/v1/videos/generations
Powiązane ID modeli
FAQ · kling-v1-6
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·kling-v1-6:text→video- Jakich pól używa żądanie?
POST /v1/videos·kling-v1-6:model,prompt,mode,model_name,cfg_scale,aspect_ratio,negative_prompt,duration- Jakie limity obowiązują?
POST /v1/videos·kling-v1-6:cfg_scale.minimum:0;cfg_scale.maximum:1