Vai al contenuto

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

Nota sul percorso: l'URL pubblico dice ancora kling-2-6-motion-control-api-docs, ma il lo slug del modello attuale per le integrazioni live lo è kling_3_0_motion_control.
Utilizza l'endpoint di compatibilità solo se effettui già spedizioni con il video autenticato legacy API.

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 Deve essere kling_3_0_motion_control
prompt Massimo 2500 caratteri
input_image_urls Esattamente un URL di immagine pubblica
input_video_urls 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 Utilizzare 720p o 1080p
duration_seconds 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.

720p
20 crediti/secondo
1080p
27 crediti/secondo

Crediti, modelli e status