Ugrás a tartalomra

Kling Motion Control API dok

Kling Motion Control API dokumentumok kép és mozgó videó munkafolyamatokhoz

Kling mozgásvezérlő referencia

Kling Motion Control API dokumentumok kép és mozgó videó munkafolyamatokhoz

Az integráláshoz használja ezt az útmutatót Kling 2.6 Mozgásvezérlés a UlazAI API-n keresztül. A jelenlegi integráció használja model_slug="kling_3_0_motion_control" be /api/v1/video-studio/generate/vagy a kompatibilitási útvonalat /api/v1/generate/video/ -val video_model="kling_3_0_motion_control". Pontosan küldöd egy kép URL-je, egy mozgó videó URL-je, egy prompt és egy 720p vagy 1080p minőségi mód.

Alapvető végpontok

/api/v1/video-studio/generate/

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

/api/v1/generate/video/

Jelenlegi támogatás

1 kép URL + 1 mozgó videó URL

720p vagy 1080p kimenet

3-15 másodpercig

Útvonal megjegyzés: a nyilvános URL továbbra is azt mondja kling-2-6-motion-control-api-docs, hanem a az élő integrációk jelenlegi modellje kling_3_0_motion_control.
Csak akkor használja a kompatibilitási végpontot, ha már a régi hitelesített API videóval együtt szállítja.

Hitelesítés

Minden kérésre küldjön egy hordozó tokent vagy API kulcsot.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Kanonikus kérés

Ez a kérés címre vonatkozik /api/v1/video-studio/generate/. Ez az előnyben részesített API szerződés az új integrációkhoz.

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

Mezőhivatkozás

Mező Kötelező Megjegyzések
model_slug Igen Kell lennie kling_3_0_motion_control
prompt Igen Maximum 2500 karakter
input_image_urls Igen Pontosan egy nyilvános kép URL-je
input_video_urls Igen Pontosan egy nyilvános mozgókép URL-je
character_orientation Nem Használja video hogy kövesse a mozgó klip tájolását ill image hogy a feltöltött karakter keretezése megmaradjon
quality_mode Igen Használja 720p vagy 1080p
duration_seconds Igen Egész szám 3 és 15 között. Az árképzés ezt az időtartamot használja.

Korábbi kompatibilitási kérelem

Ez a kérés címre vonatkozik /api/v1/generate/video/. Használja, ha már integrálta a régebbi hitelesített API videót.

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

Válasz példák

Canonical választ generál

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

Legacy választ generál

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

Állapot lekérdezés

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

Árképzés

A Motion Control árképzése időtartam alapú.

720p
20 kredit / másodperc
1080p
27 kredit / másodperc

Kreditek, modellek és állapot