Passer au contenu principal
OpenClaw fournit pixverse comme Plugin externe officiel pour la génération vidéo PixVerse hébergée. Le Plugin enregistre le fournisseur pixverse auprès du contrat videoGenerationProviders.
PropriétéValeur
ID du fournisseurpixverse
Paquet Plugin@openclaw/pixverse-provider
Variable d’env. authPIXVERSE_API_KEY
Indicateur d’onboarding--auth-choice pixverse-api-key
Indicateur CLI direct--pixverse-api-key <key>
APIAPI PixVerse Platform v2 (soumission de video_id et interrogation du résultat)
Modèle par défautpixverse/v6
Région API par défautInternationale

​
Premiers pas

1

Installer le Plugin

openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

Définir la clé API

openclaw onboard --auth-choice pixverse-api-key
L’assistant demande s’il faut utiliser le point de terminaison international (https://app-api.pixverse.ai/openapi/v2) ou le point de terminaison CN (https://app-api.pixverseai.cn/openapi/v2) avant d’écrire region et baseUrl dans la configuration du fournisseur.
3

Définir PixVerse comme fournisseur vidéo par défaut

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

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 via l’outil vidéo partagé d’OpenClaw.
ModeModèlesEntrée de référence
Texte vers vidéov6 (par défaut), c1Aucune
Image vers vidéov6 (par défaut), c11 image locale ou distante
Les références d’images locales sont téléversées vers PixVerse avant la requête image vers vidéo. Les URL d’images distantes sont transmises via le point de terminaison de téléversement d’image PixVerse en tant que image_url.
OptionValeurs prises en charge
Durée1 à 15 secondes
Résolution360P, 540P, 720P, 1080P
Format d’image16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 pour texte vers vidéo
Audio généréaudio: true
La génération de modèles d’image PixVerse n’est pas encore exposée via image_generate. Cette API est pilotée par un identifiant de modèle, tandis que le contrat partagé de génération d’images d’OpenClaw ne dispose pas actuellement d’un ensemble d’options typées propre à PixVerse.

​
Options du fournisseur

Le fournisseur vidéo accepte ces clés facultatives propres au fournisseur :
OptionTypeEffet
seednumberGraine déterministe lorsque prise en charge
negativePrompt / negative_promptstringInvite négative
qualitystringQualité PixVerse, par exemple 720p
motionMode / motion_modestringMode de mouvement image vers vidéo
cameraMovement / camera_movementstringPréréglage de mouvement de caméra PixVerse
templateId / template_idnumberIdentifiant de modèle PixVerse activé

​
Configuration

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

​
Configuration avancée

OpenClaw utilise par défaut l’API PixVerse internationale. Définissez models.providers.pixverse.region manuellement lorsque votre clé appartient à une région spécifique de la plateforme PixVerse, ou utilisez openclaw onboard --auth-choice pixverse-api-key pour en choisir une dans l’assistant de configuration :
Valeur de régionURL de base de l’API PixVerse
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}
Définissez models.providers.pixverse.baseUrl uniquement lors du routage via un proxy compatible de confiance. baseUrl est prioritaire sur region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
PixVerse renvoie un video_id depuis la requête de génération. OpenClaw interroge /openapi/v2/video/result/{video_id} jusqu’à ce que la tâche réussisse, échoue ou expire.

​
Connexe

Génération vidéo

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, y compris le modèle de génération vidéo.