Naar hoofdinhoud gaan
OpenClaw biedt pixverse als officiële externe plugin voor gehoste PixVerse-videogeneratie. De plugin registreert de pixverse-provider tegen het videoGenerationProviders-contract.
EigenschapWaarde
Provider-idpixverse
Pluginpakket@openclaw/pixverse-provider
Auth-omgevingsvariabelePIXVERSE_API_KEY
Onboarding-vlag--auth-choice pixverse-api-key
Directe CLI-vlag--pixverse-api-key <key>
APIPixVerse Platform API v2 (video_id-indiening plus resultaatpolling)
Standaardmodelpixverse/v6
Standaard-API-regioInternationaal

​
Aan de slag

1

De plugin installeren

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

De API-sleutel instellen

openclaw onboard --auth-choice pixverse-api-key
De wizard vraagt of het internationale endpoint (https://app-api.pixverse.ai/openapi/v2) of het CN-endpoint (https://app-api.pixverseai.cn/openapi/v2) moet worden gebruikt voordat region en baseUrl naar de providerconfiguratie worden geschreven.
3

PixVerse instellen als standaard videoprovider

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

Een video genereren

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

​
Ondersteunde modi en modellen

De provider stelt PixVerse-generatiemodellen beschikbaar via de gedeelde videotool van OpenClaw.
ModusModellenReferentie-invoer
Tekst-naar-videov6 (standaard), c1Geen
Afbeelding-naar-videov6 (standaard), c11 lokale of externe afbeelding
Lokale afbeeldingsreferenties worden naar PixVerse geüpload voordat het afbeelding-naar-videoverzoek wordt gedaan. Externe afbeeldings-URL’s worden via het PixVerse-endpoint voor afbeeldingsuploads doorgegeven als image_url.
OptieOndersteunde waarden
Duur1-15 seconden
Resolutie360P, 540P, 720P, 1080P
Beeldverhouding16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 voor tekst-naar-video
Gegenereerde audioaudio: true
PixVerse-afbeeldingsgeneratie met templates wordt nog niet beschikbaar gesteld via image_generate. Die API wordt aangestuurd door template-id’s, terwijl het gedeelde afbeeldingsgeneratiecontract van OpenClaw momenteel geen PixVerse-specifieke getypte optiebag heeft.

​
Provideropties

De videoprovider accepteert deze optionele providerspecifieke sleutels:
OptieTypeEffect
seednumberDeterministische seed wanneer ondersteund
negativePrompt / negative_promptstringNegatieve prompt
qualitystringPixVerse-kwaliteit zoals 720p
motionMode / motion_modestringBewegingsmodus voor afbeelding-naar-video
cameraMovement / camera_movementstringPixVerse-preset voor camerabeweging
templateId / template_idnumberGeactiveerde PixVerse-template-id

​
Configuratie

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

​
Geavanceerde configuratie

OpenClaw gebruikt standaard de internationale PixVerse-API. Stel models.providers.pixverse.region handmatig in wanneer je sleutel bij een specifieke PixVerse-platformregio hoort, of gebruik openclaw onboard --auth-choice pixverse-api-key om er een te kiezen in de installatiewizard:
RegiowaardeBasis-URL van PixVerse-API
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: [],
      },
    },
  },
}
Stel models.providers.pixverse.baseUrl alleen in wanneer je routeert via een vertrouwde compatibele proxy. baseUrl heeft voorrang op region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
PixVerse retourneert een video_id vanuit het generatieverzoek. OpenClaw pollt /openapi/v2/video/result/{video_id} totdat de taak slaagt, mislukt, of een time-out bereikt.

​
Gerelateerd

Videogeneratie

Gedeelde toolparameters, providerselectie en asynchroon gedrag.

Configuratiereferentie

Standaardinstellingen voor agents, inclusief videogeneratiemodel.