In questa pagina
In questa pagina
Providers
PixVerse
OpenClaw fornisce pixverse come plugin esterno ufficiale per la generazione di video PixVerse in hosting. Il plugin registra il provider pixverse nel contratto videoGenerationProviders.
| Proprietà | Valore |
|---|---|
| ID del provider | pixverse |
| Pacchetto del plugin | @openclaw/pixverse-provider |
| Variabile env di autenticazione | PIXVERSE_API_KEY |
| Flag di onboarding | --auth-choice pixverse-api-key |
| Flag CLI diretto | --pixverse-api-key <key> |
| API | PixVerse Platform API v2 (invio di video_id e polling del risultato) |
| Modello predefinito | pixverse/v6 |
| Regione API predefinita | Internazionale |
Per iniziare
Installa il plugin
Imposta la chiave API
La procedura guidata richiede di scegliere l'endpoint Internazionale o CN
(vedi Regione API di seguito) prima di scrivere region e baseUrl nella
configurazione del provider. Le esecuzioni non interattive (chiave fornita
tramite --pixverse-api-key o PIXVERSE_API_KEY) usano per impostazione
predefinita la regione Internazionale.
L'onboarding imposta inoltre agents.defaults.videoGenerationModel.primary
su pixverse/v6 quando non è ancora configurato alcun modello video
predefinito.
Cambia il provider video predefinito esistente (facoltativo)
Genera un video
Chiedi all'agente di generare un video. PixVerse verrà utilizzato automaticamente.
Modalità e modelli supportati
Il provider rende disponibili i modelli di generazione PixVerse tramite lo strumento video condiviso di OpenClaw.
| Modalità | Modelli | Input di riferimento |
|---|---|---|
| Da testo a video | v6 (predefinito), c1 |
Nessuno |
| Da immagine a video | v6 (predefinito), c1 |
1 immagine locale o remota |
I riferimenti a immagini locali vengono caricati su PixVerse prima della richiesta da immagine a video. Gli URL delle immagini remote vengono trasmessi all'endpoint di caricamento immagini di PixVerse come image_url.
| Opzione | Valori supportati |
|---|---|
| Durata | 1-15 secondi (valore predefinito: 5) |
| Risoluzione | 360P, 540P, 720P, 1080P (valore predefinito: 540P; le richieste 480P vengono convertite in 540P) |
| Proporzioni | 16:9 (predefinito), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9; solo da testo a video, da immagine a video segue l'immagine sorgente |
| Audio generato | audio: true |
Opzioni del provider
Il provider video accetta le seguenti chiavi facoltative specifiche del provider:
| Opzione | Tipo | Effetto |
|---|---|---|
seed |
numero | Seed deterministico, da 0 a 2147483647 |
negativePrompt / negative_prompt |
stringa | Prompt negativo |
quality |
stringa | Qualità PixVerse, ad esempio 720p |
motionMode / motion_mode |
stringa | Modalità di movimento da immagine a video (predefinita: normal) |
cameraMovement / camera_movement |
stringa | Preset di movimento della videocamera PixVerse |
templateId / template_id |
numero | ID del modello PixVerse attivato |
Configurazione
Configurazione avanzata
Regione API
| Valore della regione | URL di base dell'API PixVerse |
|---|---|
international |
https://app-api.pixverse.ai/openapi/v2 |
cn |
https://app-api.pixverseai.cn/openapi/v2 |
Imposta manualmente models.providers.pixverse.region quando la chiave
appartiene a una regione specifica della piattaforma PixVerse oppure esegui
openclaw onboard --auth-choice pixverse-api-key per sceglierne una nella
procedura guidata di configurazione:
URL di base personalizzato
Imposta models.providers.pixverse.baseUrl solo quando il traffico viene instradato tramite un proxy compatibile e attendibile.
baseUrl ha la precedenza su region.
Polling delle attività
PixVerse restituisce un video_id dalla richiesta di generazione. OpenClaw
esegue il polling di /openapi/v2/video/result/{video_id} ogni 5 secondi,
finché l'attività non riesce, non fallisce o non raggiunge il timeout
(valore predefinito: 5 minuti; modificabile tramite
agents.defaults.videoGenerationModel.timeoutMs).
