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ตัวช่วยสร้างจะแจ้งให้เลือกปลายทางนานาชาติหรือจีน (ดูหัวข้อภูมิภาค API
ด้านล่าง) ก่อนเขียน region และ baseUrl ลงในการกำหนดค่าผู้ให้บริการ
การทำงานแบบไม่โต้ตอบ (รับคีย์จาก --pixverse-api-key หรือ PIXVERSE_API_KEY)
จะใช้ภูมิภาคนานาชาติเป็นค่าเริ่มต้น
การเริ่มต้นใช้งานยังตั้งค่า agents.defaults.videoGenerationModel.primary เป็น
pixverse/v6 เมื่อยังไม่ได้กำหนดโมเดลวิดีโอเริ่มต้น
เปลี่ยนผู้ให้บริการวิดีโอเริ่มต้นที่มีอยู่ (ไม่บังคับ)
openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"สร้างวิดีโอ
ขอให้เอเจนต์สร้างวิดีโอ ระบบจะใช้ PixVerse โดยอัตโนมัติ
โหมดและโมเดลที่รองรับ
ผู้ให้บริการเปิดให้ใช้โมเดลสร้างสื่อของ PixVerse ผ่านเครื่องมือวิดีโอที่ใช้ร่วมกันของ OpenClaw
| โหมด | โมเดล | ข้อมูลอ้างอิงนำเข้า |
|---|---|---|
| ข้อความเป็นวิดีโอ | v6 (ค่าเริ่มต้น), c1 |
ไม่มี |
| ภาพเป็นวิดีโอ | v6 (ค่าเริ่มต้น), c1 |
ภาพในเครื่องหรือภาพระยะไกล 1 ภาพ |
ระบบจะอัปโหลดภาพอ้างอิงในเครื่องไปยัง PixVerse ก่อนส่งคำขอสร้างวิดีโอจากภาพ ส่วน URL ของภาพระยะไกลจะถูกส่งผ่านปลายทางอัปโหลดภาพของ PixVerse ในรูปแบบ image_url
| ตัวเลือก | ค่าที่รองรับ |
|---|---|
| ระยะเวลา | 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
| ค่าภูมิภาค | URL ฐานของ PixVerse API |
|---|---|
international |
https://app-api.pixverse.ai/openapi/v2 |
cn |
https://app-api.pixverseai.cn/openapi/v2 |
ตั้งค่า models.providers.pixverse.region ด้วยตนเองเมื่อคีย์ของคุณเป็นของ
ภูมิภาคแพลตฟอร์ม PixVerse ที่เจาะจง หรือเรียกใช้
openclaw onboard --auth-choice pixverse-api-key เพื่อเลือกภูมิภาคใน
ตัวช่วยสร้างการตั้งค่า:
{ models: { providers: { pixverse: { region: "cn", // "international" or "cn" baseUrl: "https://app-api.pixverseai.cn/openapi/v2", models: [], }, }, },}URL ฐานแบบกำหนดเอง
ตั้งค่า models.providers.pixverse.baseUrl เฉพาะเมื่อกำหนดเส้นทางผ่านพร็อกซีที่เข้ากันได้และเชื่อถือได้
baseUrl มีลำดับความสำคัญเหนือ region
{ models: { providers: { pixverse: { baseUrl: "https://app-api.pixverse.ai/openapi/v2", }, }, },}การสำรวจสถานะงาน
PixVerse ส่งคืน video_id จากคำขอสร้างวิดีโอ OpenClaw จะสำรวจ
/openapi/v2/video/result/{video_id} ทุก 5 วินาที จนกว่างานจะ
สำเร็จ ล้มเหลว หรือหมดเวลา (ค่าเริ่มต้น 5 นาที; เปลี่ยนค่าได้ด้วย
agents.defaults.videoGenerationModel.timeoutMs)
