در این صفحه
در این صفحه
Providers
PixVerse
OpenClaw، pixverse را بهعنوان یک Plugin خارجی رسمی برای تولید ویدیوی میزبانیشده PixVerse ارائه میکند. این Plugin، ارائهدهنده pixverse را مطابق قرارداد videoGenerationProviders ثبت میکند.
| ویژگی | مقدار |
|---|---|
| شناسه ارائهدهنده | pixverse |
| بسته Plugin | @openclaw/pixverse-provider |
| متغیر محیطی احراز هویت | PIXVERSE_API_KEY |
| پرچم راهاندازی اولیه | --auth-choice pixverse-api-key |
| پرچم مستقیم CLI | --pixverse-api-key <key> |
| API | PixVerse Platform API v2 (ارسال video_id بههمراه پایش نتیجه) |
| مدل پیشفرض | pixverse/v6 |
| منطقه پیشفرض API | بینالمللی |
شروع به کار
نصب Plugin
openclaw plugins install @openclaw/pixverse-provideropenclaw gateway restartتنظیم کلید API
openclaw onboard --auth-choice pixverse-api-keyجادوگر پیش از نوشتن region و baseUrl در پیکربندی ارائهدهنده، درباره نقطه پایانی International یا CN درخواست انتخاب میکند (بخش منطقه API را
در ادامه ببینید). اجراهای غیرتعاملی (کلید از --pixverse-api-key یا PIXVERSE_API_KEY)
بهطور پیشفرض از International استفاده میکنند.
راهاندازی اولیه همچنین در صورتی که هنوز هیچ مدل ویدیویی پیشفرضی پیکربندی نشده باشد، agents.defaults.mediaModels.video.primary را روی
pixverse/v6 تنظیم میکند.
تغییر ارائهدهنده پیشفرض ویدیوی موجود (اختیاری)
openclaw config set agents.defaults.mediaModels.video.primary "pixverse/v6"تولید ویدیو
از عامل بخواهید یک ویدیو تولید کند. PixVerse بهطور خودکار استفاده خواهد شد.
حالتها و مدلهای پشتیبانیشده
ارائهدهنده، مدلهای تولید PixVerse را از طریق ابزار ویدیوی مشترک OpenClaw در دسترس قرار میدهد.
| حالت | مدلها | ورودی مرجع |
|---|---|---|
| متن به ویدیو | v6 (پیشفرض)، c1 |
هیچکدام |
| تصویر به ویدیو | v6 (پیشفرض)، c1 |
1 تصویر محلی یا راهدور |
ارجاعهای تصویر محلی پیش از درخواست تصویر به ویدیو در PixVerse بارگذاری میشوند. نشانیهای URL تصویر راهدور بهصورت image_url از طریق نقطه پایانی بارگذاری تصویر PixVerse ارسال میشوند.
| گزینه | مقادیر پشتیبانیشده |
|---|---|
| مدتزمان | 1-15 ثانیه (پیشفرض 5) |
| وضوح | 360P، 540P، 720P، 1080P (پیشفرض 540P؛ درخواستهای 480P به 540P نگاشت میشوند) |
| نسبت تصویر | 16:9 (پیشفرض)، 4:3، 1:1، 3:4، 9:16، 2:3، 3:2، 21:9؛ فقط برای متن به ویدیو، تصویر به ویدیو از تصویر منبع پیروی میکند |
| صدای تولیدشده | audio: true |
گزینههای ارائهدهنده
ارائهدهنده ویدیو این کلیدهای اختیاری ویژه ارائهدهنده را میپذیرد:
| گزینه | نوع | اثر |
|---|---|---|
seed |
عدد | بذر قطعی، از 0 تا 2147483647 |
negativePrompt / negative_prompt |
رشته | پرامپت منفی |
quality |
رشته | کیفیت PixVerse مانند 720p |
motionMode / motion_mode |
رشته | حالت حرکت تصویر به ویدیو (پیشفرض normal) |
cameraMovement / camera_movement |
رشته | تنظیم از پیش تعیینشده حرکت دوربین PixVerse |
templateId / template_id |
عدد | شناسه الگوی فعالشده PixVerse |
پیکربندی
{ agents: { defaults: { videoGenerationModel: { primary: "pixverse/v6", }, }, },}پیکربندی پیشرفته
منطقه API
| مقدار منطقه | نشانی پایه API مربوط به PixVerse |
|---|---|
international |
https://app-api.pixverse.ai/openapi/v2 |
cn |
https://app-api.pixverseai.cn/openapi/v2 |
هنگامی که کلید شما به منطقه مشخصی از پلتفرم PixVerse تعلق دارد، models.providers.pixverse.region را بهصورت دستی تنظیم کنید، یا
openclaw onboard --auth-choice pixverse-api-key را اجرا کنید تا یکی را در
جادوگر راهاندازی انتخاب کنید:
{ models: { providers: { pixverse: { region: "cn", // "international" or "cn" baseUrl: "https://app-api.pixverseai.cn/openapi/v2", models: [], }, }, },}نشانی پایه سفارشی
فقط هنگام مسیریابی از طریق یک پراکسی سازگار و مورد اعتماد، models.providers.pixverse.baseUrl را تنظیم کنید.
baseUrl بر region اولویت دارد.
{ models: { providers: { pixverse: { baseUrl: "https://app-api.pixverse.ai/openapi/v2", }, }, },}پایش وظیفه
PixVerse در پاسخ به درخواست تولید، یک video_id برمیگرداند. OpenClaw هر 5 ثانیه
/openapi/v2/video/result/{video_id} را پایش میکند تا وظیفه
موفق شود، شکست بخورد یا به مهلت زمانی برسد (پیشفرض 5 دقیقه؛ با
agents.defaults.mediaModels.video.timeoutMs بازنویسی کنید).
