讓 AI agent 直接生成圖片和影片

連接你的客戶端

把 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"

工具

agent 能看到 8 個工具，其中 2 個會花點數，其餘唯讀。

list_models

圖片或影片模型清單：支援的模式、長度、解析度、比例、參考素材上限和示例價格。

quote

精確報價：和實際生成走同一套檢查和計價，不扣點數。

generate_image

生成圖片：文生圖，或參考、編輯你的圖片。會花點數。

generate_video

生成影片：文生影片、首幀、首尾幀，或參考圖片、影片和音訊。會花點數。

get_job

查詢任務狀態。完成後提供下載連結；失敗自動退還點數。

list_my_generations

最近的生成紀錄，可以拿來當參考素材或重新下載。

upload_file

上傳你自己的圖片、影片或音訊，取得可當參考素材的檔案編號。

get_balance

剩餘點數、訂閱方案，以及這把金鑰今天和本月花了多少。

可以這樣說

用 FlyAIgh 做一段 5 秒、9:16 的影片：雨夜的街上，一艘紙船順著積水漂過。先告訴我價格，確認後再生成，並把檔案存到 ./out。

好的 agent 會先呼叫 quote、請你確認，生成時帶上 expected_credits 和 idempotency_key，再反覆呼叫 get_job 直到檔案完成。

價格和限制

• 同一模型、同樣設定，點數和網站完全一樣。沒有 API 附加費，也沒有另外的 API 帳單。
• 花費上限就是帳戶點數餘額。你也可以在 MCP 頁替某把金鑰另設每日上限，預設不設。每把金鑰每天花了多少點數，也在 MCP 頁查看。
• 如果報價後價格變了，生成時不會扣點，並回傳新價格（expected_credits）。
• 每把金鑰每分鐘最多送出 10 個任務，agent 無限迴圈會很快被擋下。24 小時內用同一個 idempotency_key 重試，不會重複扣點。
• 上傳：圖片 25 MB、影片 200 MB、音訊 30 MB 以內；base64 內嵌上傳 3 MB 以內。只能使用你自己的檔案和生成紀錄當參考素材。
• 失敗的任務自動退還點數。私有原圖以簽章連結回傳，一小時後失效。

常見問題