Providers
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-provideropenclaw gateway restartAPI anahtarını ayarlayın
openclaw onboard --auth-choice pixverse-api-keySihirbaz, 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 |
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).
