Zum Inhalt springen

Kling Motion Control API-Dokumente

Kling Motion Control API-Dokumente für Bild- und Bewegungsvideo-Workflows

Referenz zur Bewegungssteuerung von Kling

Kling Motion Control API-Dokumente für Bild- und Bewegungsvideo-Workflows

Nutzen Sie diesen Leitfaden zur Integration Kling 2.6 Bewegungssteuerung durch UlazAI API. Die aktuelle Integration verwendet model_slug="kling_3_0_motion_control" auf /api/v1/video-studio/generate/, oder der Kompatibilitätspfad /api/v1/generate/video/ mit video_model="kling_3_0_motion_control". Sie senden genau eine Bild-URL, eine Motion-Video-URL, ein prompt und ein 720p- oder 1080p-Qualitätsmodus.

Kernendpunkte

/api/v1/video-studio/generate/

/api/v1/video-studio/status/{job_id}/

/api/v1/generate/video/

Aktuelle Unterstützung

1 Bild-URL + 1 Bewegtvideo-URL

720p- oder 1080p-Ausgabe

3 bis 15 Sekunden

Routenhinweis: Die öffentliche URL sagt immer noch kling-2-6-motion-control-api-docs, aber die Aktuelles Modell Slug für Live-Integrationen ist kling_3_0_motion_control.
Verwenden Sie den Kompatibilitätsendpunkt nur, wenn Sie bereits mit dem älteren authentifizierten Video API versenden.

Authentifizierung

Senden Sie bei jeder Anfrage einen Bearer-Token oder einen API-Schlüssel.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kanonische Anfrage

Diese Anfrage geht an /api/v1/video-studio/generate/. Es ist der bevorzugte API-Vertrag für neue Integrationen.

{
  "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
}

Feldreferenz

Feld Erforderlich Notizen
model_slug Ja Muss sein kling_3_0_motion_control
prompt Ja Maximal 2500 Zeichen
input_image_urls Ja Genau eine öffentliche Bild-URL
input_video_urls Ja Genau eine öffentliche Video-URL
character_orientation Nein Benutzen video um der Ausrichtung des Bewegungsclips zu folgen oder image um den hochgeladenen Zeichenrahmen beizubehalten
quality_mode Ja Benutzen 720p oder 1080p
duration_seconds Ja Ganzzahl von 3 bis 15. Bei der Preisgestaltung wird diese Dauer verwendet.

Anfrage zur Legacy-Kompatibilität

Diese Anfrage geht an /api/v1/generate/video/. Verwenden Sie es, wenn Sie bereits das ältere authentifizierte Video API integrieren.

{
  "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
}

Antwortbeispiele

Kanonische Antwort generieren

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Legacy erzeugt Reaktion

{
  "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
  }
}

Statusabfrage

GET /api/v1/video-studio/status/{job_id}/
GET /api/v1/generate/{generation_id}/

Preise

Die Preise für Motion Control basieren auf der Dauer.

720p
20 Credits / Sekunde
1080p
27 Credits / Sekunde

Credits, Models und Status