Providers
Fal
OpenClaw는 호스팅 이미지 및 비디오 생성을 위한 번들된 fal provider를 제공합니다.
| 속성 | 값 |
|---|---|
| Provider | fal |
| 인증 | FAL_KEY(기본값; FAL_API_KEY도 폴백으로 동작) |
| API | fal model 엔드포인트 |
시작하기
API 키 설정
openclaw onboard --auth-choice fal-api-key
기본 이미지 model 설정
{
agents: {
defaults: {
imageGenerationModel: {
primary: "fal/fal-ai/flux/dev",
},
},
},
}
이미지 생성
번들된 fal 이미지 생성 provider의 기본값은
fal/fal-ai/flux/dev입니다.
| 기능 | 값 |
|---|---|
| 최대 이미지 수 | 요청당 4개 |
| 편집 모드 | 활성화됨, 참조 이미지 1개 |
| 크기 재정의 | 지원됨 |
| 종횡비 | 지원됨 |
| 해상도 | 지원됨 |
| 출력 형식 | png 또는 jpeg |
PNG 출력이 필요하면 outputFormat: "png"를 사용하세요. fal은 OpenClaw에서
명시적인 투명 배경 제어를 선언하지 않으므로 background: "transparent"는 fal model에 대해 무시된 재정의로 보고됩니다.
fal을 기본 이미지 provider로 사용하려면:
{
agents: {
defaults: {
imageGenerationModel: {
primary: "fal/fal-ai/flux/dev",
},
},
},
}
비디오 생성
번들된 fal 비디오 생성 provider의 기본값은
fal/fal-ai/minimax/video-01-live입니다.
| 기능 | 값 |
|---|---|
| 모드 | 텍스트-비디오, 단일 이미지 참조, Seedance 참조-비디오 |
| 런타임 | 장시간 실행 작업을 위한 큐 기반 submit/status/result 흐름 |
사용 가능한 비디오 model
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
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
Seedance 2.0 config 예시
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
},
},
},
}
Seedance 2.0 참조-비디오 config 예시
{
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 예시
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/fal-ai/heygen/v2/video-agent",
},
},
},
}