Tạo video

"status" trả về tác vụ phiên hiện tại; "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. OPENCLAW_DOCS_MARKER:paramClose:

Đầu vào tham chiếu chọn chế độ runtime:

• Không có phương tiện tham chiếu → generate
• Có bất kỳ tham chiếu ả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 áp dụng bên trên bất kỳ chế độ nào do tham chiếu ảnh/video chọn, và chỉ hoạt động với các nhà cung cấp khai báo maxInputAudios.

Trộn tham chiếu ảnh và video không phải là một bề mặt capability dùng chung ổn định. Ưu tiên một loại tham chiếu cho mỗi yêu cầu.

Fallback và tùy chọn có kiểu

Một số kiểm tra capability được áp dụng ở lớp fallback thay vì ranh giới công cụ, nên một 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 fallback có khả năng:

• Ứng viên đang hoạt động không khai báo maxInputAudios (hoặc 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ử.
• maxDurationSeconds của ứng viên đang hoạt động thấp hơn durationSeconds được yêu cầu và không có danh sách supportedDurationSeconds đã khai báo → bị bỏ qua.
• Yêu cầu chứa providerOptions và ứng viên đang hoạt động khai báo rõ ràng schema providerOptions có kiểu → bị bỏ qua nếu các khóa được cung cấp không có trong schema hoặc kiểu giá trị không khớp. Nhà cung cấp không có schema đã khai báo sẽ nhận tùy chọn nguyên trạng (truyền qua tương thích ngược). Một nhà cung cấp có thể từ chối mọi tùy chọn nhà cung cấp bằng cách khai báo schema rỗng (capabilities.providerOptions: {}), điều 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 log ở mức warn để operator thấy khi nhà cung cấp chính của họ bị bỏ qua; các lần bỏ qua tiếp theo ghi log ở mức debug để giữ các chuỗi fallback dài không ồn à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

Chọn model

OpenClaw phân giải model theo thứ tự này:

1. Tham số công cụ model - nếu agent chỉ định một model 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ó xác thực hợp lệ, bắt đầu bằng nhà cung cấp mặc định hiện tại, rồi các nhà cung cấp còn lại theo thứ tự chữ cái.

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

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

{  agents: {    defaults: {      videoGenerationModel: {        primary: "google/veo-3.1-fast-generate-preview",        fallbacks: ["runway/gen4.5", "qwen/wan2.6-t2v"],      },    },  },}

Ghi chú về nhà cung cấp

Chế độ năng lực của nhà cung cấp

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

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. Nhà cung cấp nên khai báo rõ generate, imageToVideo và videoToVideo để các kiểm thử live, kiểm thử hợp đồng và công cụ video_generate dùng chung có thể xác thực hỗ trợ chế độ một cách xác định.

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

Kiểm thử live

Phạm vi kiểm thử live tự chọn 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

Wrapper của repo:

pnpm test:live:media video

Tệp live này tải các biến môi trường nhà cung cấp còn thiếu từ ~/.profile, mặc định ưu tiên khóa API live/env trước các hồ sơ xác thực đã lưu, và mặc định chạy một smoke test an toàn cho phát hành:

• generate cho mọi nhà cung cấp không phải FAL trong lượt quét.
• Prompt tôm hùm một giây.
• Giới hạn thao tác theo từng nhà cung cấp từ OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS (mặc định là 180000).

FAL là tự chọn vì độ trễ hàng đợi phía nhà cung cấp có thể chiếm phần lớn 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 quét 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ộ dựa trên buffer trong lượt quét dùng chung.

Hiện tại, làn live 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 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 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