> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling-O3 Texte vers Vidéo > - Kling-O3 Text to Video (kling-o3-text-to-video) génération vidéo pilotée uniquement par le texte, basée sur le modèle Kling AI kling-v3-omni - Prend en charge les modes mono-plan et multi-plans, peut générer des vidéos avec des effets sonores - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [consulter le statut](/fr/api-manual/task-management/get-task-detail) - Les liens vidéo générés sont valides pendant 24 heures, veuillez les sauvegarder rapidement ## OpenAPI ````yaml fr/api-manual/video-series/kling/kling-o3-text-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: API kling-o3-text-to-video description: Créer des tâches de texte vers vidéo à l'aide de modèles IA license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Génération vidéo description: APIs de génération de vidéos IA paths: /v1/videos/generations: post: tags: - Génération vidéo summary: API kling-o3-text-to-video description: >- - Kling-O3 Text to Video (kling-o3-text-to-video) génération vidéo pilotée uniquement par le texte, basée sur le modèle Kling AI kling-v3-omni - Prend en charge les modes mono-plan et multi-plans, peut générer des vidéos avec des effets sonores - Mode de traitement asynchrone, utilisez l'ID de tâche retourné pour [consulter le statut](/fr/api-manual/task-management/get-task-detail) - Les liens vidéo générés sont valides pendant 24 heures, veuillez les sauvegarder rapidement operationId: createVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: basic: summary: Texte vers vidéo basique value: model: kling-o3-text-to-video prompt: A cat running on a grassy field under bright sunshine duration: 5 aspect_ratio: '16:9' quality: 720p pro_with_sound: summary: 1080P avec effets sonores value: model: kling-o3-text-to-video prompt: >- Ocean waves crashing against rocks during a thunderstorm, with rumbling thunder duration: 10 aspect_ratio: '16:9' quality: 1080p sound: 'on' multi_shot: summary: Multi-plans (Segments de plans personnalisés) value: model: kling-o3-text-to-video duration: 10 aspect_ratio: '16:9' quality: 1080p sound: 'on' model_params: multi_shot: true shot_type: customize multi_prompt: - index: 1 prompt: >- A person standing on a mountain top gazing at the sunrise duration: '5' - index: 2 prompt: >- Camera pulls back to reveal the magnificent mountain landscape duration: '5' with_element: summary: Avec contrôle d'éléments value: model: kling-o3-text-to-video prompt: <<>> walking along the beach at sunset duration: 8 aspect_ratio: '16:9' quality: 1080p model_params: element_list: - element_id: '123456' responses: '200': description: Tâche de génération vidéo créée avec succès content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '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é, jeton 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, recharge requise 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-o3-text-to-video' type: invalid_request_error '429': description: Limite de débit 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 components: schemas: VideoGenerationRequest: type: object required: - model - prompt properties: model: type: string description: Nom du modèle de génération vidéo enum: - kling-o3-text-to-video default: kling-o3-text-to-video example: kling-o3-text-to-video prompt: type: string description: >- Prompt textuel décrivant la vidéo à générer **Remarque :** - Maximum `2500` caractères - Peut être vide lorsque `multi_shot=true` et `shot_type=customize` - Vous pouvez référencer des éléments en utilisant la syntaxe `<<>>` example: A cat running on a grassy field under bright sunshine maxLength: 2500 duration: type: integer description: >- Durée de la vidéo en secondes, par défaut `5` secondes **Remarque :** - Prend en charge les entiers de `3` à `15` - La facturation est basée sur la valeur de `duration`, une durée plus longue coûte plus cher minimum: 3 maximum: 15 default: 5 example: 5 aspect_ratio: type: string description: |- Rapport d'aspect vidéo **Options :** - `16:9` : Vidéo paysage - `9:16` : Vidéo portrait - `1:1` : Vidéo carrée enum: - '16:9' - '9:16' - '1:1' default: '16:9' example: '16:9' quality: type: string description: |- Qualité de résolution **Options :** - `720p` : Standard 720P - `1080p` : Haute qualité 1080P - `4k` : Ultra haute définition 4K enum: - 720p - 1080p - 4k default: 720p example: 720p sound: type: string description: |- Contrôle des effets sonores **Options :** - `on` : Activer les effets sonores - `off` : Désactiver les effets sonores enum: - 'on' - 'off' default: 'off' example: 'off' model_params: type: object description: |- Paramètres d'extension du modèle **Contrainte :** Maximum 7 éléments properties: multi_shot: type: boolean description: >- Utiliser ou non le mode multi-plans **Remarque :** Lorsque activé, le paramètre `prompt` est ignoré et le contenu de chaque plan doit être défini via `multi_prompt`. La somme des valeurs `duration` de tous les plans doit être égale à la durée totale de la vidéo. default: false example: false shot_type: type: string description: |- Méthode de segmentation des plans **Options :** - `customize` : Segments de plans personnalisés - Requis lorsque `multi_shot=true` enum: - customize example: customize multi_prompt: type: array description: |- Liste d'informations des segments de plans **Remarque :** - Requis lorsque `multi_shot=true` et `shot_type=customize` - Maximum `6` segments de plans items: type: object properties: index: type: integer description: Index du segment de plan prompt: type: string description: Description du segment de plan duration: type: string description: Durée du segment de plan (secondes) required: - index - prompt - duration maxItems: 6 element_list: type: array description: >- Liste de la bibliothèque d'éléments **Contrainte :** Maximum 7 éléments - Référencez dans le prompt en utilisant la syntaxe `<<>>` items: type: object properties: element_id: type: string description: ID de l'élément required: - element_id maxItems: 7 watermark_info: type: object description: Configuration du filigrane properties: enabled: type: boolean description: Activer ou non le filigrane 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 VideoGenerationResponse: 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-7cvnl5zw model: type: string description: Nom du modèle réellement utilisé example: kling-o3-text-to-video 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: $ref: '#/components/schemas/VideoTaskInfo' description: Détails de la tâche vidéo type: type: string enum: - text - image - audio - video description: Type de sortie de la tâche example: video usage: $ref: '#/components/schemas/VideoUsage' description: Informations d'utilisation et de facturation 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 VideoTaskInfo: type: object 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: 300 video_duration: type: integer description: Durée de la vidéo (secondes) example: 9 VideoUsage: type: object description: Informations d'utilisation et de facturation properties: billing_rule: type: string description: Règle de facturation enum: - per_call - per_token - per_second example: per_call credits_reserved: type: number description: Crédits estimés consommés minimum: 0 example: 7 user_group: type: string description: Catégorie de groupe d'utilisateurs example: default 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 ``` ````