Providers

Fal

OpenClaw은 호스팅 이미지 및 비디오 생성을 위한 번들 fal 제공자를 제공합니다.

속성	값
제공자	`fal`
인증	`FAL_KEY`(표준; `FAL_API_KEY`도 대체 수단으로 동작)
API	fal 모델 엔드포인트

시작하기

bash

openclaw onboard --auth-choice fal-api-key

json5

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/fal-ai/flux/dev",      },    },  },}

번들 fal 이미지 생성 제공자의 기본값은 fal/fal-ai/flux/dev입니다.

기능	값
최대 이미지 수	요청당 4개
편집 모드	Flux: 참조 이미지 1개; GPT Image 2: 10개; Nano Banana 2: 14개
크기 재정의	지원됨
종횡비	생성 및 GPT Image 2/Nano Banana 2 편집에서 지원됨
해상도	지원됨
출력 형식	`png` 또는 `jpeg`

PNG 출력을 원할 때는 outputFormat: "png"를 사용하세요. fal은 OpenClaw에서 명시적인 투명 배경 제어를 선언하지 않으므로, fal 모델에서는 background: "transparent"가 무시된 재정의로 보고됩니다.

fal을 기본 이미지 제공자로 사용하려면:

json5

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/fal-ai/flux/dev",      },    },  },}

번들 fal 비디오 생성 제공자의 기본값은 fal/fal-ai/minimax/video-01-live입니다.

기능	값
모드	텍스트-투-비디오, 단일 이미지 참조, Seedance 참조-투-비디오
런타임	장기 실행 작업을 위한 큐 기반 제출/상태/결과 흐름

Available video models

HeyGen video-agent:

Seedance 2.0:

Seedance 2.0 config example

json5

{  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}

Seedance 2.0 reference-to-video config example

json5

{  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",      },    },  },}

참조-투-비디오는 공유 video_generate images, videos, audioRefs 매개변수를 통해 최대 9개의 이미지, 3개의 비디오, 3개의 오디오 참조를 허용하며, 총 참조 파일은 최대 12개입니다.

HeyGen video-agent config example

json5

{  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/fal-ai/heygen/v2/video-agent",      },    },  },}