Kling: Video v3.0 Pro
Kling VIDEO 3.0 Pro to profesjonalny profil wideo 1080p firmy Kuaishou do scen kierowanych tekstem i obrazem. Łączy klipy od trzech do piętnastu sekund, natywny dźwięk, sterowanie klatkami granicznymi i wskazówki dla jednego lub wielu ujęć do koncepcji filmowych i krótkich produkcji.
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 3.0 Pro to profesjonalny profil modelu VIDEO 3.0 Kuaishou. Udokumentowany tryb Pro tworzy wideo 1080p z briefu tekstowego lub sceny opartej na obrazie, z klipami od trzech do piętnastu sekund. Wersja 3.0 łączy natywne audio, parametry spójności podmiotów i reżyserię wielu ujęć, dając krótkiej produkcji jasny sposób określenia wyglądu, akcji, pokrycia kamerą i dźwięku.
Zacznij od głównej akcji sceny. W ujęciu prowadzonym tekstem opisz podmiot, otoczenie, światło i punkt widzenia zapewniający czytelność akcji. W ujęciu opartym na obrazie niech obraz otwierający ustanawia wygląd i kompozycję, a tekst opisuje zmiany w czasie. W oryginalnej koncepcji produktu przygotowany obraz może pokazywać obiekt na powierzchni studyjnej, a prompt opisywać powolne odsłonięcie jego materiału i kształtu.
Reżyseria wielu ujęć oferuje automatyczne pokrycie lub własną sekwencję. Automatyczna generacja planuje zmiany kadrowania i kąta kamery na podstawie briefu; scena pasująca do jednego ciągłego widoku nadal może pozostać pojedynczym ujęciem. Własny storyboard pozwala zdefiniować treść i długość każdego ujęcia. Profil własnych ujęć producenta dopuszcza od jednego do sześciu ujęć, najwyżej 512 znaków na każde i minimum jedną sekundę na ujęcie; czasy muszą sumować się do całkowitej długości klipu.
W krótkiej narracji opisz widok ustanawiający, główną akcję i końcowy detal jako osobne ujęcia. Określ pracę kamery i to, co widz powinien zauważyć w każdym z nich. Zachowuj spójny wygląd powracającego podmiotu w briefie, celowo zmieniając akcję i pokrycie. Pole pojedynczego promptu w dokumentacji producenta przyjmuje do 2500 znaków; własna sekwencja korzysta z oddzielnych opisów ujęć.
Referencje podmiotów mogą wspierać scenę opartą na obrazie, gdy postać, produkt lub sceneria mają pozostać rozpoznawalne. Wybieraj wyraźne widoki przekazujące cechy do zachowania i konsekwentnie nazywaj każdy referencyjny podmiot. Udokumentowany profil oparty na obrazie pozwala wykorzystać do trzech przygotowanych elementów. Skupiaj role referencji, zamiast łączyć kilka materiałów dających sprzeczne instrukcje wyglądu podmiotu.
Pierwsza i ostatnia klatka zapewniają granice wizualne przejścia warunkowanego obrazem. Przygotuj klatki zgodne pod względem podmiotu i zamierzonej sceny, a następnie opisz łączący je ruch. Obsługiwane wejście klatek producenta używa obrazów JPG, JPEG lub PNG, plików nie większych niż 10 MB, wymiarów co najmniej 300 pikseli i proporcji pierwszego obrazu między 1:2.5 a 2.5:1. Zadanie sterowane klatkami i własny storyboard mają osobną obsługę wejścia, więc uporządkuj materiały do wybranego procesu przed napisaniem pełnego briefu.
Natywne audio może łączyć kwestie mówione, atmosferę i wykonanie wizualne. W dokumentacji producenta audio jest domyślnie wyłączone i włącza się je dla sceny audiowizualnej. Profil językowy 3.0 obejmuje chiński, angielski, japoński, koreański i hiszpański, z przełączaniem języków oraz obsługiwanymi dialektami lub akcentami. Przewodnik producenta mówi, że dialog wprowadzony w innym języku jest tłumaczony na angielski. Przypisz każdą kwestię zamierzonemu podmiotowi i odróżniaj dialog od dźwięku tła, aby brief audio wyjaśniał, kto mówi i co otacza akcję.
Oryginalny brief dwóch postaci może identyfikować Mówcę A i Mówcę B, nadać każdemu krótką kwestię i opisać widoczną reakcję między nimi. Zachowaj proporcję dialogu do długości klipu i identyfikuj mówcę przy zmianie widoku. Kierunek głosu i referencja postaci służą różnym celom; brief powinien określać zamierzone wykonanie, zamiast zakładać, że obraz referencyjny zawiera słowa do wypowiedzenia.
VIDEO 3.0 poprawia też obsługę widocznych liter w scenie opartej na obrazie. Jeśli ważny jest szyld, etykieta lub podpis, wskaż je w briefie i zachowaj wygląd referencji. Oceń ukończony klip pod kątem pisowni, czytelności i ruchu liter, szczególnie gdy niosą komunikat produktu lub kampanii. Funkcja liter modelu kieruje generacją, zamiast zastępować końcową kontrolę wizualną.
Profil Pro to 1080p; Standard to 720p. Osobno wybrany tryb 4K producenta jest innym profilem wyjściowym, więc Pro nie należy traktować jako synonimu każdego ustawienia wyższej rozdzielczości. Dla generacji tekstowej udokumentowane kadrowanie obejmuje 16:9, 9:16 i 1:1. Dobierz kadr do zamierzonego umiejscowienia i utrzymuj w nim czytelną kompozycję.
Generacja działa jako zadanie, którego udany wynik udostępnia ukończony 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 wideo z briefem i materiałami referencyjnymi, a następnie oceń ciągłość podmiotów, żądaną kolejność ujęć, ruch kamery, dialog i litery. Użyj wybranego klipu jako koncepcji filmowej, sceny produktu lub krótkiej narracji i dokonaj ukierunkowanej poprawki części, która nie osiągnęła zamierzonego wyniku.
Ailoot Ultra · Wideo POST /v1/videos kwaivgi/kling-v3.0-pro
kwaivgi/kling-v3.0-proStart
Kling VIDEO 3.0 Pro to profesjonalny profil wideo 1080p firmy Kuaishou do scen kierowanych tekstem i obrazem. Łączy klipy od trzech do piętnastu sekund, natywny dźwięk, sterowanie klatkami granicznymi i wskazówki dla jednego lub wielu ujęć do koncepcji filmowych i krótkich produkcji.
- Akceptowane dane wejściowe
- Tekst · Obrazy
- Wyniki
- Wideo
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
| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
|---|---|---|---|---|
Polemodel | Typstring | WymaganieWymagane | Wartości i limity kwaivgi/kling-v3.0-pro | Domyślnie— |
Poleprompt | Typstring | WymaganieWymagane | Wartości i limity | Domyślnie— |
Poleduration | Typinteger | WymaganieWymagane | Wartości i limity 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Domyślnie— |
Poleresolution | Typstring | WymaganieOpcjonalne | Wartości i limity 720p | Domyślnie— |
Poleaspect_ratio | Typstring | WymaganieOpcjonalne | Wartości i limity 16:9, 9:16, 1:1 | Domyślnie— |
Polegenerate_audio | Typboolean | WymaganieOpcjonalne | Wartości i limity false, true Warunki: Pominięcie tej opcji wybiera cenę z dźwiękiem. Ustaw false, aby wybrać cenę bez dźwięku. Sprawdź has_audio w wyniku, aby ustalić, czy zwrócono ścieżkę dźwiękową. | Domyślnie— |
Poleframe_images | Typarray | WymaganieOpcjonalne | Wartoś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_references | Typarray | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Polesize | Typstring | WymaganieOpcjonalne | Wartości i limity 1280x720, 720x1280, 720x720 Wzorzec: ^[1-9][0-9]*x[1-9][0-9]*$ | Domyślnie— |
Polecallback_url | Typstring | WymaganieOpcjonalne | Wartości i limity Wzorzec: ^https:// | Domyślnie— |
Polesession_id | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poletrace | Typobject | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
Poleuser | Typstring | WymaganieOpcjonalne | Wartości i limity | Domyś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-v3.0-pro
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-v3.0-pro
prompt: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak
Parametry i cykl życia metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontraktfalse |
Parametroptional_controls | Kontraktresolution, 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.
| Konfiguracja | Tabela stawek | Przewidywana ilość | Składnik opłaty | Rozdzielczość referencyjna | Tryb referencyjny | Dźwięk referencyjny | Jednostka rozliczeniowa | Warunki rozliczania | Opłata |
|---|---|---|---|---|---|---|---|---|---|
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Składnik opłaty— | Rozdzielczość referencyjna— | Tryb referencyjny— | Dźwięk referencyjny— | 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 |
| KonfiguracjaWyjściowe wideo · stawka referencyjna | Tabela stawek— | Przewidywana ilość— | Składnik opłatyreference_output_rate | Rozdzielczość referencyjna— | Tryb referencyjny— | Dźwięk referencyjny— | Jednostka rozliczeniowaza sekundę wyniku | Warunki rozliczania— | Opłata Wyjście · Referencyjna stawka za sekundę wideo na wyjściu · Szacunek tylko do porównania $0.224 za sekundę wyniku |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Składnik opłaty— | Rozdzielczość referencyjna— | Tryb referencyjny— | Dźwięk referencyjny— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniadźwięk: with_audio | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania $0.336 za sekundę wideo |
| KonfiguracjaWideo z obrazu (obrazy klatek) · 1080p · stawka referencyjna | Tabela stawek— | Przewidywana ilość— | Składnik opłatyreference_output_rate | Rozdzielczość referencyjna1080p | Tryb referencyjnyObraz na wideo (obrazy klatek) | Dźwięk referencyjnyBez dźwięku | Jednostka rozliczeniowaza sekundę wyniku | Warunki rozliczania— | Opłata Wyjście · Referencyjna stawka za sekundę wideo na wyjściu · Szacunek tylko do porównania $0.224 za sekundę wyniku |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Składnik opłaty— | Rozdzielczość referencyjna— | Tryb referencyjny— | Dźwięk referencyjny— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniatryb generowania: image_to_video; rozdzielczość: 720p | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania $0.224 za sekundę wideo |
| KonfiguracjaWideo z tekstu · 1080p · stawka referencyjna | Tabela stawek— | Przewidywana ilość— | Składnik opłatyreference_output_rate | Rozdzielczość referencyjna1080p | Tryb referencyjnyTekst na wideo | Dźwięk referencyjnyBez dźwięku | Jednostka rozliczeniowaza sekundę wyniku | Warunki rozliczania— | Opłata Wyjście · Referencyjna stawka za sekundę wideo na wyjściu · Szacunek tylko do porównania $0.224 za sekundę wyniku |
| KonfiguracjaWideo z tekstu · 480p · stawka referencyjna | Tabela stawek— | Przewidywana ilość— | Składnik opłatyreference_output_rate | Rozdzielczość referencyjna480p | Tryb referencyjnyTekst na wideo | Dźwięk referencyjnyBez dźwięku | Jednostka rozliczeniowaza sekundę wyniku | Warunki rozliczania— | Opłata Wyjście · Referencyjna stawka za sekundę wideo na wyjściu · Szacunek tylko do porównania $0.224 za sekundę wyniku |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Składnik opłaty— | Rozdzielczość referencyjna— | Tryb referencyjny— | Dźwięk referencyjny— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniatryb generowania: text_to_video; rozdzielczość: 720p | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania $0.224 za sekundę wideo |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Składnik opłaty— | Rozdzielczość referencyjna— | Tryb referencyjny— | Dźwięk referencyjny— | Jednostka rozliczeniowa— | Warunki rozliczania— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.672 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
Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.
| Konfiguracja | Warunki rozliczania | Opłata |
|---|---|---|
| KonfiguracjaCena wideo | Warunki 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. |
| KonfiguracjaCena wideo | Warunki rozliczaniadźwięk: with_audio | Opłata Wyjście · Cena wideo $0.336 za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: text_to_video; rozdzielczość: 480p | 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. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: text_to_video; rozdzielczość: 720p | 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. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: image_to_video; rozdzielczość: 720p | 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. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: text_to_video; rozdzielczość: 1080p | 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. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: image_to_video; rozdzielczość: 1080p | 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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"kwaivgi/kling-v3.0-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
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
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Inne odczyty treści
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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
| Pole | Typ | Znaczenie |
|---|---|---|
Poleindex | Typinteger | ZnaczeniePozycja tego wideo na liście wyników, liczona od zera. |
Polecontent_url | Typstring | ZnaczeniePodpisany URL HTTPS do pobrania tego ukończonego wideo. |
Polesha256 | Typstring | null | ZnaczenieSkrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny. |
Polesize_bytes | Typinteger | null | ZnaczenieRozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny. |
Poleduration_ms | Typinteger | null | ZnaczenieZmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny. |
Polewidth | Typinteger | null | ZnaczenieSzerokość wideo w pikselach; null, jeśli jest niedostępna. |
Poleheight | Typinteger | null | ZnaczenieWysokość wideo w pikselach; null, jeśli jest niedostępna. |
Polevideo_codec | Typstring | null | ZnaczenieIdentyfikator kodeka wideo; null, jeśli go nie zapisano. |
Polehas_audio | Typboolean | null | ZnaczenieCzy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono. |
Poleaudio_codec | Typstring | null | ZnaczenieIdentyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora. |
Błędy i dalsze kroki
| Odpowiedź | Warunek | Następny krok |
|---|---|---|
Odpowiedź404 · not_found_error | WarunekNie 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_error | WarunekKlucz API nie odpowiada uwierzytelnionemu kontu. | Następny krokSprawdź swój klucz API i dostęp do konta przed wysłaniem. |
Odpowiedź400 · invalid_request_error | WarunekNie 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_unavailable | WarunekNie 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_error | WarunekWejś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_error | WarunekDostępne saldo lub limity nie pozwalają na rezerwację. | Następny krokSprawdź dostępne saldo i limity przed wysłaniem nowego żądania. |
Odpowiedź503 · server_error | WarunekWeryfikacja 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_check | WarunekWynik 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_unavailable | WarunekPobieranie 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_ready | WarunekTreść 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-v3.0-pro
Aliasy ścieżek metod
Użyj ścieżek metod podanych powyżej.
Powiązane ID modeli
FAQ · Kling: Video v3.0 Pro
- Jakie dane wejściowe i wyniki są dostępne?
POST /v1/videos·kwaivgi/kling-v3.0-pro:text,image→video- Jakich pól używa żądanie?
POST /v1/videos·kwaivgi/kling-v3.0-pro:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,callback_url,session_id,trace,user- Jakie limity obowiązują?
POST /v1/videos·kwaivgi/kling-v3.0-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1