Przejdź do treści
UlazAI

Dokumentacja programisty UlazAI

Dokumentacja Kling 3.0 API do generowania, przesyłania i wyceny

Wycena Panel Pracownia obrazu

Numer referencyjny Kling 3.0

Dokumentacja Kling 3.0 API do generowania, przesyłania i wyceny

Aby skorzystać z Kling 3.0 API, zacznij tutaj: używać POST /kling30/api/generate/ do tworzenia miejsc pracy, GET /kling30/api/status/{task_id}/ do sprawdzania stanu wyjścia oraz POST /kling30/api/upload/ dla ramek źródłowych. Obsługuje UlazAI zamiana tekstu na wideo i obraz-wideo z opcjonalnym dźwiękiem, obsługa wielu zdjęć, kontrola klatek początkowych i końcowych oraz wycena za sekundę w trybach jakości standardowej, profesjonalnej i 4K.

Podstawowe punkty końcowe

POST /kling30/api/generate/

GET /kling30/api/status/{task_id}/

POST /kling30/api/upload/

Bieżące wsparcie

Renderowanie od 3 do 15 sekund

Jakość standardowa, profesjonalna lub 4K

Sterowanie dźwiękiem, wieloma ujęciami i ramkami

Kolejne trasy

Kup kredyty

Otwórz studio Kling 3.0

Otwórz kanoniczną dokumentację wideo API

Cena dotyczy sekundy. Czas trwania obsługuje całe sekundy od 3 do 15. Możesz włączyć opcję Prompt Directory, aby zastosować natychmiast -10 kredyty rabat.

POST /kling30/api/generate/

Utwórz zadanie generowania Kling 3.0.

Uwierzytelnianie

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Treść żądania

{
  "prompt": "A cinematic tracking shot following a cyclist through a rainy neon city street.",
  "generationMode": "text_to_video",
  "durationSeconds": 8,
  "qualityMode": "4K",
  "sound": true,
  "multiShots": true,
  "aspectRatio": "16:9",
  "prompt_directory_optin": true
}

Przykład zamiany obrazu na wideo

{
  "prompt": "The portrait slowly smiles while camera pushes in.",
  "generationMode": "image_to_video",
  "imageUrls": ["https://example.com/source.jpg"],
  "durationSeconds": 5,
  "qualityMode": "std",
  "sound": false,
  "startFrameUrl": "https://example.com/start.jpg",
  "endFrameUrl": "https://example.com/end.jpg"
}

Odniesienie do pola

prompt (ciąg, wymagany, maks. 2500)

Tryb generacji (wymagane): text_to_video lub image_to_video

adresy URL obrazu (tablica): wymagana w przypadku konwersji obrazu na wideo, chyba że podano adresy URL ramek

czas trwaniaSekundy (wymagane): liczba całkowita 3..15

tryb jakości (wymagane): std, prolub 4K

dźwięk (opcjonalnie, wartość logiczna)

multiShoty (opcjonalnie, wartość logiczna)

współczynnik proporcji (opcjonalnie): 16:9, 9:16, 1:1 (niedozwolone, jeśli ustawione są adresy URL ramek początkowych/końcowych)

adres URL ramki początkowej, endFrameUrl (opcjonalne adresy URL http(s))

prompt_directory_optin (opcjonalne, logiczne): zastosuj natychmiastową zniżkę i automatyczne udostępnianie w przypadku powodzenia

Odpowiedź sukcesu

{
  "success": true,
  "task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
  "provider_task_id": "281e5b0...f39b9",
  "status": "processing",
  "credits_used": 310,
  "directory_discount_applied": 10,
  "estimated_time": "varies by queue"
}
DOBIERZ /kling30/api/status/{task_id}/

Po ukończeniu uzyskaj status zadania i wyjściowy adres URL.

{
  "success": true,
  "task_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
  "status": "completed",
  "video_url": "https://cdn.example.com/path/output.mp4",
  "credits_charged": 310,
  "prompt_submission_id": "70f4f6a9-2d17-4f31-81ac-8d57eecb9e21"
}

Wartości stanu: pending, processing, completed, failed. W przypadku niepowodzenia kredyty są zwracane automatycznie.

POST /kling30/api/upload/

Prześlij obrazy ramki źródłowej/początkowej/końcowej (JPEG/PNG/WebP, maks. 10 MB) i uzyskaj publiczny adres URL na potrzeby żądań generowania.

Matryca cenowa (kredyty na sekundę)

Standard

Brak dźwięku: 20 / s

Z dźwiękiem: 30 / s

Zawodowiec

Brak dźwięku: 27 / s

Z dźwiękiem: 40 / s

4K

67 / s

przykład cURL

curl -X POST https://ulazai.com/kling30/api/generate/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A heroic wide shot of a spaceship entering orbit above Earth.",
    "generationMode": "text_to_video",
    "durationSeconds": 10,
    "qualityMode": "pro",
    "sound": true,
    "multiShots": true,
    "aspectRatio": "16:9",
    "prompt_directory_optin": true
  }'

Kody błędów

  • 400 nieprawidłowy ładunek
  • 401 nieprawidłowe uwierzytelnienie
  • 402 niewystarczające kredyty
  • 429 ograniczona stawka
  • 500 upstream/dostawca lub awaria wewnętrzna

Kredyty, modele i status

Kup kredyty Otwórz studio Kling 3.0 Otwórz kanoniczne dokumenty wideo Otwórz podest Kling 3.0