Skill

이미지 스튜디오

Freebeat CLI로 Nano Banana, Wan, GPT-Image 모델을 사용해 이미지를 생성하고 편집합니다.

freebeat CLI

지금 사용하기사전 설치됨

커뮤니티 총 사용량

5크레딧 사용량

8전체 생성 수

Skill 정보

skill.md

# 이미지 스튜디오

정지 이미지 생성 또는 프롬프트 기반 이미지 편집에 사용합니다.

## CLI 명령을 실행하기 전에

Freebeat CLI는 npm 패키지이자 인증 API 클라이언트입니다. 먼저 설치하거나 업데이트하세요:

~~~bash
npm install -g freebeat-cli@latest
freebeat --help
~~~

생성 전에 Freebeat API 키가 필요합니다. 다음 방식 중 하나를 사용하세요:

~~~bash
freebeat auth set-api-key
printf '%s' "$FREEBEAT_API_KEY" | freebeat auth set-api-key --stdin
freebeat --api-key <apiKey> <command>
~~~

유료 또는 장시간 워크플로를 시작하기 전에 인증 정보를 확인하세요:

~~~bash
freebeat auth show
freebeat auth test
~~~

원본 API 키를 붙여넣거나 로그로 남기지 마세요. 사용자가 터미널, 시크릿 저장소 또는 환경 변수로 제공하게 하세요.

## 지원 이미지 모델

- Nano Banana 2: --model 80
- Nano Banana Pro: --model 64
- Wan V2.7 Image: --model 99
- Wan V2.7 Pro Image: --model 100
- GPT-Image 2: --model 108

생성 전에 모델 확인:

~~~bash
freebeat models help --name 108
~~~

## 새 이미지 생성

~~~bash
freebeat image generate --model 80 --prompt "네온 도시 앨범 커버" --size 1024x1024 --count 1 --wait
freebeat image generate --model 108 --prompt "스튜디오 조명의 프리미엄 제품 포스터" --resolution 1024x1024 --quality medium --count 1 --wait
~~~

## 이미지 편집

첫 CLI 버전은 --image를 정확히 하나만 받습니다. 로컬 파일 경로나 이미지 URL을 사용하세요.

~~~bash
freebeat image edit --model 80 --image ref.png --prompt "영화적이고 캠페인에 맞게 만들기" --wait
freebeat image edit --model 108 --image https://cdn.example.com/ref.png --prompt "이것을 세련된 앨범 커버로 만들기" --resolution 1024x1024 --quality medium --wait
~~~

## GPT-Image 2 파라미터

GPT-Image 2는 --model 108을 사용하며 --quality low|medium|high와 --resolution을 지원합니다. freebeat-cli 0.1.2 이상에서는 생략 시 --quality는 medium, --resolution은 1024x1024가 기본입니다. --resolution이 없고 --size가 있으면 CLI는 호환성을 위해 --size 값을 resolution으로 전송합니다.

## 출력 처리

이미지 명령은 batch id와 serial number를 반환합니다. 스크립트나 Agent에는 --json을 추가하세요.

## 진행 상황 확인

Open RPC 이미지 및 비디오 명령은 batch id와 serial number를 반환합니다. 레거시 MV 및 효과 명령은 task id를 반환합니다.

~~~bash
freebeat task status <batch-id>
freebeat task status <batch-id> --serial-no <serial-no>
freebeat task wait <batch-id> --serial-no <serial-no>
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

다른 Agent, 스크립트 또는 CI가 task id, batch id, serial number, 결과 URL, credits, status를 파싱해야 하면 --json을 사용하세요.