Documenti per sviluppatori UlazAI
Kling 3.0 API documenti per generazione, caricamento e determinazione dei prezzi
Riferimento Kling 3.0
Kling 3.0 API documenti per generazione, caricamento e determinazione dei prezzi
Per utilizzare il Kling 3.0 API, inizia da qui:
utilizzare POST /kling30/api/generate/ per creare posti di lavoro,
GET /kling30/api/status/{task_id}/ per interrogare lo stato dell'uscita e
POST /kling30/api/upload/ per i frame di origine. UlazAI supporta
testo in video e immagine in video con audio opzionale,
scatti multipli, controllo del fotogramma iniziale e finale e tariffazione al secondo per le modalità di qualità standard, pro e 4K.
Endpoint principali
POST /kling30/api/generate/
GET /kling30/api/status/{task_id}/
POST /kling30/api/upload/
Supporto attuale
Rendering da 3 a 15 secondi
Qualità standard, professionale o 4K
Controllo audio, scatti multipli e fotogramma
Il prezzo è al secondo. La durata supporta interi secondi da 3 a
15. È possibile abilitare l'attivazione esplicita della directory Prompt per applicare un'autorizzazione immediata
-10 crediti sconto.
/kling30/api/generate/
Crea un'attività di generazione Kling 3.0.
Autenticazione
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonRichiedi corpo
{
"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
}Esempio di conversione da immagine a video
{
"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"
}Riferimento al campo
prompt (stringa, richiesta, max 2500)
generationMode (richiesto): text_to_video o image_to_video
URL immagine (array): richiesto per il trasferimento da immagine a video a meno che non vengano forniti gli URL dei frame
durataSecondi (obbligatorio): intero 3..15
qualitàModalità (richiesto): std, pro, o 4K
suono (facoltativo, booleano)
multiShots (facoltativo, booleano)
rapporto d'aspetto (facoltativo): 16:9, 9:16, 1:1 (non consentito quando sono impostati gli URL dei frame di inizio/fine)
startFrameUrl, endFrameUrl (URL http(s) facoltativi)
prompt_directory_optin (facoltativo, booleano): applica lo sconto immediato e la condivisione automatica in caso di successo
Risposta di successo
{
"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"
}/kling30/api/status/{task_id}/
Ottieni lo stato dell'attività e l'URL di output una volta completata.
{
"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"
}
Valori di stato: pending, processing, completed, failed.
In caso di fallimento, i crediti vengono rimborsati automaticamente.
/kling30/api/upload/
Carica immagini di origine/inizio/fine frame (JPEG/PNG/WebP, massimo 10 MB) e ricevi un URL pubblico per le richieste di generazione.
Matrice dei prezzi (crediti al secondo)
Standard
Nessun audio: 20 /s
Con audio: 30 /s
Pro
Nessun audio: 27 /s
Con audio: 40 /s
4K
67 /s
Esempio di arricciatura
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
}'Codici di errore
- 400 carico utile non valido
- 401 autenticazione non valida
- 402 crediti insufficienti
- 429 tariffa limitata
- 500 upstream/provider o guasto interno