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 は 1 つだけ指定できます。ローカルパスまたは画像 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 を使います。