OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

    bash
    openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restart

  • Définir la clé API

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

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

    bash
    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

    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

    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 :

    json5
    {  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.

    json5
    {  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.
    Was this useful?
    On this page

    On this page