PixVerse

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 <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

Installer le Plugin

openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart

Définir la clé API

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é.

Changer le fournisseur vidéo par défaut existant (facultatif)

openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"

Générer une vidéo

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

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "pixverse/v6",
      },
    },
  },
}

Configuration avancée

Région API

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 :

{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" ou "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}

URL de base personnalisée

Définissez models.providers.pixverse.baseUrl uniquement lorsque le routage passe par un proxy compatible et approuvé. baseUrl a priorité sur region.

{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}

Interrogation des tâches

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

Génération de vidéos

Paramètres de l’outil partagé, sélection du fournisseur et comportement asynchrone.

Référence de configuration

Paramètres par défaut de l’agent, notamment le modèle de génération vidéo.

Overview

Concepts and configuration

Providers

Prise en main

Modes et modèles pris en charge

Options du fournisseur

Configuration

Configuration avancée

Pages connexes

Génération de vidéos

Référence de configuration

​Prise en main

​Modes et modèles pris en charge

​Options du fournisseur

​Configuration

​Configuration avancée

​Pages connexes

Génération de vidéos

Référence de configuration

Prise en main

Modes et modèles pris en charge

Options du fournisseur

Configuration

Configuration avancée

Pages connexes