Langsung ke konten utama
OpenClaw menyediakan pixverse sebagai Plugin eksternal resmi untuk pembuatan video PixVerse yang dihosting. Plugin ini mendaftarkan penyedia pixverse terhadap kontrak videoGenerationProviders.
PropertiNilai
ID penyediapixverse
Paket Plugin@openclaw/pixverse-provider
Variabel env authPIXVERSE_API_KEY
Flag onboarding--auth-choice pixverse-api-key
Flag CLI langsung--pixverse-api-key <key>
APIPixVerse Platform API v2 (pengiriman video_id plus polling hasil)
Model defaultpixverse/v6
Wilayah API defaultInternasional

​
Memulai

1

Instal Plugin

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

Atur kunci API

openclaw onboard --auth-choice pixverse-api-key
Wizard menanyakan apakah akan menggunakan endpoint Internasional (https://app-api.pixverse.ai/openapi/v2) atau endpoint CN (https://app-api.pixverseai.cn/openapi/v2) sebelum menulis region dan baseUrl ke dalam konfigurasi penyedia.
3

Atur PixVerse sebagai penyedia video default

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

Buat video

Minta agen untuk membuat video. PixVerse akan digunakan secara otomatis.

​
Mode dan model yang didukung

Penyedia mengekspos model pembuatan PixVerse melalui alat video bersama OpenClaw.
ModeModelInput referensi
Teks-ke-videov6 (default), c1Tidak ada
Gambar-ke-videov6 (default), c11 gambar lokal atau jarak jauh
Referensi gambar lokal diunggah ke PixVerse sebelum permintaan gambar-ke-video. URL gambar jarak jauh diteruskan melalui endpoint unggah gambar PixVerse sebagai image_url.
OpsiNilai yang didukung
Durasi1-15 detik
Resolusi360P, 540P, 720P, 1080P
Rasio aspek16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 untuk teks-ke-video
Audio yang dihasilkanaudio: true
Pembuatan templat gambar PixVerse belum diekspos melalui image_generate. API tersebut digerakkan oleh ID templat, sedangkan kontrak pembuatan gambar bersama OpenClaw saat ini belum memiliki kantong opsi bertipe khusus PixVerse.

​
Opsi penyedia

Penyedia video menerima kunci opsional khusus penyedia berikut:
OpsiTipeEfek
seednumberSeed deterministik saat didukung
negativePrompt / negative_promptstringPrompt negatif
qualitystringKualitas PixVerse seperti 720p
motionMode / motion_modestringMode gerakan gambar-ke-video
cameraMovement / camera_movementstringPreset gerakan kamera PixVerse
templateId / template_idnumberID templat PixVerse yang diaktifkan

​
Konfigurasi

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

​
Konfigurasi lanjutan

OpenClaw secara default menggunakan API PixVerse internasional. Atur models.providers.pixverse.region secara manual saat kunci Anda berasal dari wilayah platform PixVerse tertentu, atau gunakan openclaw onboard --auth-choice pixverse-api-key untuk memilihnya di wizard penyiapan:
Nilai wilayahURL dasar 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: [],
      },
    },
  },
}
Atur models.providers.pixverse.baseUrl hanya saat merutekan melalui proxy kompatibel yang tepercaya. baseUrl lebih diprioritaskan daripada region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
PixVerse mengembalikan video_id dari permintaan pembuatan. OpenClaw melakukan polling /openapi/v2/video/result/{video_id} hingga tugas berhasil, gagal, atau waktu habis.

​
Terkait

Pembuatan video

Parameter alat bersama, pemilihan penyedia, dan perilaku asinkron.

Referensi konfigurasi

Pengaturan default agen termasuk model pembuatan video.