Fal

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

시작하기

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

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

이미지 생성

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

Krea 2 모델은 fal의 네이티브 Krea 페이로드 스키마를 사용합니다. OpenClaw는 Flux에서 사용하는 일반 image_size / 편집 엔드포인트 페이로드 대신 aspect_ratio, creativity, image_style_references를 보냅니다. 모델 참조는 다음과 같습니다.

• fal/krea/v2/medium/text-to-image
• fal/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에서 명시적인 투명 배경 제어를 선언하지 않으므로 background: "transparent"는 fal 모델에서 무시된 재정의로 보고됩니다. Krea 2 엔드포인트는 fal을 통해 output_format 요청 필드를 노출하지 않으므로, OpenClaw는 Krea 요청에 대한 outputFormat 재정의를 거부합니다.

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

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

Krea 2 Medium을 사용하려면:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

비디오 생성

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

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

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

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

음악 생성

번들 fal Plugin은 공유 music_generate 도구를 위한 음악 생성 제공자도 등록합니다.

fal을 기본 음악 제공자로 사용하세요:

{  agents: {    defaults: {      musicGenerationModel: {        primary: "fal/fal-ai/minimax-music/v2.6",      },    },  },}

fal-ai/minimax-music/v2.6는 명시적 가사와 악기 모드를 지원합니다. ACE-Step과 Stable Audio는 프롬프트-투-오디오 엔드포인트입니다. 해당 모델 패밀리를 원할 때 model 재정의로 선택하세요.

관련 항목