Tạo video

"status" trả về tác vụ hiện tại của phiên; "list" kiểm tra các nhà cung cấp.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9InRpbWVvdXRNcyIgdHlwZT0ibnVtYmVyIg Thời gian chờ tùy chọn cho thao tác của nhà cung cấp, tính bằng mili giây. Khi bỏ qua, OpenClaw dùng agents.defaults.videoGenerationModel.timeoutMs nếu đã cấu hình; nếu không, dùng giá trị mặc định do tác giả Plugin đặt cho nhà cung cấp nếu có. OPENCLAW_DOCS_MARKER:paramClose:

Các đầu vào tham chiếu chọn chế độ thời gian chạy:

• Không có phương tiện tham chiếu -> generate
• Có bất kỳ tham chiếu hình ảnh nào -> imageToVideo
• Có bất kỳ tham chiếu video nào -> videoToVideo
• Đầu vào âm thanh tham chiếu không thay đổi chế độ đã phân giải; chúng được áp dụng bổ sung lên chế độ do tham chiếu hình ảnh/video chọn và chỉ hoạt động với các nhà cung cấp khai báo maxInputAudios.

Kết hợp tham chiếu hình ảnh và video không phải là một bề mặt khả năng dùng chung ổn định. Nên dùng một loại tham chiếu cho mỗi yêu cầu.

Dự phòng và tùy chọn có kiểu

Một số kiểm tra khả năng được áp dụng tại lớp dự phòng thay vì ranh giới công cụ, vì vậy yêu cầu vượt quá giới hạn của nhà cung cấp chính vẫn có thể chạy trên một nhà cung cấp dự phòng đủ khả năng:

• Ứng viên đang hoạt động không khai báo maxInputAudios (hoặc khai báo 0) sẽ bị bỏ qua khi yêu cầu chứa tham chiếu âm thanh; ứng viên tiếp theo sẽ được thử. Cơ chế bảo vệ tương tự áp dụng cho số lượng tham chiếu hình ảnh và video theo maxInputImages/maxInputVideos.
• Ứng viên đang hoạt động có maxDurationSeconds thấp hơn durationSeconds được yêu cầu và không khai báo danh sách supportedDurationSeconds -> bị bỏ qua.
• Yêu cầu chứa providerOptions và ứng viên đang hoạt động khai báo rõ ràng lược đồ providerOptions có kiểu -> bị bỏ qua nếu các khóa được cung cấp không có trong lược đồ hoặc kiểu giá trị không khớp. Các nhà cung cấp không khai báo lược đồ sẽ nhận nguyên trạng các tùy chọn (chuyển tiếp tương thích ngược). Nhà cung cấp có thể từ chối tất cả tùy chọn của nhà cung cấp bằng cách khai báo lược đồ rỗng (capabilities.providerOptions: {}), việc này gây ra cùng kiểu bỏ qua như khi kiểu không khớp.

Lý do bỏ qua đầu tiên trong một yêu cầu được ghi nhật ký ở mức warn để người vận hành biết khi nhà cung cấp chính của họ không được chọn; các lần bỏ qua tiếp theo được ghi ở mức debug để chuỗi dự phòng dài không tạo quá nhiều thông báo. Nếu mọi ứng viên đều bị bỏ qua, lỗi tổng hợp sẽ bao gồm lý do bỏ qua của từng ứng viên.

Hành động

Lựa chọn mô hình

OpenClaw phân giải mô hình theo thứ tự sau:

1. Tham số công cụ model - nếu agent chỉ định một mô hình trong lệnh gọi.
2. videoGenerationModel.primary từ cấu hình.
3. videoGenerationModel.fallbacks theo thứ tự.
4. Tự động phát hiện - các nhà cung cấp có thông tin xác thực hợp lệ, bắt đầu từ nhà cung cấp mặc định hiện tại, sau đó là các nhà cung cấp còn lại theo thứ tự bảng chữ cái.

Nếu một nhà cung cấp thất bại, ứng viên tiếp theo sẽ tự động được thử. Nếu tất cả ứng viên đều thất bại, lỗi sẽ bao gồm chi tiết từ mỗi lần thử.

Đặt agents.defaults.mediaGenerationAutoProviderFallback: false để chỉ dùng các mục model, primary và fallbacks được chỉ định rõ ràng.

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],        timeoutMs: 180000, // tùy chọn ghi đè thời gian chờ yêu cầu của nhà cung cấp cho từng công cụ      },    },  },}

Ghi chú về nhà cung cấp

Các chế độ khả năng của nhà cung cấp

Hợp đồng tạo video dùng chung hỗ trợ các khả năng theo từng chế độ thay vì chỉ các giới hạn tổng hợp phẳng. Các phần triển khai nhà cung cấp mới nên ưu tiên các khối chế độ tường minh:

capabilities: {  generate: {    maxVideos: 1,    maxDurationSeconds: 10,    supportsResolution: true,  },  imageToVideo: {    enabled: true,    maxVideos: 1,    maxInputImages: 1,    maxInputImagesByModel: { "provider/reference-to-video": 9 },    maxDurationSeconds: 5,  },  videoToVideo: {    enabled: true,    maxVideos: 1,    maxInputVideos: 1,    maxDurationSeconds: 5,  },}

Các trường tổng hợp phẳng như maxInputImages và maxInputVideos không đủ để công bố hỗ trợ chế độ chuyển đổi. Các nhà cung cấp nên khai báo tường minh generate, imageToVideo và videoToVideo để các kiểm thử trực tiếp, kiểm thử hợp đồng và công cụ video_generate dùng chung có thể xác thực hỗ trợ chế độ theo cách xác định.

Khi một mô hình trong nhà cung cấp hỗ trợ đầu vào tham chiếu rộng hơn các mô hình còn lại, hãy sử dụng maxInputImagesByModel, maxInputVideosByModel hoặc maxInputAudiosByModel thay vì tăng giới hạn cho toàn bộ chế độ.

Kiểm thử trực tiếp

Phạm vi kiểm thử trực tiếp có thể chọn tham gia cho các nhà cung cấp đi kèm dùng chung:

OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts

Trình bao bọc của kho mã:

pnpm test:live:media video

Theo mặc định, tệp kiểm thử trực tiếp này ưu tiên các biến môi trường của nhà cung cấp đã được xuất trước các hồ sơ xác thực đã lưu và chạy một bài kiểm thử nhanh an toàn cho bản phát hành:

• generate cho mọi nhà cung cấp không phải FAL trong lượt kiểm thử.
• Lời nhắc về tôm hùm dài một giây.
• Giới hạn thời gian thao tác cho từng nhà cung cấp từ OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (mặc định là 180000).

FAL là tùy chọn tham gia vì độ trễ hàng đợi phía nhà cung cấp có thể chi phối thời gian phát hành:

pnpm test:live:media video --video-providers fal

Đặt OPENCLAW_LIVE_VIDEO_GENERATION_FULL_MODES=1 để cũng chạy các chế độ chuyển đổi đã khai báo mà lượt kiểm thử dùng chung có thể thực hiện an toàn với phương tiện cục bộ:

• imageToVideo khi capabilities.imageToVideo.enabled.
• videoToVideo khi capabilities.videoToVideo.enabled và nhà cung cấp/mô hình chấp nhận đầu vào video cục bộ được hỗ trợ bằng bộ đệm trong lượt kiểm thử dùng chung.

Hiện tại, luồng kiểm thử trực tiếp videoToVideo dùng chung chỉ bao phủ runway khi bạn chọn runway/gen4_aleph.

Cấu hình

Đặt mô hình tạo video mặc định trong cấu hình OpenClaw của bạn:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "qwen/wan2.6-t2v",        fallbacks: ["qwen/wan2.6-r2v-flash"],      },    },  },}

Hoặc thông qua CLI:

openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2v"

Liên quan

• Alibaba Model Studio
• Tác vụ nền - theo dõi tác vụ cho quá trình tạo video bất đồng bộ
• BytePlus
• ComfyUI
• Tham chiếu cấu hình
• fal
• Google (Gemini)
• MiniMax
• Mô hình
• OpenAI
• Qwen
• Runway
• Together AI
• Tổng quan về công cụ
• Vydra
• xAI