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

Providers

PixVerse

OpenClaw biedt pixverse als officiële externe plugin voor gehoste PixVerse-videogeneratie. De plugin registreert de provider pixverse volgens het contract videoGenerationProviders.

Eigenschap Waarde
Provider-id pixverse
Pluginpakket @openclaw/pixverse-provider
Omgevingsvariabele voor authenticatie PIXVERSE_API_KEY
Onboarding-vlag --auth-choice pixverse-api-key
Directe CLI-vlag --pixverse-api-key <key>
API PixVerse Platform API v2 (indiening via video_id plus pollen van het resultaat)
Standaardmodel pixverse/v6
Standaard-API-regio Internationaal

Aan de slag

  • Installeer de plugin

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

  • Stel de API-sleutel in

    bash
    openclaw onboard --auth-choice pixverse-api-key

    De wizard vraagt om het internationale of Chinese eindpunt (zie API-regio hieronder) voordat region en baseUrl naar de providerconfiguratie worden geschreven. Niet-interactieve uitvoeringen (sleutel uit --pixverse-api-key of PIXVERSE_API_KEY) gebruiken standaard Internationaal.

    Onboarding stelt agents.defaults.mediaModels.video.primary ook in op pixverse/v6 wanneer er nog geen standaardvideomodel is geconfigureerd.

  • Schakel over naar een bestaande standaardprovider voor video (optioneel)

    bash
    openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"

  • Genereer een video

    Vraag de agent een video te genereren. PixVerse wordt automatisch gebruikt.

    • Ondersteunde modi en modellen

    De provider maakt PixVerse-generatiemodellen beschikbaar via het gedeelde videohulpmiddel van OpenClaw.

    Modus Modellen Referentie-invoer
    Tekst-naar-video v6 (standaard), c1 Geen
    Afbeelding-naar-video v6 (standaard), c1 1 lokale of externe afbeelding

    Lokale afbeeldingsreferenties worden vóór de afbeelding-naar-video-aanvraag naar PixVerse geüpload. URL's van externe afbeeldingen worden als image_url doorgegeven via het eindpunt voor het uploaden van afbeeldingen van PixVerse.

    Optie Ondersteunde waarden
    Duur 1-15 seconden (standaard 5)
    Resolutie 360P, 540P, 720P, 1080P (standaard 540P; aanvragen voor 480P worden toegewezen aan 540P)
    Beeldverhouding 16:9 (standaard), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9; alleen tekst-naar-video, afbeelding-naar-video volgt de bronafbeelding
    Gegenereerde audio audio: true

    Provideropties

    De videoprovider accepteert deze optionele providerspecifieke sleutels:

    Optie Type Effect
    seed number Deterministische seed, 0 tot 2147483647
    negativePrompt / negative_prompt string Negatieve prompt
    quality string PixVerse-kwaliteit, zoals 720p
    motionMode / motion_mode string Bewegingsmodus voor afbeelding-naar-video (standaard normal)
    cameraMovement / camera_movement string Voorinstelling voor PixVerse-camerabeweging
    templateId / template_id number Id van geactiveerd PixVerse-sjabloon

    Configuratie

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

    Geavanceerde configuratie

    API-regio
    Regiowaarde Basis-URL van PixVerse-API
    international https://app-api.pixverse.ai/openapi/v2
    cn https://app-api.pixverseai.cn/openapi/v2

    Stel models.providers.pixverse.region handmatig in wanneer je sleutel bij een specifieke PixVerse-platformregio hoort, of voer openclaw onboard --auth-choice pixverse-api-key uit om er een te kiezen in de configuratiewizard:

    json5
    {  models: {    providers: {      pixverse: {        region: "cn", // "international" of "cn"        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",        models: [],      },    },  },}
    Aangepaste basis-URL

    Stel models.providers.pixverse.baseUrl alleen in wanneer het verkeer via een vertrouwde compatibele proxy wordt geleid. baseUrl heeft voorrang op region.

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

    PixVerse retourneert een video_id van de generatieaanvraag. OpenClaw pollt /openapi/v2/video/result/{video_id} elke 5 seconden totdat de taak slaagt, mislukt of de time-out bereikt (standaard 5 minuten; overschrijf dit met agents.defaults.mediaModels.video.timeoutMs).

    Gerelateerd

    Videogeneratie

    Gedeelde hulpmiddelparameters, providerselectie en asynchroon gedrag.
    Configuratiereferentie

    Standaardinstellingen voor agents, waaronder het model voor videogeneratie.
    Was this useful?
    On this page

    On this page