동영상 생성

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

• generate - 참조 미디어가 없는 텍스트-비디오 요청.
• imageToVideo - 요청에 하나 이상의 참조 이미지가 포함됩니다.
• videoToVideo - 요청에 하나 이상의 참조 비디오가 포함됩니다.

​

빠른 시작

export GEMINI_API_KEY="your-key"

openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"

​

비동기 생성 작동 방식

1. OpenClaw가 요청을 제공자에게 제출하고 즉시 작업 ID를 반환합니다.
2. 제공자가 백그라운드에서 작업을 처리합니다(일반적으로 제공자와 해상도에 따라 30초에서 몇 분까지 걸리며, 대기열 기반의 느린 제공자는 구성된 제한 시간까지 실행될 수 있습니다).
3. 비디오가 준비되면 OpenClaw가 내부 완료 이벤트로 동일한 세션을 깨웁니다.
4. 에이전트가 사용자에게 알리고 완성된 비디오를 첨부합니다. 메시지 도구로만 보이는 전달을 사용하는 그룹/채널 채팅에서는 OpenClaw가 직접 게시하는 대신 에이전트가 메시지 도구를 통해 결과를 전달합니다.

​

작업 수명 주기

openclaw tasks list
openclaw tasks show <taskId>
openclaw tasks cancel <taskId>

​

지원되는 제공자

​

기능 매트릭스

​

도구 매개변수

​

필수

​

콘텐츠 입력

​

스타일 제어

​

고급

• 참조 미디어 없음 → generate
• 이미지 참조 있음 → imageToVideo
• 비디오 참조 있음 → videoToVideo
• 참조 오디오 입력은 확인된 모드를 변경하지 않습니다. 이미지/비디오 참조가 선택한 모드 위에 적용되며, maxInputAudios를 선언한 공급자에서만 작동합니다.

​

폴백 및 타입 지정 옵션

• 요청에 오디오 참조가 포함되어 있을 때 활성 후보가 maxInputAudios를 선언하지 않거나 0을 선언하면 건너뛰고, 다음 후보를 시도합니다.
• 활성 후보의 maxDurationSeconds가 요청된 durationSeconds보다 낮고 선언된 supportedDurationSeconds 목록이 없으면 건너뜁니다.
• 요청에 providerOptions가 포함되어 있고 활성 후보가 타입 지정된 providerOptions 스키마를 명시적으로 선언하면, 제공된 키가 스키마에 없거나 값 타입이 일치하지 않을 때 건너뜁니다. 선언된 스키마가 없는 공급자는 옵션을 있는 그대로 받습니다(하위 호환 패스스루). 공급자는 빈 스키마(capabilities.providerOptions: {})를 선언하여 모든 공급자 옵션을 거부할 수 있으며, 이 경우 타입 불일치와 동일하게 건너뜁니다.

​

동작

​

모델 선택

1. model 도구 매개변수 - 에이전트가 호출에서 지정한 경우.
2. 구성의 videoGenerationModel.primary.
3. 순서대로 videoGenerationModel.fallbacks.
4. 자동 감지 - 유효한 인증이 있는 공급자입니다. 현재 기본 공급자로 시작한 다음, 나머지 공급자를 알파벳순으로 시도합니다.

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

​

공급자 참고 사항

​

제공자 기능 모드

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,
  },
}

​

라이브 테스트

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

pnpm test:live:media video

• 스윕의 모든 비 FAL 제공자에 대해 generate.
• 1초짜리 랍스터 프롬프트.
• OPENCLAW_LIVE_VIDEO_GENERATION_TIMEOUT_MS의 제공자별 작업 상한 (기본값 180000).

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

• capabilities.imageToVideo.enabled일 때 imageToVideo.
• capabilities.videoToVideo.enabled이고 해당 제공자/모델이 공유 스윕에서 버퍼 기반 로컬 비디오 입력을 허용할 때 videoToVideo.

​

구성

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

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

​

관련 항목

• Alibaba Model Studio
• 백그라운드 작업 - 비동기 비디오 생성을 위한 작업 추적
• BytePlus
• ComfyUI
• 구성 참조
• fal
• Google (Gemini)
• MiniMax
• 모델
• OpenAI
• Qwen
• Runway
• Together AI
• 도구 개요
• Vydra
• xAI