AI エージェントから画像と動画をつくる

クライアントを接続

fa_live_your_key を自分のキーに置き換えてください。共有ファイルやリポジトリにはキーを書かないでください。

claude mcp add --transport http flyaigh https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

[mcp_servers.flyaigh]
url = "https://www.flyaigh.com/api/mcp"
bearer_token_env_var = "FLYAIGH_API_KEY"

{
  "mcpServers": {
    "flyaigh": {
      "url": "https://www.flyaigh.com/api/mcp",
      "headers": { "Authorization": "Bearer fa_live_your_key" }
    }
  }
}

npx -y mcp-remote https://www.flyaigh.com/api/mcp \
  --header "Authorization: Bearer fa_live_your_key"

ツール

エージェントには 8 つのツールが見えます。クレジットを使うのは 2 つで、残りは読み取りだけです。

list_models

画像・動画モデルの一覧。対応モード、長さ、解像度、アスペクト比、参照の上限と価格の例。

quote

リクエストのクレジットを正確に見積もります。実際の呼び出しと同じチェックと価格で、課金はされません。

generate_image

画像を生成：テキストから、または参照画像をもとに編集。クレジットを使います。

generate_video

動画を生成：テキスト、最初のフレーム、最初と最後のフレーム、または参照の画像・動画・音声から。クレジットを使います。

get_job

ジョブの状態。完了するとダウンロードリンクを返します。失敗したジョブは自動で返金されます。

list_my_generations

最近の生成物。参照として再利用したり、もう一度ダウンロードしたりできます。

upload_file

自分の画像・動画・音声をアップロードし、参照に使えるファイル ID を受け取ります。

get_balance

残りクレジット、プラン、このキーで今日と今月に使った量。

頼み方の例

FlyAIgh で、雨の夜の通りを紙の舟が流れていく 5 秒・9:16 の動画をつくって。先に価格を見せて、確認したら生成して ./out に保存して。

良いエージェントは quote を呼んで確認を取り、expected_credits と idempotency_key を付けて生成し、ファイルができるまで get_job を確認します。

料金と制限

• 同じモデル・同じ設定ならクレジットはサイトと同じです。API の追加料金も、別の請求もありません。
• 支出の上限はクレジット残高です。MCP ページでキーごとに 1 日の上限を付けることもできます（初期状態では上限なし）。キーごとの日別の利用量も MCP ページで確認できます。
• quote から生成までの間に価格が変わった場合は課金せず、新しい価格を返します（expected_credits）。
• 各キーが送信できるジョブは 1 分に 10 件までなので、暴走したループもすぐ止まります。24 時間以内に同じ idempotency_key で再試行しても二重に課金されません。
• アップロード：画像 25 MB、動画 200 MB、音声 30 MB まで。base64 でのアップロードは 3 MB まで。参照に使えるのは自分のファイルと生成物だけです。
• 失敗したジョブは自動で返金されます。非公開の元ファイルは 1 時間で期限切れになる署名付きリンクで返します。

よくある質問