开发者 · MCP
让 AI agent 直接生成图片和视频
FlyAIgh MCP 服务让 Claude Code、Codex、Cursor 等 MCP 客户端调用 FlyAIgh 上所有图片和视频模型:查价格、生成、用自己的参考素材、下载结果,全部用同一个积分余额。
需要 Basic 及以上的订阅。
接口地址
- 地址
- https://www.flyaigh.com/api/mcp
- 传输方式
- Streamable HTTP(无状态)
- 认证
- Authorization: Bearer <你的 API 密钥>
三步接入
- 1
订阅 Basic 及以上
从 Basic 起的所有付费订阅都包含 API,月付、年付都可以。通过 API 花的积分和网站用的是同一个余额。
- 2
创建 API 密钥
打开 工具 → MCP,给密钥起个名字并复制。密钥以 fa_live_ 开头,只显示一次,可以随时撤销。
- 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 登录,已在计划中。