Kling Motion Control API doc
Documenti Kling Motion Control API per flussi di lavoro di immagini e video in movimento
Riferimento al controllo del movimento Kling
Documenti Kling Motion Control API per flussi di lavoro di immagini e video in movimento
Utilizza questa guida per l'integrazione Kling 2.6 Controllo del movimento tramite UlazAI API.
L'integrazione attuale utilizza model_slug="kling_3_0_motion_control" su
/api/v1/video-studio/generate/o il percorso di compatibilità
/api/v1/generate/video/ con video_model="kling_3_0_motion_control".
Invia esattamente un URL di immagine, l'URL di un video in movimento, uno prompt e una modalità qualità 720p o 1080p.
Endpoint principali
/api/v1/video-studio/generate/
/api/v1/video-studio/status/{job_id}/
/api/v1/generate/video/
Supporto attuale
1 URL immagine + 1 URL video in movimento
Uscita 720p o 1080p
Da 3 a 15 secondi
kling-2-6-motion-control-api-docs, ma il
lo slug del modello attuale per le integrazioni live lo è kling_3_0_motion_control.
Autenticazione
Invia un token al portatore o una chiave API ad ogni richiesta.
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Richiesta canonica
Questa richiesta va a /api/v1/video-studio/generate/.
È il contratto API preferito per le nuove integrazioni.
{
"model_slug": "kling_3_0_motion_control",
"prompt": "No distortion, the character's movements are consistent with the video.",
"input_image_urls": ["https://example.com/character.png"],
"input_video_urls": ["https://example.com/motion.mp4"],
"character_orientation": "video",
"quality_mode": "720p",
"duration_seconds": 15
}
Riferimento al campo
| Campo | Obbligatorio | Note |
|---|---|---|
model_slug |
Sì | Deve essere kling_3_0_motion_control |
prompt |
Sì | Massimo 2500 caratteri |
input_image_urls |
Sì | Esattamente un URL di immagine pubblica |
input_video_urls |
Sì | Esattamente l'URL di un video in movimento pubblico |
character_orientation |
No | Utilizzare video per seguire l'orientamento del filmato o image per mantenere l'inquadratura del personaggio caricato |
quality_mode |
Sì | Utilizzare 720p o 1080p |
duration_seconds |
Sì | Numero intero compreso tra 3 e 15. Il prezzo utilizza questa durata. |
Richiesta di compatibilità legacy
Questa richiesta va a /api/v1/generate/video/.
Usalo se ti integri già con il vecchio video autenticato API.
{
"video_model": "kling_3_0_motion_control",
"prompt": "No distortion, the character's movements are consistent with the video.",
"source_image_urls": ["https://example.com/character.png"],
"video_urls": ["https://example.com/motion.mp4"],
"character_orientation": "video",
"quality_mode": "720p",
"duration_seconds": 15
}
Esempi di risposta
Canonical genera risposta
{
"success": true,
"job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
"credits_remaining_total": 438
}
L'eredità genera risposta
{
"success": true,
"data": {
"generation_id": "7f8cfd64-5b91-4a31-a987-e0ea8fd9d0a1",
"generation_type": "video",
"video_model": "kling30_motion",
"mode": "image-to-video",
"status": "processing",
"credits_used": 300
}
}
Sondaggio sullo stato
GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/
Prezzi
I prezzi di Motion Control sono basati sulla durata.