PixVerse

OpenClaw, barındırılan PixVerse video üretimi için resmi bir harici plugin olarak pixverse sağlar. Plugin, pixverse sağlayıcısını videoGenerationProviders sözleşmesine kaydeder.

Özellik	Değer
Sağlayıcı kimliği	`pixverse`
Plugin paketi	`@openclaw/pixverse-provider`
Kimlik doğrulama ortam değişkeni	`PIXVERSE_API_KEY`
İlk kurulum bayrağı	`--auth-choice pixverse-api-key`
Doğrudan CLI bayrağı	`--pixverse-api-key <key>`
API	PixVerse Platform API v2 (`video_id` gönderimi ve sonuç yoklaması)
Varsayılan model	`pixverse/v6`
Varsayılan API bölgesi	Uluslararası

Başlarken

Plugin'i yükleyin

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

API anahtarını ayarlayın

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

Sihirbaz, sağlayıcı yapılandırmasına region ve baseUrl yazmadan önce Uluslararası veya CN uç noktasını (aşağıdaki API bölümü bölümüne bakın) sorar. Etkileşimsiz çalıştırmalar (--pixverse-api-key veya PIXVERSE_API_KEY üzerinden alınan anahtar) varsayılan olarak Uluslararası bölgeyi kullanır.İlk kurulum, henüz varsayılan bir video modeli yapılandırılmamışsa agents.defaults.mediaModels.video.primary değerini de pixverse/v6 olarak ayarlar.

Mevcut varsayılan video sağlayıcısını değiştirin (isteğe bağlı)

openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"

Video üretin

Agent’tan bir video üretmesini isteyin. PixVerse otomatik olarak kullanılır.

Desteklenen modlar ve modeller

Sağlayıcı, PixVerse üretim modellerini OpenClaw’ın paylaşılan video aracı üzerinden sunar.

Mod	Modeller	Referans girdisi
Metinden videoya	`v6` (varsayılan), `c1`	Yok
Görüntüden videoya	`v6` (varsayılan), `c1`	1 yerel veya uzak görüntü

Yerel görüntü referansları, görüntüden videoya isteğinden önce PixVerse’e yüklenir. Uzak görüntü URL’leri, image_url olarak PixVerse görüntü yükleme uç noktasına aktarılır.

Seçenek	Desteklenen değerler
Süre	1-15 saniye (varsayılan 5)
Çözünürlük	`360P`, `540P`, `720P`, `1080P` (varsayılan `540P`; `480P` istekleri `540P` ile eşlenir)
En-boy oranı	`16:9` (varsayılan), `4:3`, `1:1`, `3:4`, `9:16`, `2:3`, `3:2`, `21:9`; yalnızca metinden videoya, görüntüden videoya modu kaynak görüntüyü izler
Üretilen ses	`audio: true`

PixVerse görüntü şablonu üretimi henüz image_generate üzerinden sunulmamaktadır. Bu API şablon kimliğiyle çalışırken OpenClaw’ın paylaşılan görüntü üretimi sözleşmesinde şu anda PixVerse’e özgü türü belirlenmiş bir seçenek paketi yoktur.

Sağlayıcı seçenekleri

Video sağlayıcısı, sağlayıcıya özgü şu isteğe bağlı anahtarları kabul eder:

Seçenek	Tür	Etki
`seed`	sayı	Belirlenimci başlangıç değeri, 0 ile 2147483647 arası
`negativePrompt` / `negative_prompt`	dize	Negatif istem
`quality`	dize	`720p` gibi PixVerse kalite ayarı
`motionMode` / `motion_mode`	dize	Görüntüden videoya hareket modu (varsayılan `normal`)
`cameraMovement` / `camera_movement`	dize	PixVerse kamera hareketi ön ayarı
`templateId` / `template_id`	sayı	Etkinleştirilmiş PixVerse şablon kimliği

Yapılandırma

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

Gelişmiş yapılandırma

API bölgesi

Bölge değeri	PixVerse API temel URL’si
`international`	`https://app-api.pixverse.ai/openapi/v2`
`cn`	`https://app-api.pixverseai.cn/openapi/v2`

Anahtarınız belirli bir PixVerse platform bölgesine aitse models.providers.pixverse.region değerini elle ayarlayın veya kurulum sihirbazında bir bölge seçmek için openclaw onboard --auth-choice pixverse-api-key komutunu çalıştırın:

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

Özel temel URL

models.providers.pixverse.baseUrl değerini yalnızca güvenilir ve uyumlu bir proxy üzerinden yönlendirme yaparken ayarlayın. baseUrl, region değerine göre önceliklidir.

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

Görev yoklaması

PixVerse, üretim isteğinden bir video_id döndürür. OpenClaw, görev başarılı olana, başarısız olana veya zaman aşımına ulaşana kadar her 5 saniyede bir /openapi/v2/video/result/{video_id} yoklaması yapar (varsayılan 5 dakika; değiştirmek için agents.defaults.mediaModels.video.timeoutMs kullanın).

İlgili

Video üretimi

Paylaşılan araç parametreleri, sağlayıcı seçimi ve eşzamansız davranış.

Yapılandırma referansı

Video üretim modeli dahil Agent varsayılan ayarları.

Overview

Concepts and configuration

Providers

Başlarken

Desteklenen modlar ve modeller

Sağlayıcı seçenekleri

Yapılandırma

Gelişmiş yapılandırma

İlgili

Video üretimi

Yapılandırma referansı

​Başlarken

​Desteklenen modlar ve modeller

​Sağlayıcı seçenekleri

​Yapılandırma

​Gelişmiş yapılandırma

​İlgili

Video üretimi

Yapılandırma referansı

Başlarken

Desteklenen modlar ve modeller

Sağlayıcı seçenekleri

Yapılandırma

Gelişmiş yapılandırma

İlgili