Chuyển đến nội dung chính
OpenClaw cung cấp pixverse như một Plugin bên ngoài chính thức cho việc tạo video PixVerse được lưu trữ. Plugin đăng ký nhà cung cấp pixverse theo hợp đồng videoGenerationProviders.
Thuộc tínhGiá trị
ID nhà cung cấppixverse
Gói Plugin@openclaw/pixverse-provider
Biến môi trường xác thựcPIXVERSE_API_KEY
Cờ onboarding--auth-choice pixverse-api-key
Cờ CLI trực tiếp--pixverse-api-key <key>
APIPixVerse Platform API v2 (gửi video_id kèm thăm dò kết quả)
Mô hình mặc địnhpixverse/v6
Vùng API mặc địnhQuốc tế

​
Bắt đầu

1

Install the plugin

openclaw plugins install clawhub:@openclaw/pixverse-provider
openclaw gateway restart
2

Set the API key

openclaw onboard --auth-choice pixverse-api-key
Trình hướng dẫn hỏi có dùng endpoint Quốc tế (https://app-api.pixverse.ai/openapi/v2) hay endpoint CN (https://app-api.pixverseai.cn/openapi/v2) trước khi ghi region và baseUrl vào cấu hình nhà cung cấp.
3

Set PixVerse as the default video provider

openclaw config set agents.defaults.videoGenerationModel.primary "pixverse/v6"
4

Generate a video

Yêu cầu agent tạo video. PixVerse sẽ được dùng tự động.

​
Chế độ và mô hình được hỗ trợ

Nhà cung cấp phơi bày các mô hình tạo video của PixVerse thông qua công cụ video dùng chung của OpenClaw.
Chế độMô hìnhĐầu vào tham chiếu
Văn bản thành videov6 (mặc định), c1Không có
Hình ảnh thành videov6 (mặc định), c11 hình ảnh cục bộ hoặc từ xa
Tham chiếu hình ảnh cục bộ được tải lên PixVerse trước yêu cầu hình ảnh thành video. URL hình ảnh từ xa được chuyển qua endpoint tải lên hình ảnh của PixVerse dưới dạng image_url.
Tùy chọnGiá trị được hỗ trợ
Thời lượng1-15 giây
Độ phân giải360P, 540P, 720P, 1080P
Tỷ lệ khung hình16:9, 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, 21:9 cho văn bản thành video
Âm thanh được tạoaudio: true
Tạo mẫu hình ảnh PixVerse chưa được phơi bày qua image_generate. API đó được điều khiển bằng template-id, trong khi hợp đồng tạo hình ảnh dùng chung của OpenClaw hiện chưa có túi tùy chọn định kiểu riêng cho PixVerse.

​
Tùy chọn nhà cung cấp

Nhà cung cấp video chấp nhận các khóa tùy chọn riêng cho nhà cung cấp sau:
Tùy chọnKiểuTác dụng
seednumberSeed xác định khi được hỗ trợ
negativePrompt / negative_promptstringPrompt phủ định
qualitystringChất lượng PixVerse như 720p
motionMode / motion_modestringChế độ chuyển động hình ảnh thành video
cameraMovement / camera_movementstringPreset chuyển động camera PixVerse
templateId / template_idnumberID mẫu PixVerse đã kích hoạt

​
Cấu hình

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

​
Cấu hình nâng cao

OpenClaw mặc định dùng API PixVerse quốc tế. Đặt models.providers.pixverse.region thủ công khi khóa của bạn thuộc một vùng nền tảng PixVerse cụ thể, hoặc dùng openclaw onboard --auth-choice pixverse-api-key để chọn một vùng trong trình hướng dẫn thiết lập:
Giá trị vùngURL cơ sở API PixVerse
internationalhttps://app-api.pixverse.ai/openapi/v2
cnhttps://app-api.pixverseai.cn/openapi/v2
{
  models: {
    providers: {
      pixverse: {
        region: "cn", // "international" or "cn"
        baseUrl: "https://app-api.pixverseai.cn/openapi/v2",
        models: [],
      },
    },
  },
}
Chỉ đặt models.providers.pixverse.baseUrl khi định tuyến qua proxy tương thích đáng tin cậy. baseUrl được ưu tiên hơn region.
{
  models: {
    providers: {
      pixverse: {
        baseUrl: "https://app-api.pixverse.ai/openapi/v2",
      },
    },
  },
}
PixVerse trả về video_id từ yêu cầu tạo. OpenClaw thăm dò /openapi/v2/video/result/{video_id} cho đến khi tác vụ thành công, thất bại hoặc hết thời gian chờ.

​
Liên quan

Video generation

Tham số công cụ dùng chung, lựa chọn nhà cung cấp và hành vi bất đồng bộ.

Configuration reference

Thiết lập mặc định của agent, bao gồm mô hình tạo video.