Skill

タスク結果

Freebeat の MV、エフェクト、画像、動画ジョブをポーリングし、完了した結果 URL を取得します。

freebeat CLI

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

コミュニティ総利用数

7クレジット使用量

9総生成数

Skill について

skill.md

# タスク結果

Freebeat task id または Open RPC batch id が既にあり、ステータス確認、待機、結果 URL 取得が必要な場合に使います。

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

## 従来の MV・エフェクトタスク

~~~bash
freebeat task status <task-id>
freebeat task wait <task-id>
freebeat task result <task-id>
~~~

## Open RPC 画像・動画バッチ

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

## JSON 出力

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

## 待機の挙動

既定のポーリング間隔は 15 秒、既定タイムアウトは 2 時間です。長いキューや高速なローカル確認に合わせて変更します:

~~~bash
freebeat task wait <task-id> --poll-interval 30s --timeout 3h
~~~

期待結果: 実行中は CLI がステータスフィールドを返し、完了後に video_url、cover_url、または Open RPC の結果 URL を返します。