imaginode

Imaginode MCP 服务

通过 ChatGPT、Claude、Claude Code、Cursor 或任何 MCP 客户端，借助 imaginode.ai（一个基于节点画布的 AI 创作工作室），生成 AI 图像和视频。

• 一个账号即可使用 89 个模型：Flux 2、Nano Banana 2、Seedream 5、GPT Image、Kling V3、Seedance 2.5、Veo 3.1、Hailuo、Wan 等。完整目录按模型分别列出，详见 imaginode.ai/models。
• 登录即可，无需粘贴密钥：服务采用 OAuth 2.1。ChatGPT、Claude 和 Claude Code 会打开 Imaginode 页面，你登录并授权应用即可。不支持 OAuth 的脚本和客户端仍可使用 API 密钥。
• 内置模板：Imaginode 画布中的精选工作流（产品拍摄、翻新、视频特效、儿童读物、缩略图……）以配方形式提供，并附带可直接运行的打开链接。
• 价格透明：每次生成都会返回准确的积分费用（1 积分 = $0.012，或以欧元结算时为 €0.01）。生成失败会自动退款。你可以使用费用计算器在运行前估算价格，无需账号。
• 远程服务，无需安装：https://imaginode.ai/api/mcp（Streamable HTTP）。

调用前了解费用

API 会返回每次生成的准确费用，但你通常会想在编写调用代码前了解价格。以下两个公开页面无需账号即可提供相关信息：

• 费用计算器：选择模型、时长和分辨率，即可查看以积分和美元计价的价格。
• GET /api/models：以机器可读的 JSON 格式提供相同的目录和价格，无需身份验证，客户端可据此自行估算费用。

快速开始

1. 在 imaginode.ai 创建免费账号（包含试用积分，需要验证邮箱）。
2. 连接客户端。各助手的完整操作指南见 imaginode.ai/mcp。

ChatGPT：依次打开 Settings、Apps and connectors、Create：粘贴 https://imaginode.ai/api/mcp，选择 OAuth，然后登录 Imaginode 账号。

Claude.ai / Claude Desktop：依次打开 Settings、Connectors、Add custom connector：粘贴 https://imaginode.ai/api/mcp，并在 Claude 提示时登录。

Claude Code（首次使用时会在浏览器中打开登录页面）：

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp

Cursor（.cursor/mcp.json，OAuth）：

{
  "mcpServers": {
    "imaginode": { "url": "https://imaginode.ai/api/mcp" }
  }
}

改用 API 密钥（脚本、不支持 OAuth 的客户端）：在个人资料的 API keys 部分创建密钥，并将其作为请求头发送：

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer imk_YOUR_KEY"

然后直接向助手提问：“生成一张电影感的图像：一只红狐身处薄雾笼罩的森林”、“制作一段 5 秒的视频，展现日落时分的海浪”，或 “哪个 Imaginode 模板可以把我的自拍变成收藏手办？”。

工具

工具	功能
list_models	图片和视频模型目录，包含以积分计价的价格和可计费选项。
list_templates	精选画布模板：每个模板的产出、所用模型，以及单次运行的大致成本。
get_template	模板的完整配方（节点、模型、提示词、连线、示例渲染），以及在画布中打开模板的链接。
generate_image	生成图片并等待结果：直接返回 URL。默认模型：Nano Banana 2。
generate_video	启动视频生成并返回 request_id 和确切成本。默认模型：Seedance 2.0。
get_generation_status	查询生成状态（running、包含输出 URL 的 completed，或自动退款的 failed）。

视频通常需要 1 到 5 分钟（长任务最多需要 30 分钟）：每隔 30 秒调用一次 get_generation_status 进行轮询。

OAuth 详情（面向客户端开发者）

• 发现：https://imaginode.ai/.well-known/oauth-authorization-server 和 https://imaginode.ai/.well-known/oauth-protected-resource。
• 使用 PKCE（S256）的授权码流程和刷新令牌（轮换）。同时支持动态客户端注册（RFC 7591）和客户端 ID 元数据文档；重定向 URI 可以是 https、环回 http 或私有应用 scheme。
• 范围：generate。未经身份验证的请求会收到带有 WWW-Authenticate: Bearer resource_metadata="…" 的 401 响应。
• 用户可以在个人资料中撤销已连接的应用，客户端也可以通过撤销端点（RFC 7009）撤销。

直接调用 REST API

MCP 服务是对三个公共端点的轻量封装，你也可以在任何脚本中调用这些端点（在 Authorization 标头中传入 API 密钥或 OAuth 访问令牌）：

• GET https://imaginode.ai/api/models：模型目录和价格，无需身份验证。
• POST https://imaginode.ai/api/generate：请求正文为 { "model", "prompt", "duration", "resolution", "aspectRatio", "audio", "imageUrls" }，标头为 Authorization: Bearer imk_…。返回 { requestId, cost, balance }。
• GET https://imaginode.ai/api/generate/status?requestId=…：返回 running、completed（包含 outputUrls）或 failed（已退款）。

输入图片必须是托管在你的 Imaginode 账户中的媒体（媒体库中的媒体或之前生成的内容）。

完整文档：imaginode.ai/docs/api-mcp。

限额与安全

• API 密钥是个人机密：只显示一次，可随时在个人资料中撤销，最多可有 5 个有效密钥。
• 每个密钥和每个 OAuth 访问令牌的速率限制均为每分钟 10 次生成。
• OAuth 访问令牌有效期为一小时，并会静默刷新；你可以随时在个人资料的“已连接的应用”中断开已连接的应用。
• 每次调用都会从你自己的账户扣除积分，价格与画布相同；支出不会超过账户余额，失败时会退款。

Claude 技能

skills/imaginode 文件夹包含一项可选的 Claude Code 技能，可指导 Claude 更好地使用此服务（优先使用低成本模型进行迭代、关注成本、合理安排轮询频率）。将此文件夹复制到 ~/.claude/skills/imaginode 即可安装。

许可证

MIT。服务本身运行在 imaginode.ai；此仓库托管其公开清单、文档和技能。