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 بازنویسی کنید).
