Intégration API Kling 2.6 motion-control
Utilisez Kling 2.6 motion-control via Rivya Public API v1 avec le model id kling-2-6-motion-control, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.
kling-2-6-motion-control
file
Requis pour les modes avec référence
Tarif en crédits: 11–18 / seconde générée Le coût final de la tâche est arrondi au crédit entier supérieur.
Vidéo
METERED
2500 caractères
Contrat de requête
Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.
| Clé | Type | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
| model | string | Oui | kling-2-6-motion-control | Utilisez kling-2-6-motion-control comme ID de modèle API. |
| prompt | string | Non | - | Maximum 2500 caractères pour ce modèle. |
| params | object | Oui | - | Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées. |
| client_request_id | string | Non | - | ID côté client facultatif pour tracer les requêtes dans votre système. |
Paramètres du modèle
| Clé | Type | Obligatoire | Par défaut | Plage | Options | Description |
|---|---|---|---|---|---|---|
| mode | select | Non | 720p | - | 720p, 1080p | Résolution de résultat |
| character_orientation | select | Non | video | - | video, image | Contrôle si l'orientation du personnage doit rester plus proche de la vidéo de mouvement ou de l'image de référence. |
Règle d'importation
Importez d'abord les fichiers de référence, puis placez l'URL renvoyée et le durationToken dans params.referenceMediaItems.
Image de référence + vidéo de mouvement: Importez exactement 1 image de personnage et 1 clip de mouvement. Les deux doivent montrer clairement la tête, les épaules et le torse.
2
image, video
Les références vidéo et audio doivent inclure durationToken depuis /api/v1/files lorsqu'une vérification de durée est requise.
| kind | Taille max. | Types MIME |
|---|---|---|
| image | 10 MB | image/jpeg, image/png |
| video | 95 MB | video/mp4, video/quicktime |
Aucun exemple Public API exécutable n'est affiché pour ce modèle.
Requête avec fichier de référence
{
"model": "kling-2-6-motion-control",
"params": {
"mode": "720p",
"character_orientation": "video",
"referenceMediaItems": [
{
"url": "https://cdn.example.com/reference-image.png",
"kind": "image",
"name": "reference-image.png",
"mimeType": "image/png",
"width": 1024,
"height": 1024,
"sizeBytes": 1048576,
"imageDimensionsToken": "image_dimensions_token_from_original_files_api_upload_response"
},
{
"url": "https://cdn.example.com/reference-video.mp4",
"kind": "video",
"name": "reference-video.mp4",
"mimeType": "video/mp4",
"durationSeconds": 8,
"durationToken": "video_duration_token_from_files_api",
"width": 1280,
"height": 720,
"sizeBytes": 8388608,
"framesPerSecond": 30,
"videoBitrateMbps": 8,
"videoMetadataToken": "video_metadata_token_from_original_files_api_upload_response"
}
]
}
}Réponse de création
L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.
{
"id": "task_kling_2_6_motion_control_example",
"status": "queued",
"model": "kling-2-6-motion-control",
"reserved_credits": 11,
"final_credits": 0,
"settlement_status": "RESERVED",
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Erreurs courantes
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Certains modes exigent des importations de référence via Files API.
