mcpField
I
imaginevid-ai-generation

imaginevid-ai-generation

远程服务
imaginevid.io媒体与设计012 周前更新

关于 imaginevid-ai-generation

imaginevid-ai-generation 是 ImagineVid 图像、视频和音乐生成平台的开源分发项目,包含 REST 客户端、CLI 和本地 MCP 适配器。它支持通过托管 OAuth 服务或本地 API 密钥接入,并在生成前报价及要求明确确认额度。

主要功能

  1. 01列出模型并查询额度
  2. 02获取生成报价并提交任务
  3. 03查询生成任务状态
  4. 04上传资源并使用自有资源 ID
  5. 05通过幂等键和额度确认保护生成

适用场景

  1. 01查看可用模型和账户额度
  2. 02生成前核对报价与额度消耗
  3. 03提交生成任务并跟踪状态
  4. 04上传并在生成任务中引用资源

MCP 相关

提供 OAuth 保护的托管 Streamable HTTP MCP 服务,以及使用 API 密钥的本地 stdio 适配器。服务向客户端开放模型、额度、报价和生成任务相关工具。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://imaginevid.io/api/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包
npmimaginevid-mcp0.1.0

工具

详细介绍

ImagineVid Agent Tools AI

ImagineVid 的开源发行包,这是一个用于生成图像、视频和音乐的 AI 平台。此代码库包含类型化 REST 客户端、CLI 和本地 stdio MCP 适配器。托管 MCP 服务仍是身份验证、OAuth 授权同意、作用域、额度、报价、幂等性、自有资源和提供商生命周期的权威来源。

选择连接方式

托管 MCP

当你的宿主支持远程 MCP 服务时,请使用受 OAuth 保护的 Streamable HTTP 端点:

{
  "mcpServers": {
    "imaginevid": {
      "url": "https://imaginevid.io/api/mcp"
    }
  }
}

宿主负责处理 OAuth 和明确的授权同意。该端点提供 models_list、credits_get、generation_quote、generation_create 和 generation_get。有关产品和账户流程,请参阅 ImagineVid 网站。

本地 stdio MCP

npm 包发布后,使用以下配置设置本地主机:

{
  "mcpServers": {
    "imaginevid": {
      "command": "npx",
      "args": ["-y", "imaginevid-mcp"],
      "env": {
        "IMAGINEVID_API_KEY": "${IMAGINEVID_API_KEY}",
        "IMAGINEVID_BASE_URL": "https://imaginevid.io"
      }
    }
  }
}

本地适配器使用限定作用域的 API 密钥,不会打印密钥,也不会对含义不明确的 submission_unknown 结果进行重试。它接受产品能力值和自有资源 ID,不接受提供商参数、任意远程 URL 或内联 base64 媒体。

CLI

npm 包发布后:

npm install --global imaginevid-cli
export IMAGINEVID_API_KEY="..."
imaginevid models list
imaginevid credits

CLI 还支持 assets upload、generate、generations get 和 generations wait。generate 会先获取报价,并要求提供精确、明确的额度确认以及稳定的幂等键。

开发

pnpm install
pnpm test
pnpm build

公开的包元数据和发行文件位于:

如需查看产品文档、生成工具和账户访问信息,请访问 ImagineVid 网站。源代码相关问题请提交至此 GitHub 代码库。

安全与许可证

请勿提交 API 密钥或账户配置。托管端点使用 OAuth;本地适配器从环境变量或仅所有者可访问的本地配置文件中读取凭据。请通过 ImagineVid 支持页面报告包或安全问题。

公开发行的代码采用 MIT-0 许可证。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。