> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Kling Élément personnalisé > - Kling Custom Element (kling-custom-element) crée des éléments de sujet réutilisables (personnages/objets) à partir d'images ou de vidéos de référence - Après une création réussie, l'`element_id` retourné peut être référencé dans la série Kling O3 et Kling V3 Image-vers-Vidéo via le paramètre `element_list`, permettant un contrôle cohérent de l'apparence des personnages - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [interroger le statut](/fr/api-manual/task-management/get-task-detail) - À l'achèvement de la tâche, `result_data` contiendra l'`element_id` pour la génération vidéo **Notes importantes :** - Ce modèle est utilisé pour créer des sujets réutilisables (éléments), **il ne génère pas de vidéos**, aucun paramètre prompt / duration / quality / aspect_ratio n'est nécessaire ## OpenAPI ````yaml fr/api-manual/video-series/kling/kling-custom-element.json POST /v1/videos/generations openapi: 3.1.0 info: title: kling-custom-element API description: >- Créer des éléments de sujet réutilisables (personnages/objets) pour une apparence cohérente des personnages dans la série Kling O3 et la génération Kling V3 Image-vers-Vidéo license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Création d'éléments de sujet description: >- Créer des éléments de sujet réutilisables pour un contrôle cohérent de l'apparence des personnages dans la génération vidéo paths: /v1/videos/generations: post: tags: - Création d'éléments de sujet summary: kling-custom-element API description: >- - Kling Custom Element (kling-custom-element) crée des éléments de sujet réutilisables (personnages/objets) à partir d'images ou de vidéos de référence - Après une création réussie, l'`element_id` retourné peut être référencé dans la série Kling O3 et Kling V3 Image-vers-Vidéo via le paramètre `element_list`, permettant un contrôle cohérent de l'apparence des personnages - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [interroger le statut](/fr/api-manual/task-management/get-task-detail) - À l'achèvement de la tâche, `result_data` contiendra l'`element_id` pour la génération vidéo **Notes importantes :** - Ce modèle est utilisé pour créer des sujets réutilisables (éléments), **il ne génère pas de vidéos**, aucun paramètre prompt / duration / quality / aspect_ratio n'est nécessaire operationId: createCustomElement requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CustomElementRequest' examples: image_refer: summary: Créer un sujet à partir d'images de référence value: model: kling-custom-element model_params: element_name: Mon personnage element_description: >- Un jeune personnage masculin aux cheveux courts, portant un T-shirt blanc reference_type: image_refer element_image_list: frontal_image: https://example.com/front.jpg refer_images: - image_url: https://example.com/side.jpg video_refer: summary: Créer un sujet à partir d'une vidéo de référence value: model: kling-custom-element model_params: element_name: Mon personnage element_description: >- Un personnage féminin aux cheveux longs, portant une robe rouge reference_type: video_refer element_video_list: video_url: https://example.com/reference.mp4 element_voice_id: '829824295735410756' responses: '200': description: Tâche de création d'élément de sujet soumise avec succès content: application/json: schema: $ref: '#/components/schemas/CustomElementResponse' '400': description: Paramètres de requête invalides content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Non authentifié, token invalide ou expiré content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Quota insuffisant, rechargement nécessaire content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Accès refusé content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: kling-custom-element' type: invalid_request_error '429': description: Limite de requêtes dépassée content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Erreur interne du serveur content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error '502': description: Erreur du service en amont content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: upstream_error message: Upstream AI service unavailable type: upstream_error components: schemas: CustomElementRequest: type: object required: - model - model_params properties: model: type: string description: Nom du modèle enum: - kling-custom-element default: kling-custom-element example: kling-custom-element model_params: type: object description: Paramètres du modèle required: - element_name - element_description - reference_type properties: element_name: type: string description: |- Nom de l'élément de sujet **Note :** - Maximum `20` caractères maxLength: 20 example: Mon personnage element_description: type: string description: >- Description de l'élément de sujet, aide le modèle à comprendre les caractéristiques d'apparence du sujet **Note :** - Maximum `100` caractères maxLength: 100 example: >- Un jeune personnage masculin aux cheveux courts, portant un T-shirt blanc reference_type: type: string description: |- Type de matériel de référence | Valeur | Description | |---|---| | `image_refer` | Créer un sujet avec des images de référence | | `video_refer` | Créer un sujet avec une vidéo de référence | enum: - image_refer - video_refer example: image_refer element_image_list: type: object description: >- Liste d'images de référence pour la création d'éléments de sujet. Requis lorsque `reference_type = image_refer` **Note :** - Il est recommandé d'utiliser des images claires, bien éclairées, avec un sujet bien visible - Dimensions de l'image : largeur et hauteur ≥ `300px`, rapport d'aspect entre `1:2.5` et `2.5:1` - `frontal_image` (recommandé) : URL de l'image de référence frontale - `refer_images` : Liste d'images de référence supplémentaires, chaque élément contient un champ `image_url` properties: frontal_image: type: string format: uri description: >- URL de l'image de référence frontale (recommandé), doit être directement accessible par le serveur ou déclencher un téléchargement direct lors de l'accès refer_images: type: array description: >- Liste d'images de référence supplémentaires, les URL des images doivent être directement accessibles par le serveur ou déclencher un téléchargement direct lors de l'accès items: type: object properties: image_url: type: string format: uri description: >- URL de l'image de référence, doit être directement accessible par le serveur ou déclencher un téléchargement direct lors de l'accès required: - image_url example: frontal_image: https://example.com/front.jpg refer_images: - image_url: https://example.com/side.jpg element_video_list: type: object description: >- Vidéo de référence pour la création d'éléments de sujet. Requis lorsque `reference_type = video_refer` **Note :** - `video_url` : URL de la vidéo de référence properties: video_url: type: string format: uri description: >- URL de la vidéo de référence, doit être directement accessible par le serveur required: - video_url example: video_url: https://example.com/reference.mp4 element_voice_id: type: string description: >- ID vocal attribué à l'élément. La voix sera utilisée lorsque l'élément parle dans les vidéos générées **Note :** - Pris en charge uniquement lorsque `reference_type = video_refer` - Non disponible pour `image_refer` example: '829824295735410756' callback_url: type: string description: >- URL de rappel HTTPS pour l'achèvement de la tâche **Moment du rappel :** - Déclenché lorsque la tâche est terminée, échouée ou annulée - Envoyé après confirmation de la facturation **Restrictions de sécurité :** - Protocole HTTPS uniquement - Les adresses IP internes sont interdites (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longueur de l'URL ne doit pas dépasser `2048` caractères **Mécanisme de rappel :** - Délai d'expiration : `10` secondes - Maximum `3` tentatives après échec (à `1`/`2`/`4` secondes après l'échec) - Le format de réponse du rappel est cohérent avec l'API de requête de tâche - Un code de statut 2xx est considéré comme un succès, les autres codes déclenchent une nouvelle tentative format: uri example: https://your-domain.com/webhooks/video-task-completed CustomElementResponse: type: object properties: created: type: integer description: Horodatage de création de la tâche example: 1757169743 id: type: string description: ID de tâche example: task-unified-1757169743-8dxnm6yz model: type: string description: Nom du modèle réellement utilisé example: kling-custom-element object: type: string enum: - video.generation.task description: Type de tâche progress: type: integer description: Pourcentage de progression de la tâche (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Statut de la tâche enum: - pending - processing - completed - failed example: pending task_info: type: object description: Détails de la tâche properties: can_cancel: type: boolean description: Si la tâche peut être annulée example: true estimated_time: type: integer description: Temps d'achèvement estimé (secondes) minimum: 0 example: 600 type: type: string enum: - video description: Type de sortie de la tâche example: video usage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Règle de facturation enum: - per_call example: per_call credits_reserved: type: number description: Crédits estimés consommés minimum: 0 example: 1 user_group: type: string description: Catégorie de groupe d'utilisateurs example: default ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identifiant du code d'erreur message: type: string description: Description de l'erreur type: type: string description: Type d'erreur securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Toutes les API nécessitent une authentification Bearer Token ## **Obtenir une clé API :** Visitez la [Page de gestion des clés API](https://evolink.ai/dashboard/keys) pour obtenir votre clé API **Ajouter à l'en-tête de requête :** ``` Authorization: Bearer YOUR_API_KEY ``` ````