OpenClawDocs
Di halaman ini

Di halaman ini

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

    bash
    openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restart

  • Tetapkan kunci API

    bash
    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)

    bash
    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

    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

    json5
    {  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:

    json5
    {  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.

    json5
    {  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).

    Terkait

    Pembuatan video

    Parameter alat bersama, pemilihan penyedia, dan perilaku asinkron.
    Referensi konfigurasi

    Pengaturan bawaan agen, termasuk model pembuatan video.
    Was this useful?