コンテンツにスキップ
ModelflareModelflareModelflare
オープンキャスタリーコンソール

画像・動画

ModelflareMedia Skill

エージェント スキルを 1 つインストールすると、Claude Code、Codex、または SKILL.md 対応エージェントが Modelflare の画像またはビデオ モデルを選択し、通話の価格を決定し、送信して結果を保存できるようになります。

Modelflare Media Skill は、インストール可能なエージェント スキルです。SKILL.md、生成されたモデル参照、および 1 つのヘルパー スクリプトを含むフォルダーです。これがエージェントのスキル ディレクトリに追加されると、Claude Code、Codex、または SKILL.md と表示されるエージェントは、Modelflare 画像またはビデオ モデルを選択し、その価格を見積もり、適切なリクエストを送信し、ビデオを待って結果を保存する方法を理解します。

パッケージはライブ モデル カタログから数分ごとに生成されるため、パッケージ内のモデル リストと価格が古くなることはありません。テキスト モデルは意図的に範囲外です。エージェントはすでにテキスト モデルを持っています。ヘルパー スクリプトには Node.js 18 以降のみが必要で、Claude Code と Codex ではすでに必要であり、macOS、Windows、Linux 上でも同様に動作します。

1.インストール

Section titled “1.インストール”

エージェントがスキルをどこに保管しているかを知る必要はありません。エージェントが行います。このメッセージをすべてのエージェントに送信します。

Text
Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

エージェントがファイルをダウンロードできない場合は、自分で zip をダウンロードし、メッセージに添付してください。スキルをサポートするエージェント (Claude Code、Codex など) は、スキルを独自のスキルの場所にインストールします。スキル メカニズムを持たないエージェントは、パッケージを抽出した場所から SKILL.md を読み取ることができます。

手動インストール (オプション)

Section titled “手動インストール (オプション)”

ファイルを自分で配置する場合 (共有マシンや CI など) にのみ必要です。

ターミナルウィンドウbash
curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

SKILL.md を直接読んで、エージェントが従う内容を確認することもできます。

2. エージェントにキーを渡します

Section titled “2. エージェントにキーを渡します”

コンソール で API キーを作成し、エージェントが実行される環境に設定します。macOS と Linux では、エクスポートをシェル プロファイルに追加して保持します。 Windows では 2 行目で永続化されます。

ターミナルウィンドウbash
export MODELFLARE_API_KEY="sk-..."

自分で環境変数を設定することに慣れていない場合は、プライベート セッションで自分の信頼できるエージェントにキーを送信し、環境の構成を依頼できます。キーをパスワードのように扱います。エージェントが何をどこに書き込むかを確認し、信頼できないサービス、公開/共有チャット、問題、リポジトリ、またはチケットには決して送信しないでください。キーを繰り返さないようにエージェントに依頼し、コピーを保存するか、ソースコード、プロンプト、ログ、またはシェル履歴に入れるか、コミットします。キーが公開された可能性があると思われる場合は、キーを取り消し、すぐに新しいキーを作成します。

スキルはキーをファイルやプロンプトに書き込んだり、出力したりすることはありません。 Castaly を通じて作成されたアカウントには、ロックされていないすべてのグループをルーティングする Castaly という名前のキーがすでにあります。画像またはビデオ グループを含む他のキーも機能します。

3. メディアを求める

Section titled “3. メディアを求める”

通常どおりエージェントに話しかけます。

  • 「gpt-image-2.で夕暮れの海岸展望台の16:9ポスターを生成」
  • 「Seedance を使用して、この開始フレームを 5 秒の 1080p ビデオに変換します。」
  • 「1 秒あたり 0.10 USD 未満のビデオ モデルで、イメージからビデオへの変換ができるのはどれですか?」

エージェントは SKILL.md を読み取り、https://modelflare.dev/api/pricing からライブ カタログをフェッチして、キーが使用できるモデルとそのコストを確認します。次に、 ドキュメント サイト でそのモデル独自のページを開いて、正確なリクエスト本文、パラメーター テーブル、および制限を確認し、独自の HTTP クライアントで API を呼び出します。すべての呼び出しにはヘッダー X-Modelflare-Skill: modelflare-media/1.0 が含まれるため、 使用ログ にはどのリクエストがスキルから来たのかが示されます。

4. Castaly ワークベンチから

Section titled “4. Castaly ワークベンチから”

Castaly ワークベンチ の各世代には、インストール メッセージ、zip、およびタスクの概要を含む「独自のエージェントでこれを再現する」パネルがあります。インストール メッセージを 1 回送信し、概要を貼り付けると、エージェントは自分のキーに対して同じモデルとパラメータを再現します。

スキルでできないこと

Section titled “スキルでできないこと”
  • エージェントにどのように機能するかを指示するものではありません。再試行、バッチ処理、および何を報告するかは、あなたとエージェントの間で決定されます。スキルは API のみを文書化します。
  • 独自のモデル リストはありません。カタログとすべてのリクエスト契約はライブで読み取られるため、今日公開されたモデルは今日から使用できます。
  • ファイルをストレージにアップロードしません。ローカル参照画像はデータ URL としてリクエストに埋め込まれるため、サイズを小さくしてください (数 MB)。
  • モデルグループのロックを解除できません。 API が model_unavailable と応答した場合、そのモデルはこのアカウントでは使用できません。

パッケージレイアウト

Section titled “パッケージレイアウト”
Text
modelflare-media/
  SKILL.md   authentication, where the live catalog is, how to find each model's
             request contract on the docs site, and what the error codes mean

パッケージにはモデル データが含まれていないため、古くなることはありません。新しいスキルバージョンを選択するためにのみ再インストールしてください。