Skip to content

OpenClaw에는 호스팅 이미지 및 비디오 생성을 위한 fal 프로바이더가 번들로 포함되어 있습니다.

속성
프로바이더fal
인증FAL_KEY (기본 권장 키; FAL_API_KEY도 폴백(fallback)으로 동작)
APIfal 모델 엔드포인트

시작하기

  1. API 키 설정

    bash
        openclaw onboard --auth-choice fal-api-key
        ```
  2. 기본 이미지 모델 설정

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


## 이미지 생성

번들된 `fal` 이미지 생성 프로바이더의 기본값은
`fal/fal-ai/flux/dev`입니다.

| 기능          | 값                         |
| -------------- | -------------------------- |
| 최대 이미지 수 | 요청당 4장                 |
| 편집 모드      | 활성화, 레퍼런스 이미지 1장 |
| 크기 오버라이드| 지원                       |
| 종횡비         | 지원                       |
| 해상도         | 지원                       |

::: warning
fal 이미지 편집 엔드포인트는 `aspectRatio` 오버라이드를 **지원하지 않습니다.**
:::


fal을 기본 이미지 프로바이더로 사용하려면 다음과 같이 설정합니다.

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

비디오 생성

번들된 fal 비디오 생성 프로바이더의 기본값은 fal/fal-ai/minimax/video-01-live입니다.

기능
모드텍스트-투-비디오, 단일 이미지 레퍼런스
런타임장시간 실행되는 작업을 위한 큐 기반 submit/status/result 플로우
사용 가능한 비디오 모델

HeyGen video-agent:

- `fal/fal-ai/heygen/v2/video-agent`

**Seedance 2.0:**

- `fal/bytedance/seedance-2.0/fast/text-to-video`
- `fal/bytedance/seedance-2.0/fast/image-to-video`
- `fal/bytedance/seedance-2.0/text-to-video`
- `fal/bytedance/seedance-2.0/image-to-video`
Seedance 2.0 설정 예시
json5
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
          },
        },
      },
    }
    ```
HeyGen video-agent 설정 예시
json5
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    ```

TIP

최근에 추가된 항목을 포함해 사용 가능한 fal 모델 전체 목록을 보려면 openclaw models list --provider fal을 사용하세요.

관련 문서

이미지 생성 공통 이미지 도구 파라미터와 프로바이더 선택.

비디오 생성 공통 비디오 도구 파라미터와 프로바이더 선택.

설정 레퍼런스 이미지 및 비디오 모델 선택을 포함한 에이전트 기본값.