동영상 생성

• 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. 에이전트는 세션의 일반적인 표시 응답 모드를 통해 사용자에게 알립니다. 자동인 경우 최종 응답 전달을 사용하거나, 세션에 메시지 도구가 필요한 경우 message(action="send")를 사용합니다. 요청자 세션이 비활성 상태이거나 활성 깨우기가 실패했고, 완료 응답에 생성된 비디오 일부가 아직 누락되어 있으면, 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