--- read_when: - Vous souhaitez utiliser la génération de vidéos PixVerse dans OpenClaw - Vous devez configurer la clé API et la variable d’environnement de PixVerse - Vous souhaitez faire de PixVerse le fournisseur vidéo par défaut summary: Configuration de la génération de vidéos PixVerse dans OpenClaw title: PixVerse x-i18n: generated_at: "2026-07-12T03:16:16Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 50204c771deb315e7336325f2852e4b65dfba4264bbe288b819d44b8def1ce82 source_path: providers/pixverse.md workflow: 16 --- OpenClaw fournit `pixverse` comme Plugin externe officiel pour la génération de vidéos PixVerse hébergée. Le Plugin enregistre le fournisseur `pixverse` conformément au contrat `videoGenerationProviders`. | Propriété | Valeur | | ------------------------- | ----------------------------------------------------------------------------- | | Identifiant du fournisseur | `pixverse` | | Paquet du Plugin | `@openclaw/pixverse-provider` | | Variable d’environnement d’authentification | `PIXVERSE_API_KEY` | | Option d’intégration | `--auth-choice pixverse-api-key` | | Option CLI directe | `--pixverse-api-key ` | | API | API PixVerse Platform v2 (soumission de `video_id` puis interrogation du résultat) | | Modèle par défaut | `pixverse/v6` | | Région API par défaut | Internationale | ## Prise en main ```bash openclaw plugins install @openclaw/pixverse-provider openclaw gateway restart ``` ```bash openclaw onboard --auth-choice pixverse-api-key ``` L’assistant demande de choisir le point de terminaison international ou chinois (voir la région API ci-dessous) avant d’écrire `region` et `baseUrl` dans la configuration du fournisseur. Les exécutions non interactives (clé fournie par `--pixverse-api-key` ou `PIXVERSE_API_KEY`) utilisent la région internationale par défaut. L’intégration définit également `agents.defaults.videoGenerationModel.primary` sur `pixverse/v6` lorsqu’aucun modèle vidéo par défaut n’est encore configuré. ```bash openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6" ``` Demandez à l’agent de générer une vidéo. PixVerse sera utilisé automatiquement. ## Modes et modèles pris en charge Le fournisseur expose les modèles de génération PixVerse par l’intermédiaire de l’outil vidéo partagé d’OpenClaw. | Mode | Modèles | Entrée de référence | | ----------------- | -------------------------------- | ----------------------------------- | | Texte vers vidéo | `v6` (par défaut), `c1` | Aucune | | Image vers vidéo | `v6` (par défaut), `c1` | 1 image locale ou distante | Les références d’images locales sont téléversées vers PixVerse avant la requête de conversion d’image en vidéo. Les URL d’images distantes sont transmises au point de terminaison de téléversement d’images de PixVerse sous la forme `image_url`. | Option | Valeurs prises en charge | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Durée | 1 à 15 secondes (5 par défaut) | | Résolution | `360P`, `540P`, `720P`, `1080P` (`540P` par défaut ; les requêtes `480P` sont converties en `540P`) | | Format d’image | `16:9` (par défaut), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9` ; texte vers vidéo uniquement, l’image vers vidéo suit l’image source | | Audio généré | `audio: true` | La génération d’images à partir de modèles PixVerse n’est pas encore exposée par `image_generate`. Cette API repose sur un identifiant de modèle, tandis que le contrat partagé de génération d’images d’OpenClaw ne dispose actuellement d’aucun ensemble d’options typées propre à PixVerse. ## Options du fournisseur Le fournisseur vidéo accepte les clés facultatives suivantes, qui lui sont propres : | Option | Type | Effet | | ------------------------------------ | ------ | ------------------------------------------------------- | | `seed` | nombre | Graine déterministe, de 0 à 2147483647 | | `negativePrompt` / `negative_prompt` | chaîne | Invite négative | | `quality` | chaîne | Qualité PixVerse, par exemple `720p` | | `motionMode` / `motion_mode` | chaîne | Mode de mouvement image vers vidéo (`normal` par défaut) | | `cameraMovement` / `camera_movement` | chaîne | Préréglage de mouvement de caméra PixVerse | | `templateId` / `template_id` | nombre | Identifiant de modèle PixVerse activé | ## Configuration ```json5 { agents: { defaults: { videoGenerationModel: { primary: "pixverse/v6", }, }, }, } ``` ## Configuration avancée | Valeur de région | URL de base de l’API PixVerse | | ---------------- | ---------------------------------------------- | | `international` | `https://app-api.pixverse.ai/openapi/v2` | | `cn` | `https://app-api.pixverseai.cn/openapi/v2` | Définissez manuellement `models.providers.pixverse.region` lorsque votre clé appartient à une région particulière de la plateforme PixVerse, ou exécutez `openclaw onboard --auth-choice pixverse-api-key` pour en choisir une dans l’assistant de configuration : ```json5 { models: { providers: { pixverse: { region: "cn", // "international" ou "cn" baseUrl: "https://app-api.pixverseai.cn/openapi/v2", models: [], }, }, }, } ``` Définissez `models.providers.pixverse.baseUrl` uniquement lorsque le routage passe par un proxy compatible et approuvé. `baseUrl` a priorité sur `region`. ```json5 { models: { providers: { pixverse: { baseUrl: "https://app-api.pixverse.ai/openapi/v2", }, }, }, } ``` PixVerse renvoie un `video_id` en réponse à la requête de génération. OpenClaw interroge `/openapi/v2/video/result/{video_id}` toutes les 5 secondes jusqu’à ce que la tâche réussisse, échoue ou atteigne le délai d’expiration (5 minutes par défaut ; modifiable avec `agents.defaults.videoGenerationModel.timeoutMs`). ## Pages connexes Paramètres de l’outil partagé, sélection du fournisseur et comportement asynchrone. Paramètres par défaut de l’agent, notamment le modèle de génération vidéo.