Skill

エフェクトテンプレート

Freebeat のエフェクトテンプレートを探し、音楽・画像・プロンプトからエフェクト動画クリップを生成します。

freebeat CLI

今すぐ試すプリインストール済み

コミュニティ総利用数

3クレジット使用量

7総生成数

Skill について

skill.md

# エフェクトテンプレート

汎用のテキスト動画生成ではなく、Freebeat エフェクトテンプレートのクリップが必要な場合に使います。

## 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 キーを貼り付けたりログに残したりしないでください。ユーザーの端末、シークレットストア、環境変数で渡してもらいます。

## テンプレートを探す

~~~bash
freebeat effects list
freebeat effects list --json
~~~

## エフェクトタスクを送信

~~~bash
freebeat effect submit --effect-id <effectId> --music-id <musicId> --image-url <imageUrl> --prompt "アニメ風の発光" --wait
~~~

## テンプレート既定値で実行

~~~bash
freebeat effect run --effect-id <effectId> --prompt "アニメ風の発光" --wait
freebeat effect run --effect-id <effectId> --audio song.mp3 --image ref.png --prompt "アニメ風の発光" --wait
~~~

エフェクトコマンドは --audio、--image、--watermark、--wait に対応します。テンプレートに既定素材があり、より速い手順が必要な場合は effect run を使います。

## 進行状況を確認

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 を使います。