Vai al contenuto principale
OpenClaw fornisce pixverse come Plugin esterno ufficiale per la generazione video PixVerse ospitata. Il Plugin registra il provider pixverse rispetto al contratto videoGenerationProviders.
ProprietàValore
ID providerpixverse
Pacchetto Plugin@openclaw/pixverse-provider
Variabile env di authPIXVERSE_API_KEY
Flag di onboarding--auth-choice pixverse-api-key
Flag CLI diretto--pixverse-api-key <key>
APIPixVerse Platform API v2 (invio video_id più polling del risultato)
Modello predefinitopixverse/v6
Regione API predefinitaInternazionale

​
Per iniziare

1

Installa il Plugin

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

Imposta la chiave API

openclaw onboard --auth-choice pixverse-api-key
La procedura guidata chiede se usare l’endpoint internazionale (https://app-api.pixverse.ai/openapi/v2) o l’endpoint CN (https://app-api.pixverseai.cn/openapi/v2) prima di scrivere region e baseUrl nella configurazione del provider.
3

Imposta PixVerse come provider video predefinito

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

Genera un video

Chiedi all’agente di generare un video. PixVerse verrà usato automaticamente.

​
Modalità e modelli supportati

Il provider espone i modelli di generazione PixVerse tramite lo strumento video condiviso di OpenClaw.
ModalitàModelliInput di riferimento
Testo-videov6 (predefinito), c1Nessuno
Immagine-videov6 (predefinito), c11 immagine locale o remota
I riferimenti a immagini locali vengono caricati su PixVerse prima della richiesta immagine-video. Gli URL di immagini remote vengono passati all’endpoint di caricamento immagini di PixVerse come image_url.
OpzioneValori supportati
Durata1-15 secondi
Risoluzione360P, 540P, 720P, 1080P
Proporzioni16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 per testo-video
Audio generatoaudio: true
La generazione di template immagine PixVerse non è ancora esposta tramite image_generate. Quell’API è guidata da ID template, mentre il contratto condiviso di generazione immagini di OpenClaw attualmente non dispone di un contenitore di opzioni tipizzate specifico per PixVerse.

​
Opzioni del provider

Il provider video accetta queste chiavi opzionali specifiche del provider:
OpzioneTipoEffetto
seednumberSeed deterministico quando supportato
negativePrompt / negative_promptstringPrompt negativo
qualitystringQualità PixVerse come 720p
motionMode / motion_modestringModalità movimento immagine-video
cameraMovement / camera_movementstringPreset di movimento camera PixVerse
templateId / template_idnumberID template PixVerse attivato

​
Configurazione

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

​
Configurazione avanzata

OpenClaw usa per impostazione predefinita l’API PixVerse internazionale. Imposta models.providers.pixverse.region manualmente quando la tua chiave appartiene a una regione specifica della piattaforma PixVerse, oppure usa openclaw onboard --auth-choice pixverse-api-key per sceglierne una nella procedura guidata di configurazione:
Valore regioneURL base 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: [],
      },
    },
  },
}
Imposta models.providers.pixverse.baseUrl solo quando instradi tramite un proxy compatibile attendibile. baseUrl ha precedenza su region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
PixVerse restituisce un video_id dalla richiesta di generazione. OpenClaw esegue il polling di /openapi/v2/video/result/{video_id} finché l’attività riesce, fallisce o va in timeout.

​
Correlati

Generazione video

Parametri dello strumento condiviso, selezione del provider e comportamento asincrono.

Riferimento di configurazione

Impostazioni predefinite dell’agente, incluso il modello di generazione video.