Używaj Kling 3.0 Turbo przez Rivya Public API v1 z identyfikatorem modelu kling-3-turbo, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APITekst lub URL gotowe; tryby referencyjne używają Files APIWideo

Identyfikator modelu API

kling-3-turbo

Wejścia

text, file

Files API

Wymagane dla trybów referencyjnych

Kredyty bazowe

per_output_second · 720p=18 · 1080p=22.5 · ⌈total⌉

Możliwość

Wideo

Rozliczenia

METERED

Limit promptu

2500 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	kling-3-turbo	Użyj kling-3-turbo jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 2500 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
resolution	select	Nie	720p	-	720p, 1080p	Wybrana rozdzielczość ustala także stawkę kredytów za sekundę wyniku.
duration	number	Nie	5	min 3 / max 15 / step 1	-	Wybierz całkowity czas wyniku od 3 do 15 sekund.
aspect_ratio	select	Nie	16:9	-	1:1, 9:16, 16:9	Dostępne tylko dla text-to-video; ustawienie jest ukrywane po użyciu jednego obrazu.

Zasady przesyłania

Najpierw prześlij pliki referencyjne, a potem umieść zwrócony URL i token czasu trwania w params.referenceMediaItems.

Reguła referencji

Opcjonalny obraz początkowy: Dla image-to-video prześlij dokładnie jeden obraz JPEG lub PNG o rozmiarze do 10 MB. Text-to-video nie używa przesłanych mediów.

Maks. plików

Akceptowane rodzaje plików

image

Token czasu trwania

Referencje wideo i audio powinny zawierać durationToken z /api/v1/files, gdy wymagana jest weryfikacja czasu trwania.

kind	Maks. rozmiar	Typy MIME
image	10 MB	image/jpeg, image/png

Żądanie minimalne

{
  "model": "kling-3-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }
}

Żądanie z plikiem referencyjnym

{
  "model": "kling-3-turbo",
  "prompt": "A cinematic product reveal with smooth camera movement",
  "params": {
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9",
    "referenceMediaItems": [
      {
        "url": "https://cdn.example.com/reference-image.png",
        "kind": "image",
        "name": "reference-image.png",
        "mimeType": "image/png",
        "width": 1024,
        "height": 1024,
        "sizeBytes": 1048576,
        "imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
      }
    ]
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się powodzeniem albo błędem.

{
  "id": "task_kling_3_turbo_example",
  "status": "queued",
  "model": "kling-3-turbo",
  "reserved_credits": 90,
  "final_credits": 0,
  "settlement_status": "RESERVED",
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found

Niektóre tryby wymagają przesłania materiałów referencyjnych przez Files API.

Integracja API Kling 3.0 Turbo