FlyAIgh

开发者 · MCP

让 AI agent 直接生成图片和视频

FlyAIgh MCP 服务让 Claude Code、Codex、Cursor 等 MCP 客户端调用 FlyAIgh 上所有图片和视频模型:查价格、生成、用自己的参考素材、下载结果,全部用同一个积分余额。

需要 Basic 及以上的订阅。

接口地址

地址
https://www.flyaigh.com/api/mcp
传输方式
Streamable HTTP(无状态)
认证
Authorization: Bearer <你的 API 密钥>

三步接入

  1. 1

    订阅 Basic 及以上

    从 Basic 起的所有付费订阅都包含 API,月付、年付都可以。通过 API 花的积分和网站用的是同一个余额。

  2. 2

    创建 API 密钥

    打开 工具 → MCP,给密钥起个名字并复制。密钥以 fa_live_ 开头,只显示一次,可以随时撤销。

  3. 3

    把 FlyAIgh 加到 agent 里

    粘贴下面对应的配置,然后用自然语言让 agent 生成图片或视频。

连接你的客户端

把 fa_live_your_key 换成你自己的密钥。不要把密钥写进共享文件或代码仓库。

Claude Code

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

Codex · ~/.codex/config.toml

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

然后在终端里设置密钥:export FLYAIGH_API_KEY=fa_live_your_key

Cursor · ~/.cursor/mcp.json

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

其他客户端(只支持 stdio)

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

只能启动本地命令的客户端,可以用 mcp-remote 转接到 HTTP 接口。

工具

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 以内。只能用你自己的文件和生成记录当参考素材。
  • 失败的任务自动退还积分。私有原图以签名链接返回,一小时后失效。

常见问题

使用 FlyAIgh API 需要什么套餐?

Basic 及以上的任意订阅,月付、年付都可以。免费账户,以及只买过尝鲜包或积分包的账户不能创建密钥。订阅到期后密钥会暂停,重新订阅即可恢复。

API 怎么计费?

按积分计费,从你在网站上用的同一个余额里扣,同一模型、同样设置价格完全一样。生成前可以调用 quote 查看精确价格。使用 API 没有额外费用。

agent 能用哪些模型?

FlyAIgh 上所有的图片和视频模型。list_models 返回当前的模型清单,包括每个模型支持的模式、时长、分辨率和示例价格,agent 看到的始终和网站一致。

能用我自己的图片、视频或音频吗?

可以。upload_file 会给 agent 一个上传链接(小文件也可以直接内嵌),返回的文件号可以当首帧或参考素材。素材库里以前生成的内容也能直接用。

API 密钥安全吗?

我们只保存密钥的哈希值,密钥只向你显示一次,可以随时在 MCP 页撤销,撤销后立即失效。请像对待密码一样对待它:放在环境变量里,不要写进共享文件。

能在 ChatGPT 或 Claude 应用里用吗?

目前使用 API 密钥认证,Claude Code、Codex、Cursor 这类编程 agent 都支持。ChatGPT 和 Claude 应用的一键连接器需要 OAuth 登录,已在计划中。

把模型接进你的工作流

创建一个密钥,在 agent 里加一行配置,不离开编辑器或终端就能生成图片和视频。

创建 API 密钥