PixVerse

OpenClaw menyediakan pixverse sebagai plugin eksternal resmi untuk pembuatan video PixVerse yang dihosting. Plugin ini mendaftarkan penyedia pixverse pada kontrak videoGenerationProviders.

Properti	Nilai
ID penyedia	`pixverse`
Paket plugin	`@openclaw/pixverse-provider`
Variabel lingkungan autentikasi	`PIXVERSE_API_KEY`
Flag orientasi awal	`--auth-choice pixverse-api-key`
Flag CLI langsung	`--pixverse-api-key <key>`
API	PixVerse Platform API v2 (pengiriman `video_id` serta polling hasil)
Model bawaan	`pixverse/v6`
Wilayah API bawaan	Internasional

Memulai

Instal plugin

openclaw plugins install @openclaw/pixverse-provider
openclaw gateway restart

Tetapkan kunci API

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

Wisaya meminta Anda memilih endpoint Internasional atau CN (lihat wilayah API di bawah) sebelum menulis region dan baseUrl ke konfigurasi penyedia. Eksekusi noninteraktif (kunci dari --pixverse-api-key atau PIXVERSE_API_KEY) secara bawaan menggunakan Internasional.Orientasi awal juga menetapkan agents.defaults.videoGenerationModel.primary ke pixverse/v6 jika model video bawaan belum dikonfigurasi.

Ganti penyedia video bawaan yang sudah ada (opsional)

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

Buat video

Minta agen membuat video. PixVerse akan digunakan secara otomatis.

Mode dan model yang didukung

Penyedia ini mengekspos model pembuatan PixVerse melalui alat video bersama OpenClaw.

Mode	Model	Masukan referensi
Teks ke video	`v6` (bawaan), `c1`	Tidak ada
Gambar ke video	`v6` (bawaan), `c1`	1 gambar lokal atau jarak jauh

Referensi gambar lokal diunggah ke PixVerse sebelum permintaan gambar ke video. URL gambar jarak jauh diteruskan melalui endpoint pengunggahan gambar PixVerse sebagai image_url.

Opsi	Nilai yang didukung
Durasi	1–15 detik (bawaan 5)
Resolusi	`360P`, `540P`, `720P`, `1080P` (bawaan `540P`; permintaan `480P` dipetakan ke `540P`)
Rasio aspek	`16:9` (bawaan), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; hanya teks ke video, gambar ke video mengikuti gambar sumber
Audio yang dibuat	`audio: 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 kumpulan opsi bertipe yang khusus untuk PixVerse.

Opsi penyedia

Penyedia video menerima kunci khusus penyedia opsional berikut:

Opsi	Tipe	Efek
`seed`	angka	Seed deterministik, 0 hingga 2147483647
`negativePrompt` / `negative_prompt`	string	Prompt negatif
`quality`	string	Kualitas PixVerse seperti `720p`
`motionMode` / `motion_mode`	string	Mode gerakan gambar ke video (bawaan `normal`)
`cameraMovement` / `camera_movement`	string	Preset gerakan kamera PixVerse
`templateId` / `template_id`	angka	ID templat PixVerse yang diaktifkan

Konfigurasi

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

Konfigurasi lanjutan

Wilayah API

Nilai wilayah	URL dasar API PixVerse
`international`	`https://app-api.pixverse.ai/openapi/v2`
`cn`	`https://app-api.pixverseai.cn/openapi/v2`

Tetapkan models.providers.pixverse.region secara manual jika kunci Anda berasal dari wilayah platform PixVerse tertentu, atau jalankan openclaw onboard --auth-choice pixverse-api-key untuk memilihnya dalam wisaya penyiapan:

{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" atau "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}

URL dasar khusus

Tetapkan models.providers.pixverse.baseUrl hanya saat merutekan melalui proksi kompatibel yang tepercaya. baseUrl lebih diprioritaskan daripada region.

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

Polling tugas

PixVerse mengembalikan video_id dari permintaan pembuatan. OpenClaw melakukan polling /openapi/v2/video/result/{video_id} setiap 5 detik hingga tugas berhasil, gagal, atau mencapai batas waktu (bawaan 5 menit; timpa dengan agents.defaults.videoGenerationModel.timeoutMs).

Overview

Concepts and configuration

Providers

Memulai

Mode dan model yang didukung

Opsi penyedia

Konfigurasi

Konfigurasi lanjutan

Terkait

Pembuatan video

Referensi konfigurasi

​Memulai

​Mode dan model yang didukung

​Opsi penyedia

​Konfigurasi

​Konfigurasi lanjutan

​Terkait

Pembuatan video

Referensi konfigurasi

Memulai

Mode dan model yang didukung

Opsi penyedia

Konfigurasi

Konfigurasi lanjutan

Terkait