Providers
거짓
OpenClaw에는 호스팅 이미지, 동영상 및 음악 생성을 위한 fal provider가
번들로 포함되어 있습니다.
| 속성 | 값 |
|---|---|
| Provider | fal |
| 인증 | FAL_KEY(표준, FAL_API_KEY도 대체 수단으로 사용 가능) |
| API | fal 모델 엔드포인트(https://fal.run, 동영상 작업은 https://queue.fal.run 사용) |
| 기본 URL | models.providers.fal.baseUrl로 재정의 |
시작하기
API 키 설정
openclaw onboard --auth-choice fal-api-key비대화형 설정에서는 --fal-api-key <key>를 전달하거나 FAL_KEY를 내보낼 수 있습니다.
온보딩 과정에서는 이미지 모델이 구성되어 있지 않은 경우
fal/fal-ai/flux/dev를 기본 이미지 모델로 설정합니다.
기본 이미지 모델 설정
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}이미지 생성
번들로 제공되는 fal 이미지 생성 provider의 기본값은
fal/fal-ai/flux/dev입니다.
| 기능 | 값 |
|---|---|
| 최대 이미지 수 | 요청당 4개, Krea 2는 요청당 1개 |
| 크기 재정의 | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| 화면비 | Flux 이미지 간 변환을 제외한 모든 모델에서 지원 |
| 해상도 | 1K, 2K, 4K(모델별 제한은 아래 참조) |
| 출력 형식 | png(기본값) 또는 jpeg, Krea 2는 outputFormat 재정의를 거부 |
편집 요청(공유 image / images 매개변수를 통한 참조 이미지)은
모델별 참조 이미지 제한이 적용되는 모델별 편집 엔드포인트로 라우팅됩니다.
| 모델 계열 | fal/ 뒤의 모델 참조 |
편집 엔드포인트 | 최대 참조 이미지 수 |
|---|---|---|---|
| Flux 및 기타 fal 모델 | fal-ai/flux/dev(기본값) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana(레거시) | fal-ai/nano-banana |
/edit |
3 |
| Nano Banana 2 | fal-ai/nano-banana-* |
/edit |
14 |
| Nano Banana 2 Lite | google/nano-banana-2-lite |
/edit |
14 |
| Krea 2 | krea/v2/{medium,large}/text-to-image |
없음(스타일 참조) | 스타일 참조 10개 |
Krea 2 모델은 fal의 네이티브 Krea 페이로드 스키마를 사용합니다. OpenClaw는
Flux에서 사용하는 일반 image_size / 편집 엔드포인트 페이로드 대신
aspect_ratio, creativity, image_style_references를 전송합니다.
모델 참조는 다음과 같습니다.
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
더 빠르고 표현력 있는 일러스트레이션, 애니메이션, 회화 및 예술적 스타일에는
Medium을 사용하세요. 더 느리지만 사실적인 사진, 원재료 질감, 필름 그레인 및
세밀한 표현에는 Large를 사용하세요. Krea의 기본값은 fal.creativity: "medium"이며,
지원되는 값은 raw, low, medium, high입니다.
Krea 2는 fal 요청 스키마에서 image_size가 아닌 화면비를 노출합니다.
aspectRatio를 우선 사용하세요. OpenClaw는 size를 가장 가까운 지원 Krea
화면비로 매핑하며, Krea에서 resolution을 무시하지 않고 거부합니다.
output_format을 노출하는 fal 모델에서 PNG 출력을 원하면
outputFormat: "png"를 사용하세요. fal은 OpenClaw에서 명시적인 투명 배경
제어 기능을 선언하지 않으므로 fal 모델에서는 background: "transparent"가
무시된 재정의로 보고됩니다.
Krea 2 엔드포인트는 fal을 통해 output_format 요청 필드를 노출하지 않으므로
OpenClaw는 Krea 요청의 outputFormat 재정의를 거부합니다.
Krea 2 Medium을 사용하려면 다음과 같이 설정하세요.
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}동영상 생성
번들로 제공되는 fal 동영상 생성 provider의 기본값은
fal/fal-ai/minimax/video-01-live입니다.
| 기능 | 값 |
|---|---|
| 모드 | 텍스트 기반 동영상, 단일 이미지 참조, Seedance 참조 기반 동영상 |
| 런타임 | 장기 실행 작업을 위한 큐 기반 제출/상태/결과 흐름 |
| 시간 제한 | 기본적으로 작업당 20분, 5초마다 상태 폴링 |
사용 가능한 동영상 모델
MiniMax(기본값):
fal/fal-ai/minimax/video-01-live
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
Kling 및 Wan:
fal/fal-ai/kling-video/v2.1/master/text-to-videofal/fal-ai/wan/v2.2-a14b/text-to-videofal/fal-ai/wan/v2.2-a14b/image-to-video
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
MiniMax Live 및 HeyGen 요청은 프롬프트와 선택적 단일 참조 이미지만
전송하며, 다른 재정의는 전달하지 않습니다. Seedance 모델은
aspectRatio, size, resolution, 4~15초의 재생 시간 및 오디오
전환 옵션을 허용합니다.
Seedance 2.0 구성 예시
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Seedance 2.0 참조 기반 동영상 구성 예시
{ 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 구성 예시
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}음악 생성
번들로 제공되는 fal Plugin은 공유 music_generate 도구를 위한 음악 생성
provider도 등록합니다.
| 기능 | 값 |
|---|---|
| 기본 모델 | fal/fal-ai/minimax-music/v2.6 |
| 모델 | fal-ai/minimax-music/v2.6(mp3), fal-ai/ace-step/prompt-to-audio(wav), fal-ai/stable-audio-25/text-to-audio(wav) |
| 최대 재생 시간 | 240초 |
| 런타임 | 동기식 요청 후 생성된 오디오 다운로드 |
fal을 기본 음악 provider로 사용하려면 다음과 같이 설정하세요.
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6은 명시적 가사와 연주 전용 모드를 지원하지만,
동일한 요청에서 둘 다 사용할 수는 없습니다. ACE-Step과 Stable Audio는
프롬프트 기반 오디오 엔드포인트입니다. 해당 모델 계열을 사용하려면 model
재정의로 선택하세요. ACE-Step은 명시적 가사를 거부하며, Stable Audio는
가사와 연주 전용 모드를 모두 거부합니다.