{ "aboutHtml": "

Kling VIDEO O1 to zunifikowany, prowadzony referencjami model wideo Kuaishou. Łączy opis tekstowy z obrazami, przygotowanymi elementami podmiotów lub źródłowym filmem, prowadząc nowe sceny i ukierunkowane zmiany istniejącego materiału. Jego podstawowym interfejsem jest brief wizualny: wskaż materiał referencyjny, opisz jego rolę i określ wygląd, akcję lub przekształcenie oczekiwane w wynikowym wideo.

Nowe ujęcie może zacząć się od tekstu, obrazu otwierającego lub zestawu referencji wizualnych. Użyj obrazu do ustanowienia postaci lub obiektu i opisz słowami scenerię, akcję oraz punkt widzenia. Gdy kilka referencji wnosi różne cechy, jawnie przypisz ich role. Oryginalny brief produktu może przejąć obiekt z jednego obrazu, a otoczenie z drugiego, po czym opisać ruch obiektu w tej scenerii.

Prompt O1 może nazywać obrazy, elementy i wideo konkretnymi znacznikami referencyjnymi, takimi jak <<<image_1>>> lub <<<video_1>>>. Zachowuj powiązanie znaczników z rzeczywiście dostarczonym materiałem i wyjaśniaj, co z niego przejąć. Limit promptu producenta wynosi 2500 znaków. Zwięzła instrukcja wskazująca podmiot i zmianę jest użyteczniejsza niż zbiór niepowiązanych określeń stylu.

Dla referencji obrazowych bez wejścia wideo udokumentowany łączny budżet wynosi do siedmiu obrazów referencyjnych i elementów wieloobrazowych. Przy filmie referencyjnym budżet obrazów i elementów wynosi cztery. Limity te dotyczą elementów opartych na obrazach; inne typy elementów mają osobne reguły zgodności. Wybieraj materiał dostarczający kluczowego wyglądu lub informacji o scenie, zamiast wypełniać budżet redundantnymi widokami.

Wejścia obrazowe używają JPG, JPEG lub PNG, dostarczanych jako dostępny URL lub dane obrazu, z plikami do 10 MB, wymiarami co najmniej 300 pikseli i proporcjami od 1:2.5 do 2.5:1. Przygotuj wyraźne podmioty i zachowaj ważne szczegóły w przycięciu. Jeśli zadanie wymaga rozpoznawalności postaci lub produktu, określ cechy do zachowania i kontroluj je w całym ukończonym klipie.

Klatki początkowa i końcowa warunkują przejście między granicami wizualnymi. Udokumentowany proces klatek granicznych O1 wymaga pierwszej klatki, gdy dostarczono ostatnią, i nie obsługuje sterowania początkiem i końcem przy więcej niż dwóch obrazach w tablicy. Gdy używa się obu klatek granicznych, dodatkowe elementy podmiotów nie należą do tej konfiguracji O1. Oddziel zadanie sterowane klatkami od edycji dostarczonego wideo bazowego.

Film źródłowy może mieć dwie odrębne role. Jako klip bazowy jest materiałem do edycji: kieruj konkretnym dodaniem, usunięciem, opracowaniem stylu lub zmianą kompozycji, wskazując elementy do zachowania. Edycja podąża za długością wejściowego klipu i nie łączy zadania wideo bazowego ze sterowaniem klatkami granicznymi lub generacją wielu ujęć. Jako referencja cech film dostarcza treść, styl lub informacje kamery do nowego ujęcia.

Promptowanie filmem referencyjnym może też żądać ujęcia poprzedzającego lub następującego. Wskaż klip źródłowy i opisz nowe widoczne zdarzenie, takie jak kontynuacja działania podmiotu lub odsłonięcie otaczającego środowiska. Wykorzystuje to referencję do przekazania informacji wizualnej; przed złożeniem nowego segmentu z oryginalnym materiałem oceń połączenie i ciągłość podmiotu.

Profil wejścia wideo producenta przyjmuje jedno źródło MP4 lub MOV, do 200 MB, z minimalną długością trzech sekund. Szczegółowy profil wejścia określa wymiary od 720 do 2160 pikseli i liczbę klatek od 24 do 60 fps, z proporcjami wejściowymi od 1:2.5 do 2.5:1. Ten udokumentowany proces wideo źródłowego zwraca film 24 fps. Dokładna dozwolona długość klipu zależy też od wybranego profilu modelu. Zakres nowej generacji O1 wynosi od trzech do dziesięciu sekund i różni się od późniejszego zakresu 3.0 Omni.

Tryby O1 producenta zapewniają wyjście 720p Standard lub 1080p Pro. Kadrowanie nowych ujęć obsługuje udokumentowane wybory poziome, pionowe i kwadratowe tam, gdzie wybrany proces używa tego parametru; edycja bazowego wideo podąża za kadrowaniem źródła. Audio źródłowego wideo można zachować lub odrzucić. Proces referencji i edycji O1 powinien pozostawać odrębny od późniejszego profilu natywnego audio i własnego storyboardu 3.0 Omni.

Generacja tworzy zadanie, którego ukończony wynik zawiera materiał wideo i rzeczywistą długość. Dokumentacja wyników producenta mówi, że generowane filmy są usuwane po 30 dniach, więc niezwłocznie zapisz ukończony klip. Zachowaj z nim materiały źródłowe i brief, a następnie oceń żądaną zmianę, użycie referencji i ciągłość. W edycji porównuj zmieniany obszar i części do zachowania. W nowym ujęciu prowadzonym referencjami sprawdź, czy każdy materiał dostarczył zamierzoną informację wizualną. Zachowaj ukończony klip do późniejszego montażu lub sekwencji produkcyjnej.

", "aboutText": "Kling VIDEO O1 to zunifikowany, prowadzony referencjami model wideo Kuaishou. Łączy opis tekstowy z obrazami, przygotowanymi elementami podmiotów lub źródłowym filmem, prowadząc nowe sceny i ukierunkowane zmiany istniejącego materiału. Jego podstawowym interfejsem jest brief wizualny: wskaż materiał referencyjny, opisz jego rolę i określ wygląd, akcję lub przekształcenie oczekiwane w wynikowym wideo.\n\nNowe ujęcie może zacząć się od tekstu, obrazu otwierającego lub zestawu referencji wizualnych. Użyj obrazu do ustanowienia postaci lub obiektu i opisz słowami scenerię, akcję oraz punkt widzenia. Gdy kilka referencji wnosi różne cechy, jawnie przypisz ich role. Oryginalny brief produktu może przejąć obiekt z jednego obrazu, a otoczenie z drugiego, po czym opisać ruch obiektu w tej scenerii.\n\nPrompt O1 może nazywać obrazy, elementy i wideo konkretnymi znacznikami referencyjnymi, takimi jak <<>> lub <<>>. Zachowuj powiązanie znaczników z rzeczywiście dostarczonym materiałem i wyjaśniaj, co z niego przejąć. Limit promptu producenta wynosi 2500 znaków. Zwięzła instrukcja wskazująca podmiot i zmianę jest użyteczniejsza niż zbiór niepowiązanych określeń stylu.\n\nDla referencji obrazowych bez wejścia wideo udokumentowany łączny budżet wynosi do siedmiu obrazów referencyjnych i elementów wieloobrazowych. Przy filmie referencyjnym budżet obrazów i elementów wynosi cztery. Limity te dotyczą elementów opartych na obrazach; inne typy elementów mają osobne reguły zgodności. Wybieraj materiał dostarczający kluczowego wyglądu lub informacji o scenie, zamiast wypełniać budżet redundantnymi widokami.\n\nWejścia obrazowe używają JPG, JPEG lub PNG, dostarczanych jako dostępny URL lub dane obrazu, z plikami do 10 MB, wymiarami co najmniej 300 pikseli i proporcjami od 1:2.5 do 2.5:1. Przygotuj wyraźne podmioty i zachowaj ważne szczegóły w przycięciu. Jeśli zadanie wymaga rozpoznawalności postaci lub produktu, określ cechy do zachowania i kontroluj je w całym ukończonym klipie.\n\nKlatki początkowa i końcowa warunkują przejście między granicami wizualnymi. Udokumentowany proces klatek granicznych O1 wymaga pierwszej klatki, gdy dostarczono ostatnią, i nie obsługuje sterowania początkiem i końcem przy więcej niż dwóch obrazach w tablicy. Gdy używa się obu klatek granicznych, dodatkowe elementy podmiotów nie należą do tej konfiguracji O1. Oddziel zadanie sterowane klatkami od edycji dostarczonego wideo bazowego.\n\nFilm źródłowy może mieć dwie odrębne role. Jako klip bazowy jest materiałem do edycji: kieruj konkretnym dodaniem, usunięciem, opracowaniem stylu lub zmianą kompozycji, wskazując elementy do zachowania. Edycja podąża za długością wejściowego klipu i nie łączy zadania wideo bazowego ze sterowaniem klatkami granicznymi lub generacją wielu ujęć. Jako referencja cech film dostarcza treść, styl lub informacje kamery do nowego ujęcia.\n\nPromptowanie filmem referencyjnym może też żądać ujęcia poprzedzającego lub następującego. Wskaż klip źródłowy i opisz nowe widoczne zdarzenie, takie jak kontynuacja działania podmiotu lub odsłonięcie otaczającego środowiska. Wykorzystuje to referencję do przekazania informacji wizualnej; przed złożeniem nowego segmentu z oryginalnym materiałem oceń połączenie i ciągłość podmiotu.\n\nProfil wejścia wideo producenta przyjmuje jedno źródło MP4 lub MOV, do 200 MB, z minimalną długością trzech sekund. Szczegółowy profil wejścia określa wymiary od 720 do 2160 pikseli i liczbę klatek od 24 do 60 fps, z proporcjami wejściowymi od 1:2.5 do 2.5:1. Ten udokumentowany proces wideo źródłowego zwraca film 24 fps. Dokładna dozwolona długość klipu zależy też od wybranego profilu modelu. Zakres nowej generacji O1 wynosi od trzech do dziesięciu sekund i różni się od późniejszego zakresu 3.0 Omni.\n\nTryby O1 producenta zapewniają wyjście 720p Standard lub 1080p Pro. Kadrowanie nowych ujęć obsługuje udokumentowane wybory poziome, pionowe i kwadratowe tam, gdzie wybrany proces używa tego parametru; edycja bazowego wideo podąża za kadrowaniem źródła. Audio źródłowego wideo można zachować lub odrzucić. Proces referencji i edycji O1 powinien pozostawać odrębny od późniejszego profilu natywnego audio i własnego storyboardu 3.0 Omni.\n\nGeneracja tworzy zadanie, którego ukończony wynik zawiera materiał wideo i rzeczywistą długość. Dokumentacja wyników producenta mówi, że generowane filmy są usuwane po 30 dniach, więc niezwłocznie zapisz ukończony klip. Zachowaj z nim materiały źródłowe i brief, a następnie oceń żądaną zmianę, użycie referencji i ciągłość. W edycji porównuj zmieniany obszar i części do zachowania. W nowym ujęciu prowadzonym referencjami sprawdź, czy każdy materiał dostarczył zamierzoną informację wizualną. Zachowaj ukończony klip do późniejszego montażu lub sekwencji produkcyjnej.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "952abff60768dac90998912fd1ab9933a299e4bbd29a3efec74fd5f10d6cd3da", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "pl", "methods": [ { "html": "
•

Kling: Video O1

Kuaishou /kwaivgi/kling-video-o1

Start

Kling VIDEO O1 to prowadzony referencjami model wideo Kuaishou do generowania i edycji scen z tekstem, obrazami, elementami podmiotów i klipem źródłowym. Korzystaj z profilu generacji od trzech do dziesięciu sekund do ciągłości wizualnej, prowadzonych przejść klatek i ukierunkowanych zmian istniejącego materiału.

Akceptowane dane wejściowe
Tekst · Obrazy
Wyniki
Wideo
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.

Kling VIDEO O1 to zunifikowany, prowadzony referencjami model wideo Kuaishou. Łączy opis tekstowy z obrazami, przygotowanymi elementami podmiotów lub źródłowym filmem, prowadząc nowe sceny i ukierunkowane zmiany istniejącego materiału. Jego podstawowym interfejsem jest brief wizualny: wskaż materiał referencyjny, opisz jego rolę i określ wygląd, akcję lub przekształcenie oczekiwane w wynikowym wideo.

Nowe ujęcie może zacząć się od tekstu, obrazu otwierającego lub zestawu referencji wizualnych. Użyj obrazu do ustanowienia postaci lub obiektu i opisz słowami scenerię, akcję oraz punkt widzenia. Gdy kilka referencji wnosi różne cechy, jawnie przypisz ich role. Oryginalny brief produktu może przejąć obiekt z jednego obrazu, a otoczenie z drugiego, po czym opisać ruch obiektu w tej scenerii.

Prompt O1 może nazywać obrazy, elementy i wideo konkretnymi znacznikami referencyjnymi, takimi jak <<<image_1>>> lub <<<video_1>>>. Zachowuj powiązanie znaczników z rzeczywiście dostarczonym materiałem i wyjaśniaj, co z niego przejąć. Limit promptu producenta wynosi 2500 znaków. Zwięzła instrukcja wskazująca podmiot i zmianę jest użyteczniejsza niż zbiór niepowiązanych określeń stylu.

Dla referencji obrazowych bez wejścia wideo udokumentowany łączny budżet wynosi do siedmiu obrazów referencyjnych i elementów wieloobrazowych. Przy filmie referencyjnym budżet obrazów i elementów wynosi cztery. Limity te dotyczą elementów opartych na obrazach; inne typy elementów mają osobne reguły zgodności. Wybieraj materiał dostarczający kluczowego wyglądu lub informacji o scenie, zamiast wypełniać budżet redundantnymi widokami.

Wejścia obrazowe używają JPG, JPEG lub PNG, dostarczanych jako dostępny URL lub dane obrazu, z plikami do 10 MB, wymiarami co najmniej 300 pikseli i proporcjami od 1:2.5 do 2.5:1. Przygotuj wyraźne podmioty i zachowaj ważne szczegóły w przycięciu. Jeśli zadanie wymaga rozpoznawalności postaci lub produktu, określ cechy do zachowania i kontroluj je w całym ukończonym klipie.

Klatki początkowa i końcowa warunkują przejście między granicami wizualnymi. Udokumentowany proces klatek granicznych O1 wymaga pierwszej klatki, gdy dostarczono ostatnią, i nie obsługuje sterowania początkiem i końcem przy więcej niż dwóch obrazach w tablicy. Gdy używa się obu klatek granicznych, dodatkowe elementy podmiotów nie należą do tej konfiguracji O1. Oddziel zadanie sterowane klatkami od edycji dostarczonego wideo bazowego.

Film źródłowy może mieć dwie odrębne role. Jako klip bazowy jest materiałem do edycji: kieruj konkretnym dodaniem, usunięciem, opracowaniem stylu lub zmianą kompozycji, wskazując elementy do zachowania. Edycja podąża za długością wejściowego klipu i nie łączy zadania wideo bazowego ze sterowaniem klatkami granicznymi lub generacją wielu ujęć. Jako referencja cech film dostarcza treść, styl lub informacje kamery do nowego ujęcia.

Promptowanie filmem referencyjnym może też żądać ujęcia poprzedzającego lub następującego. Wskaż klip źródłowy i opisz nowe widoczne zdarzenie, takie jak kontynuacja działania podmiotu lub odsłonięcie otaczającego środowiska. Wykorzystuje to referencję do przekazania informacji wizualnej; przed złożeniem nowego segmentu z oryginalnym materiałem oceń połączenie i ciągłość podmiotu.

Profil wejścia wideo producenta przyjmuje jedno źródło MP4 lub MOV, do 200 MB, z minimalną długością trzech sekund. Szczegółowy profil wejścia określa wymiary od 720 do 2160 pikseli i liczbę klatek od 24 do 60 fps, z proporcjami wejściowymi od 1:2.5 do 2.5:1. Ten udokumentowany proces wideo źródłowego zwraca film 24 fps. Dokładna dozwolona długość klipu zależy też od wybranego profilu modelu. Zakres nowej generacji O1 wynosi od trzech do dziesięciu sekund i różni się od późniejszego zakresu 3.0 Omni.

Tryby O1 producenta zapewniają wyjście 720p Standard lub 1080p Pro. Kadrowanie nowych ujęć obsługuje udokumentowane wybory poziome, pionowe i kwadratowe tam, gdzie wybrany proces używa tego parametru; edycja bazowego wideo podąża za kadrowaniem źródła. Audio źródłowego wideo można zachować lub odrzucić. Proces referencji i edycji O1 powinien pozostawać odrębny od późniejszego profilu natywnego audio i własnego storyboardu 3.0 Omni.

Generacja tworzy zadanie, którego ukończony wynik zawiera materiał wideo i rzeczywistą długość. Dokumentacja wyników producenta mówi, że generowane filmy są usuwane po 30 dniach, więc niezwłocznie zapisz ukończony klip. Zachowaj z nim materiały źródłowe i brief, a następnie oceń żądaną zmianę, użycie referencji i ciągłość. W edycji porównuj zmieniany obszar i części do zachowania. W nowym ujęciu prowadzonym referencjami sprawdź, czy każdy materiał dostarczył zamierzoną informację wizualną. Zachowaj ukończony klip do późniejszego montażu lub sekwencji produkcyjnej.

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Wideo POST /v1/videos
Wejście
text, image
Wyjście
video
Format wyjściowy
oryginalne bajty MP4; bez normalizacji i transkodowania
PoleTypWymaganieWartości i limityDomyślnie
PolemodelTypstringWymaganieWymaganeWartości i limity
kwaivgi/kling-video-o1
Domyślnie—
PolepromptTypstringWymaganieWymaganeWartości i limityDomyślnie—
PoledurationTypintegerWymaganieWymaganeWartości i limity
5, 10
Minimum: 1
Maksimum: 600
Domyślnie—
PoleresolutionTypstringWymaganieOpcjonalneWartości i limity
720p
Domyślnie—
Poleaspect_ratioTypstringWymaganieOpcjonalneWartości i limity
16:9, 9:16, 1:1
Domyślnie—
Polegenerate_audioTypbooleanWymaganieOpcjonalneWartości i limity
false, true
Domyślnie—
Poleframe_imagesTyparrayWymaganieOpcjonalneWartości i limity
Minimalna liczba elementów: 1
Maksymalna liczba elementów: 2
Treść wejściowa: Tablica obiektów klatek. Każdy obiekt zawiera type=image_url, image_url z polem url oraz frame_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame_type na first_frame lub last_frame. Każda rola klatki może wystąpić najwyżej raz.
Dokładne klucze: type, image_url, frame_type
Warunki: Te klucze opisują każdy obiekt klatki; image_url zawiera wyłącznie url. Pomiń frame_images w żądaniu zawierającym wyłącznie tekst.
Domyślnie—
Poleinput_referencesTyparrayWymaganieOpcjonalneWartości i limityDomyślnie—
PolesizeTypstringWymaganieOpcjonalneWartości i limity
1280x720, 720x1280, 720x720
Wzorzec: ^[1-9][0-9]*x[1-9][0-9]*$
Domyślnie—
Polecallback_urlTypstringWymaganieOpcjonalneWartości i limity
Wzorzec: ^https://
Domyślnie—
Polesession_idTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
PoletraceTypobjectWymaganieOpcjonalneWartości i limityDomyślnie—
PoleuserTypstringWymaganieOpcjonalneWartości i limityDomyślnie—
Kombinacje materiałów wejściowych

Tekst na wideo · Prompt tekstowy. · Wymagane: model, prompt, duration

Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość; dodaj proporcje obrazu lub użyj rozmiaru z listy.

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

prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

Obraz na wideo · Prompt tekstowy i obraz pierwszej klatki. · Wymagane: model, prompt, duration, frame_images

frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame z opcjonalnym last_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość; dodaj proporcje obrazu lub użyj rozmiaru z listy.

Dokładne klucze: type, image_url, frame_type

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

prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

Parametry i cykl życia metody
ParametrKontrakt
Parametrcontent_typeKontraktapplication/json
ParametrrequiredKontraktmodel, prompt, duration
Parametrmaterial_typesKontrakttext, image
Parametradditional_propertiesKontraktfalse
Parametroptional_controlsKontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, size, callback_url, session_id, trace, user

Cykl życia: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

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.

KonfiguracjaTabela stawekPrzewidywana ilośćJednostka rozliczeniowaWarunki rozliczaniaOpłata
KonfiguracjaBazowe stawki za tokenyTabela stawekStawka podstawowaPrzewidywana ilość—Jednostka rozliczeniowa—Warunki rozliczania—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
KonfiguracjaCena wideoTabela stawek—Przewidywana ilość—Jednostka rozliczeniowaza sekundę wideoWarunki rozliczaniaW tym kluczu cenowym nie zadeklarowano dodatkowego warunku.Opłata
Wyjście · Cena wideo · Szacunek tylko do porównania $0.224 za sekundę wideo
KonfiguracjaSzacowany koszt generowaniaTabela stawek—Przewidywana ilośćszacunek dla jednego generowaniaJednostka rozliczeniowa—Warunki rozliczania—Opłata
Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $1.12 szacunek przed generowaniem

Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

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 →

Szczegóły taryfy referencyjnej

Referencyjne tabele modelu nie zmieniają wyboru metody, wyceny ani opłat. Naliczane opłaty korzystają ze stawek wybranej metody Ailoot.

Referencje cenowe konfiguracji wideo

Ceny według konfiguracji

KonfiguracjaWarunki rozliczaniaOpłata
KonfiguracjaCena wideoWarunki rozliczaniaW tym kluczu cenowym nie zadeklarowano dodatkowego warunku.Opłata
Wyjście · Cena wideo $0.224 za sekundę wideo

Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.

Przykładowe żądania

Ailoot Ultra · Wideo

set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('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')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n  --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n

Odbieranie i zapisywanie wyników

Ailoot Ultra · Wideo

podpisane adresy URL treści należących do użytkownika

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Sprawdź status zadania
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error "$(cat status-url.txt)" \\\n  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n
Inne odczyty treści
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n    urls.append((str(i),u))\nfor label,path in urls:\n    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n    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')\n    target=Path('owned-'+label+'.bin')\n    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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n
Zachowaj wszystkie ukończone wyniki

Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.

Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.

Jeśli trzeba sprawdzić pierwotną odpowiedź

503 result_pending_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania

Pola odpowiedzi
PoleTypZnaczenie
PoleindexTypintegerZnaczeniePozycja tego wideo na liście wyników, liczona od zera.
Polecontent_urlTypstringZnaczeniePodpisany URL HTTPS do pobrania tego ukończonego wideo.
Polesha256Typstring | nullZnaczenieSkrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny.
Polesize_bytesTypinteger | nullZnaczenieRozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny.
Poleduration_msTypinteger | nullZnaczenieZmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny.
PolewidthTypinteger | nullZnaczenieSzerokość wideo w pikselach; null, jeśli jest niedostępna.
PoleheightTypinteger | nullZnaczenieWysokość wideo w pikselach; null, jeśli jest niedostępna.
Polevideo_codecTypstring | nullZnaczenieIdentyfikator kodeka wideo; null, jeśli go nie zapisano.
Polehas_audioTypboolean | nullZnaczenieCzy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono.
Poleaudio_codecTypstring | nullZnaczenieIdentyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora.
Błędy i dalsze kroki
OdpowiedźWarunekNastępny krok
Odpowiedź404 · not_found_errorWarunekNie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo.Następny krokSprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API.
Odpowiedź401 · authentication_errorWarunekKlucz API nie odpowiada uwierzytelnionemu kontu.Następny krokSprawdź swój klucz API i dostęp do konta przed wysłaniem.
Odpowiedź400 · invalid_request_errorWarunekNie można odczytać żądania lub indeks pobierania jest nieprawidłowy.Następny krokPopraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie.
Odpowiedź422 · price_unavailableWarunekNie można wycenić wybranej konfiguracji wideo.Następny krokWybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania.
Odpowiedź422 · invalid_request_errorWarunekWejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe.Następny krokUżywaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API.
Odpowiedź402 · billing_errorWarunekDostępne saldo lub limity nie pozwalają na rezerwację.Następny krokSprawdź dostępne saldo i limity przed wysłaniem nowego żądania.
Odpowiedź503 · server_errorWarunekWeryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne.Następny krokPoczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie.
Odpowiedź503 · result_pending_checkWarunekWynik pierwotnego wideo i opłata wymagają sprawdzenia.Następny krokZachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania.
Odpowiedź503 · owned_result_unavailableWarunekPobieranie istniejącego wideo jest chwilowo niedostępne.Następny krokSprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację.
Odpowiedź409 · video_not_readyWarunekTreść wideo nie została opublikowana.Następny krokSprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty.

Aliasy

Aliasy modelu

Ailoot Ultra kwaivgi/kling-video-o1

Aliasy ścieżek metod

Użyj ścieżek metod podanych powyżej.

Powiązane ID modeli

kwaivgi/kling-video-o1

", "method_identity": { "effective_request_model_id": "kwaivgi/kling-video-o1", "fmt": "videos", "http": "POST", "path": "/v1/videos", "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra" }, "method_key": "Ultra|videos|/v1/videos|kwaivgi%2Fkling-video-o1", "ordinal": 0, "rawMethod": { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Nie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Sprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API.", "type": "not_found_error" }, { "condition": "Klucz API nie odpowiada uwierzytelnionemu kontu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Sprawdź swój klucz API i dostęp do konta przed wysłaniem.", "type": "authentication_error" }, { "condition": "Nie można odczytać żądania lub indeks pobierania jest nieprawidłowy.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Popraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie.", "type": "invalid_request_error" }, { "condition": "Nie można wycenić wybranej konfiguracji wideo.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania.", "type": "price_unavailable" }, { "condition": "Wejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Używaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API.", "type": "invalid_request_error" }, { "condition": "Dostępne saldo lub limity nie pozwalają na rezerwację.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Sprawdź dostępne saldo i limity przed wysłaniem nowego żądania.", "type": "billing_error" }, { "condition": "Weryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Poczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Wynik pierwotnego wideo i opłata wymagają sprawdzenia.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Zachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Pobieranie istniejącego wideo jest chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Sprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację.", "type": "server_error" }, { "condition": "Treść wideo nie została opublikowana.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Sprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość; dodaj proporcje obrazu lub użyj rozmiaru z listy.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt tekstowy." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame z opcjonalnym last_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość; dodaj proporcje obrazu lub użyj rozmiaru z listy.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt tekstowy i obraz pierwszej klatki." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Pozycja tego wideo na liście wyników, liczona od zera.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Podpisany URL HTTPS do pobrania tego ukończonego wideo.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Skrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Rozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Zmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Szerokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Wysokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identyfikator kodeka wideo; null, jeśli go nie zapisano.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Czy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "podpisane adresy URL treści należących do użytkownika", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "kwaivgi/kling-video-o1" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Te klucze opisują każdy obiekt klatki; image_url zawiera wyłącznie url. Pomiń frame_images w żądaniu zawierającym wyłącznie tekst.", "content": "Tablica obiektów klatek. Każdy obiekt zawiera type=image_url, image_url z polem url oraz frame_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame_type na first_frame lub last_frame. Każda rola klatki może wystąpić najwyżej raz.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280", "720x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "kwaivgi/kling-video-o1" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Szacowany koszt generowania", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('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')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } } ], "model_id": "kwaivgi/kling-video-o1", "nativeProvenance": { "input_facts_canonical_sha256": "7b078c78580a92f487d2a32767ff6d61b0ae0fb25ae20ae28b69608adb7270c8", "input_html_sha256": "19bf601ae14f44235d009f693beea0756db0629af6933a84e253fc4d02a48262", "private_audit_sha256": "1c8d08ab2df5f4219e8594aa7a598abaa42d209485fa1243a723ff84c47fa601", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/pl/kwaivgi-kling-video-o1/", "description": "Kling VIDEO O1 to prowadzony referencjami model wideo Kuaishou do generowania i edycji scen z tekstem, obrazami, elementami podmiotów i klipem źródłowym. Korzystaj z profilu generacji od trzech do dziesięciu sekund do ciągłości wizualnej, prowadzonych przejść klatek i ukierunkowanych zmian istniejącego materiału.", "locale": "pl", "md_url": "https://ailoot.ai/models/pl/kwaivgi-kling-video-o1/index.md", "title": "Kling: Video O1 — Ailoot", "url": "https://ailoot.ai/models/pl/kwaivgi-kling-video-o1/" }, "rawModel": { "about": "Kling VIDEO O1 to zunifikowany, prowadzony referencjami model wideo Kuaishou. Łączy opis tekstowy z obrazami, przygotowanymi elementami podmiotów lub źródłowym filmem, prowadząc nowe sceny i ukierunkowane zmiany istniejącego materiału. Jego podstawowym interfejsem jest brief wizualny: wskaż materiał referencyjny, opisz jego rolę i określ wygląd, akcję lub przekształcenie oczekiwane w wynikowym wideo.\n\nNowe ujęcie może zacząć się od tekstu, obrazu otwierającego lub zestawu referencji wizualnych. Użyj obrazu do ustanowienia postaci lub obiektu i opisz słowami scenerię, akcję oraz punkt widzenia. Gdy kilka referencji wnosi różne cechy, jawnie przypisz ich role. Oryginalny brief produktu może przejąć obiekt z jednego obrazu, a otoczenie z drugiego, po czym opisać ruch obiektu w tej scenerii.\n\nPrompt O1 może nazywać obrazy, elementy i wideo konkretnymi znacznikami referencyjnymi, takimi jak <<>> lub <<>>. Zachowuj powiązanie znaczników z rzeczywiście dostarczonym materiałem i wyjaśniaj, co z niego przejąć. Limit promptu producenta wynosi 2500 znaków. Zwięzła instrukcja wskazująca podmiot i zmianę jest użyteczniejsza niż zbiór niepowiązanych określeń stylu.\n\nDla referencji obrazowych bez wejścia wideo udokumentowany łączny budżet wynosi do siedmiu obrazów referencyjnych i elementów wieloobrazowych. Przy filmie referencyjnym budżet obrazów i elementów wynosi cztery. Limity te dotyczą elementów opartych na obrazach; inne typy elementów mają osobne reguły zgodności. Wybieraj materiał dostarczający kluczowego wyglądu lub informacji o scenie, zamiast wypełniać budżet redundantnymi widokami.\n\nWejścia obrazowe używają JPG, JPEG lub PNG, dostarczanych jako dostępny URL lub dane obrazu, z plikami do 10 MB, wymiarami co najmniej 300 pikseli i proporcjami od 1:2.5 do 2.5:1. Przygotuj wyraźne podmioty i zachowaj ważne szczegóły w przycięciu. Jeśli zadanie wymaga rozpoznawalności postaci lub produktu, określ cechy do zachowania i kontroluj je w całym ukończonym klipie.\n\nKlatki początkowa i końcowa warunkują przejście między granicami wizualnymi. Udokumentowany proces klatek granicznych O1 wymaga pierwszej klatki, gdy dostarczono ostatnią, i nie obsługuje sterowania początkiem i końcem przy więcej niż dwóch obrazach w tablicy. Gdy używa się obu klatek granicznych, dodatkowe elementy podmiotów nie należą do tej konfiguracji O1. Oddziel zadanie sterowane klatkami od edycji dostarczonego wideo bazowego.\n\nFilm źródłowy może mieć dwie odrębne role. Jako klip bazowy jest materiałem do edycji: kieruj konkretnym dodaniem, usunięciem, opracowaniem stylu lub zmianą kompozycji, wskazując elementy do zachowania. Edycja podąża za długością wejściowego klipu i nie łączy zadania wideo bazowego ze sterowaniem klatkami granicznymi lub generacją wielu ujęć. Jako referencja cech film dostarcza treść, styl lub informacje kamery do nowego ujęcia.\n\nPromptowanie filmem referencyjnym może też żądać ujęcia poprzedzającego lub następującego. Wskaż klip źródłowy i opisz nowe widoczne zdarzenie, takie jak kontynuacja działania podmiotu lub odsłonięcie otaczającego środowiska. Wykorzystuje to referencję do przekazania informacji wizualnej; przed złożeniem nowego segmentu z oryginalnym materiałem oceń połączenie i ciągłość podmiotu.\n\nProfil wejścia wideo producenta przyjmuje jedno źródło MP4 lub MOV, do 200 MB, z minimalną długością trzech sekund. Szczegółowy profil wejścia określa wymiary od 720 do 2160 pikseli i liczbę klatek od 24 do 60 fps, z proporcjami wejściowymi od 1:2.5 do 2.5:1. Ten udokumentowany proces wideo źródłowego zwraca film 24 fps. Dokładna dozwolona długość klipu zależy też od wybranego profilu modelu. Zakres nowej generacji O1 wynosi od trzech do dziesięciu sekund i różni się od późniejszego zakresu 3.0 Omni.\n\nTryby O1 producenta zapewniają wyjście 720p Standard lub 1080p Pro. Kadrowanie nowych ujęć obsługuje udokumentowane wybory poziome, pionowe i kwadratowe tam, gdzie wybrany proces używa tego parametru; edycja bazowego wideo podąża za kadrowaniem źródła. Audio źródłowego wideo można zachować lub odrzucić. Proces referencji i edycji O1 powinien pozostawać odrębny od późniejszego profilu natywnego audio i własnego storyboardu 3.0 Omni.\n\nGeneracja tworzy zadanie, którego ukończony wynik zawiera materiał wideo i rzeczywistą długość. Dokumentacja wyników producenta mówi, że generowane filmy są usuwane po 30 dniach, więc niezwłocznie zapisz ukończony klip. Zachowaj z nim materiały źródłowe i brief, a następnie oceń żądaną zmianę, użycie referencji i ciągłość. W edycji porównuj zmieniany obszar i części do zachowania. W nowym ujęciu prowadzonym referencjami sprawdź, czy każdy materiał dostarczył zamierzoną informację wizualną. Zachowaj ukończony klip do późniejszego montażu lub sekwencji produkcyjnej.", "alias_of": null, "aliases": [], "author": "Kuaishou", "available": null, "canonical_model": "kwaivgi/kling-video-o1", "capabilities": { "context_length": 0, "manufacturer_input": [ "text", "image" ], "manufacturer_output": [ "video" ] }, "card_routes": [ { "label": "Ultra", "rates": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ], "summary": "Pełny cennik konfiguracji w szczegółach." } ], "ctx": null, "declared_tariff_references": [ { "client_selectable": false, "key": "5674106f0bbce742cc7b0c00", "label": "Referencje cenowe konfiguracji wideo", "profiles": [ { "basis": "Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji.", "dimensions": { "conditions": "W tym kluczu cenowym nie zadeklarowano dodatkowego warunku." }, "label": "Cena wideo", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "key": "video_second", "label": "Video price", "public_unit_label": "per video second", "quantity": 1, "rate_role": "typed_video_second_reference", "side": "out", "unit": "video_second" } ] } ] } ], "entity_type": "model", "formats": [ "videos" ], "id": "kwaivgi/kling-video-o1", "input": [ "text", "image" ], "kind": "video", "max_out": null, "methods": [ { "available": null, "billing_basis": { "basis": "original_invoice_usd", "description": "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.", "forecast_quantity_is_estimate": true, "physical_output_is_billable_quantity": false, "version": "original_invoice_usd_v1" }, "cache_read": null, "cache_write": null, "cache_write_1h": null, "contract": { "data": { "all_results": "Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.", "defaults": { "aspect_ratio": null, "duration": null, "generate_audio": "endpoint capability flag when published; omitted unknown stays unknown; never guarantees audio track", "resolution": null, "seed": null, "size": null, "wire_omissions_preserved": true }, "errors": [ { "condition": "Nie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo.", "http_status": 404, "public_identifier_field": "error.type", "recovery": "Sprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API.", "type": "not_found_error" }, { "condition": "Klucz API nie odpowiada uwierzytelnionemu kontu.", "http_status": 401, "public_identifier_field": "error.type", "recovery": "Sprawdź swój klucz API i dostęp do konta przed wysłaniem.", "type": "authentication_error" }, { "condition": "Nie można odczytać żądania lub indeks pobierania jest nieprawidłowy.", "http_status": 400, "public_identifier_field": "error.type", "recovery": "Popraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie.", "type": "invalid_request_error" }, { "condition": "Nie można wycenić wybranej konfiguracji wideo.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Wybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania.", "type": "price_unavailable" }, { "condition": "Wejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe.", "http_status": 422, "public_identifier_field": "error.type", "recovery": "Używaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API.", "type": "invalid_request_error" }, { "condition": "Dostępne saldo lub limity nie pozwalają na rezerwację.", "http_status": 402, "public_identifier_field": "error.type", "recovery": "Sprawdź dostępne saldo i limity przed wysłaniem nowego żądania.", "type": "billing_error" }, { "condition": "Weryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.type", "recovery": "Poczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie.", "type": "server_error" }, { "code": "result_pending_check", "condition": "Wynik pierwotnego wideo i opłata wymagają sprawdzenia.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Zachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania.", "type": "server_error" }, { "code": "owned_result_unavailable", "condition": "Pobieranie istniejącego wideo jest chwilowo niedostępne.", "http_status": 503, "public_identifier_field": "error.code", "recovery": "Sprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację.", "type": "server_error" }, { "condition": "Treść wideo nie została opublikowana.", "http_status": 409, "public_identifier_field": "error.type", "recovery": "Sprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty.", "type": "video_not_ready" } ], "hints": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "ignored_fields": [], "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania" }, "material_combinations": [ { "mode": "text_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość; dodaj proporcje obrazu lub użyj rozmiaru z listy.", "required": [ "model", "prompt", "duration" ], "required_material": "Prompt tekstowy." }, { "exact_keys": [ "type", "image_url", "frame_type" ], "mode": "image_to_video", "model": { "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "type": "string" }, "prompt": { "max_utf8_bytes": 10000, "non_whitespace": true, "type": "string" }, "representation": "frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame z opcjonalnym last_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość; dodaj proporcje obrazu lub użyj rozmiaru z listy.", "required": [ "model", "prompt", "duration", "frame_images" ], "required_material": "Prompt tekstowy i obraz pierwszej klatki." } ], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "outputs": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Pozycja tego wideo na liście wyników, liczona od zera.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Podpisany URL HTTPS do pobrania tego ukończonego wideo.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "Skrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Rozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Zmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Szerokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Wysokość wideo w pikselach; null, jeśli jest niedostępna.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Identyfikator kodeka wideo; null, jeśli go nie zapisano.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Czy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Identyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "podpisane adresy URL treści należących do użytkownika", "unmeasured_fields_nullable": true }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "kwaivgi/kling-video-o1" ], "enum_known": true, "name": "model", "required": true, "schema": { "const": "kwaivgi/kling-video-o1" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "minLength": 1, "name": "prompt", "required": true, "schema": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ 5, 10 ], "enum_known": true, "maximum": 600, "minimum": 1, "name": "duration", "required": true, "schema": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "type": "integer" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "720p" ], "enum_known": true, "name": "resolution", "required": false, "schema": { "enum": [ "720p" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "16:9", "9:16", "1:1" ], "enum_known": true, "name": "aspect_ratio", "required": false, "schema": { "enum": [ "16:9", "9:16", "1:1" ] }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ false, true ], "enum_known": true, "name": "generate_audio", "required": false, "schema": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "type": "boolean" }, { "availability": "source_interface", "conditions": "Te klucze opisują każdy obiekt klatki; image_url zawiera wyłącznie url. Pomiń frame_images w żądaniu zawierającym wyłącznie tekst.", "content": "Tablica obiektów klatek. Każdy obiekt zawiera type=image_url, image_url z polem url oraz frame_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame_type na first_frame lub last_frame. Każda rola klatki może wystąpić najwyżej raz.", "default": null, "default_known": false, "enum": null, "enum_known": false, "exact_keys": [ "type", "image_url", "frame_type" ], "maxItems": 2, "max_items": 2, "minItems": 1, "min_items": 1, "name": "frame_images", "required": false, "schema": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxItems": 0, "name": "input_references", "required": false, "schema": { "items": false, "maxItems": 0, "type": "array" }, "type": "array" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "1280x720", "720x1280", "720x720" ], "enum_known": true, "name": "size", "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "required": false, "schema": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "callback_url", "pattern": "^https://", "required": false, "schema": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "session_id", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "trace", "required": false, "schema": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "type": "object" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "maxLength": 256, "name": "user", "required": false, "schema": { "maxLength": 256, "type": "string" }, "type": "string" } ], "request_schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "aspect_ratio": { "enum": [ "16:9", "9:16", "1:1" ] }, "callback_url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" }, "creativity": false, "duration": { "enum": [ 5, 10 ], "maximum": 600, "minimum": 1, "type": "integer" }, "frame_images": { "items": { "additionalProperties": false, "properties": { "frame_type": { "enum": [ "first_frame", "last_frame" ] }, "image_url": { "additionalProperties": false, "properties": { "url": { "format": "uri", "pattern": "^https://", "type": "string", "x-source-rule": "public HTTPS; no userinfo, fragment, whitespace, private/reserved hosts; own-media links additionally require owner/signature/status/hash/MIME/bytes" } }, "required": [ "url" ], "type": "object" }, "type": { "const": "image_url" } }, "required": [ "type", "image_url", "frame_type" ], "type": "object" }, "maxItems": 2, "minItems": 1, "type": "array", "x-source-unique-role": "frame_type" }, "generate_audio": { "enum": [ false, true ], "x-omitted-default": "published audio capability when true/false; unknown if null; output audio must be measured" }, "input_references": { "items": false, "maxItems": 0, "type": "array" }, "model": { "const": "kwaivgi/kling-video-o1" }, "previous_job_id": false, "prompt": { "minLength": 1, "type": "string", "x-source-max-utf8-bytes": 10000, "x-source-non-whitespace": true }, "provider": false, "resolution": { "enum": [ "720p" ] }, "seed": false, "session_id": { "maxLength": 256, "type": "string" }, "size": { "enum": [ "1280x720", "720x1280", "720x720" ], "pattern": "^[1-9][0-9]*x[1-9][0-9]*$", "type": "string" }, "trace": { "additionalProperties": true, "properties": { "generation_name": { "type": "string" }, "parent_span_id": { "type": "string" }, "span_name": { "type": "string" }, "trace_id": { "type": "string" }, "trace_name": { "type": "string" } }, "type": "object" }, "upscale_factor": false, "user": { "maxLength": 256, "type": "string" } }, "required": [ "model", "prompt", "duration" ], "title": "Video generation request", "type": "object", "x-source-global-rules": [ "No null values or duplicate keys at any JSON object level", "No duration/resolution/aspect default is inserted", "Prompt required for all21 despite broader official image-only schema", "A request must also pass model membership, exact price card, SKU selection and frozen quote construction", "Non-string known trace fields reject; other trace keys retain arbitrary JSON", "No n/output-count/client price fields accepted", "Provider passthrough disabled for all21; feed allowlist names do not supply provider slug/value contract" ], "x-source-material-combinations": [ "Exact model/card, positive published duration, model resolution/aspect membership and valid frozen quote are all required; independent enum arrays are not proven provider Cartesian combinations.", "Use exact published size or compatible resolution/aspect. Omitted options stay omitted; no guessed geometry.", "first_frame/last_frame roles each occur at most once; frame_images wins mode precedence over input_references.", "provider options are unavailable for this model despite any published passthrough-name allowlist." ] }, "unsupported": [ "seed", "provider", "previous_job_id", "upscale_factor", "creativity" ] }, "input": { "additional_properties": false, "content_type": "application/json", "material_types": [ "text", "image" ], "optional_controls": [ "resolution", "aspect_ratio", "generate_audio", "frame_images", "input_references", "size", "callback_url", "session_id", "trace", "user" ], "required": [ "model", "prompt", "duration" ] }, "lifecycle": { "cancel_endpoint": null, "content": [ { "http": "GET", "path": "/v1/videos/{public_id}/content", "query": { "index": "actual output index" } } ], "create": { "http": "POST", "path": "/v1/videos" }, "mode": "submit_once_poll_original", "public_id": "video_; owner user/key/group scope", "status": [ { "http": "GET", "path": "/v1/videos/{public_id}" } ], "submit_status": 202, "terminal_failure_public": "200 failed + charge_pending_check=true; inspect original operation", "terminal_provider_states": [ "failed", "cancelled", "expired" ], "unknown": "503 result_pending_check + originalid + X-Should-Retry:false; never replay original" }, "method": { "http": "POST", "path": "/v1/videos" }, "method_aliases": [], "operation_modes": [ "text_to_video", "image_to_video_frame_images" ], "output": { "content_range_supported": true, "every_actual_output": true, "family": "video", "fields": [ { "condition": "Always present for each completed output.", "description": "Zero-based position of this video in the outputs list.", "field_path": "outputs[].index", "json_schema": { "type": "integer" }, "name": "index", "nullable": false, "type": "integer" }, { "condition": "Present after the owned result is available and a signed URL is created.", "description": "Signed HTTPS download URL for this completed video.", "field_path": "outputs[].content_url", "json_schema": { "type": "string" }, "name": "content_url", "nullable": false, "type": "string" }, { "condition": "A nonempty recorded digest is returned; otherwise null.", "description": "SHA-256 digest of the original video bytes; null if unavailable.", "field_path": "outputs[].sha256", "json_schema": { "type": [ "string", "null" ] }, "name": "sha256", "nullable": true, "type": "string | null" }, { "condition": "Returned when the recorded file size is positive.", "description": "Size of the original video file in bytes; null if unavailable.", "field_path": "outputs[].size_bytes", "json_schema": { "type": [ "integer", "null" ] }, "name": "size_bytes", "nullable": true, "type": "integer | null" }, { "condition": "Returned when the measured duration is positive.", "description": "Measured video duration in milliseconds; null if unavailable.", "field_path": "outputs[].duration_ms", "json_schema": { "type": [ "integer", "null" ] }, "name": "duration_ms", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video width in pixels; null if unavailable.", "field_path": "outputs[].width", "json_schema": { "type": [ "integer", "null" ] }, "name": "width", "nullable": true, "type": "integer | null" }, { "condition": "Width, height and the video codec are returned together when recorded.", "description": "Video height in pixels; null if unavailable.", "field_path": "outputs[].height", "json_schema": { "type": [ "integer", "null" ] }, "name": "height", "nullable": true, "type": "integer | null" }, { "condition": "Returned together with positive recorded width and height.", "description": "Video codec identifier; null if not recorded.", "field_path": "outputs[].video_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "video_codec", "nullable": true, "type": "string | null" }, { "condition": "Returned when width, height and the video codec are recorded; false is a known result.", "description": "Whether the video contains an audio track; null if not measured.", "field_path": "outputs[].has_audio", "json_schema": { "type": [ "boolean", "null" ] }, "name": "has_audio", "nullable": true, "type": "boolean | null" }, { "condition": "Returned when video metadata is recorded and the audio codec identifier is nonempty.", "description": "Audio codec identifier; null when no identifier is recorded.", "field_path": "outputs[].audio_codec", "json_schema": { "type": [ "string", "null" ] }, "name": "audio_codec", "nullable": true, "type": "string | null" } ], "format": "original MP4 bytes; no normalization/transcode", "max_aggregate_seconds": 2400, "max_bytes_per_output": 67108864, "max_seconds_per_output": 600, "result": "signed owned content URLs", "unmeasured_fields_nullable": true } }, "ctx": null, "declared_pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Szacowany koszt generowania", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "examples": [ { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_REQUEST'\nfrom pathlib import Path\nPath('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')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('result.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "curl · create video", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\npython3 - <<'PY_STATUS_URL'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nr=json.loads(Path('result.json').read_text())\nif not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')\nPath('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))\nPY_STATUS_URL\ncurl --fail-with-body --silent --show-error \"$(cat status-url.txt)\" \\\n -H \"Authorization: Bearer $AILOOT_API_KEY\" -D status-headers.txt -o status.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\nr=json.loads(Path('status.json').read_text())\nprint(json.dumps(r,ensure_ascii=False,indent=2))\nprint('Keep the complete JSON and response headers; do not resubmit an unknown creation.')\nPY_RESULT\n", "label": "GET original status", "language": "bash" }, { "code": "set -eu\n: \"${AILOOT_API_KEY:?Set your Ailoot API key}\"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path('status.json').read_text())\nif r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')\nif not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')\nurls=[]\nfor i,u in enumerate(r.get('data',[])):\n if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')\n urls.append((str(i),u))\nfor label,path in urls:\n u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)\n 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')\n target=Path('owned-'+label+'.bin')\n 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)\nprint('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')\nPY_ASSETS\n", "label": "Save every completed owned output", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "videos", "hints": [], "http": "POST", "in": null, "input": [ "text", "image" ], "label": "Видео", "max_out": null, "max_reasoning_effort_multiplier": null, "method_aliases": [], "out": null, "output": [ "video" ], "path": "/v1/videos", "price_conditions": [ { "label": "Fast mode", "value": "Not specified", "when": "When fast mode is selected" }, { "label": "Flex mode", "value": "Not specified", "when": "When flex mode is selected" }, { "label": "Maximum reasoning effort", "value": "Not specified", "when": "When maximum reasoning effort uses the default adjustment" } ], "pricing": { "billing_mode": "original_invoice_usd", "image_input_price": null, "image_output_price": null }, "pricing_profiles": [ { "dimensions": { "regime": "base" }, "label": "Base token rates", "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" } ] }, { "dimensions": { "conditions": "No additional condition is declared in this pricing key.", "quoted_unit": "per video second" }, "label": "Video price", "units": [ { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" } ] }, { "basis": "This estimate is not an additional charge or a fixed rate for the completed generation.", "dimensions": { "forecast_quantity": "one generation estimate" }, "label": "Estimated generation cost", "units": [ { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra", "status_reads": [ "GET /v1/videos/{public_id}", "GET /v1/videos/{public_id}/content" ], "tiers": [], "units": [ { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "input_price", "label": "Input tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "output_price", "label": "Output tokens", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "output_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "output_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_read_price", "label": "Cache read", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "cached_input_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "cached_input_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_price", "label": "Cache write", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "generic_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "generic_cache_creation_token" }, { "amount": null, "amount_unit": "usd_per_thousand_tokens", "billing_input": false, "estimate_only": true, "key": "cache_write_1h_price", "label": "Cache write, 1 hour", "native_amount_usd_per_unit": null, "native_quantity": 1, "native_unit": "one_hour_cache_creation_token", "public_unit_label": "/ 1K tokens", "quantity": 1000, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "in", "unit": "one_hour_cache_creation_token" }, { "amount": "0.224", "amount_unit": "usd_per_video_second", "billing_input": false, "estimate_only": true, "key": "duration_seconds", "label": "Video price", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "public_unit_label": "per video second", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "video_second" }, { "amount": "1.12", "amount_unit": "usd_per_exact_native_unit", "billing_input": false, "estimate_only": true, "key": "forecast_usd", "label": "Estimated generation cost", "native_amount_usd_per_unit": "1.12", "native_quantity": 1, "public_unit_label": "estimate before generation", "quantity": 1, "quantity_is_estimate": true, "rate_role": "typed_native_retail_rate", "side": "out", "unit": "request_estimate" } ] } ], "model_aliases": [ { "canonical_model_id": "kwaivgi/kling-video-o1", "request_model_id": "kwaivgi/kling-video-o1", "route_label": "Ultra" } ], "name": "Kling: Video O1", "price": { "estimate_only": true, "in": null, "in_label": null, "out": 1.12, "out_label": "estimate before generation", "scope_label": "Estimated generation cost", "sort_in": null, "sort_out": 1.12, "varies": false }, "pricing_profiles": [ { "applicability": { "client_selectable": false, "native_profile_selection_pending": true, "scope": "hosted_reference" }, "dimensions": { "published_labels": [], "variant": "duration_seconds" }, "label": "Ultra", "units": [ { "amount": "0.2240", "amount_unit": "usd_per_second", "conditions": { "published_labels": [], "variant": "duration_seconds" }, "key": "duration_seconds", "label": "duration seconds", "profile_index": 0, "quantity": "1", "rate_role": "binding_component_rate", "side": "out", "unit": "second" } ] }, { "applicability": { "client_selectable": false, "no_method_admission_claim": true, "scope": "supplier_tariff_reference" }, "dimensions": {}, "label": "Ailoot Ultra · Tariff components", "units": [ { "amount": "0.224", "amount_unit": "usd_per_exact_physical_unit", "basis": "output second", "billing_original_currency": "USD", "billing_original_rate": "0.2240", "key": "duration_seconds", "label": "output second", "native_amount_usd_per_unit": "0.224", "native_quantity": 1, "quantity": 1, "side": "out", "unit": "output_second" } ] } ], "public_id": "kwaivgi/kling-video-o1", "short": "Kling VIDEO O1 to prowadzony referencjami model wideo Kuaishou do generowania i edycji scen z tekstem, obrazami, elementami podmiotów i klipem źródłowym. Korzystaj z profilu generacji od trzech do dziesięciu sekund do ciągłości wizualnej, prowadzonych przejść klatek i ukierunkowanych zmian istniejącego materiału." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "Kling VIDEO O1 to prowadzony referencjami model wideo Kuaishou do generowania i edycji scen z tekstem, obrazami, elementami podmiotów i klipem źródłowym. Korzystaj z profilu generacji od trzech do dziesięciu sekund do ciągłości wizualnej, prowadzonych przejść klatek i ukierunkowanych zmian istniejącego materiału.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "c956359e8eab8e85ce0dc6d2ec55b72fc7a92e332bb84a721e016c226485a4e9", "renderer_sha256": "1217dcf19a93e99ac1d6fd7bf974dc19adc12fea4bd4470c2601f04e48f688cb" }, "sourceRevision": "991136e46bfa857782738f63adaca044ef342c77813fdea4958e933980e0c02b" }