关于 imaginevid-ai-generation
imaginevid-ai-generation 是 ImagineVid 图像、视频和音乐生成平台的开源分发项目,包含 REST 客户端、CLI 和本地 MCP 适配器。它支持通过托管 OAuth 服务或本地 API 密钥接入,并在生成前报价及要求明确确认额度。
主要功能
- 01列出模型并查询额度
- 02获取生成报价并提交任务
- 03查询生成任务状态
- 04上传资源并使用自有资源 ID
- 05通过幂等键和额度确认保护生成
适用场景
- 01查看可用模型和账户额度
- 02生成前核对报价与额度消耗
- 03提交生成任务并跟踪状态
- 04上传并在生成任务中引用资源
MCP 相关
提供 OAuth 保护的托管 Streamable HTTP MCP 服务,以及使用 API 密钥的本地 stdio 适配器。服务向客户端开放模型、额度、报价和生成任务相关工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://imaginevid.io/api/mcpclaude mcp add --transport http io-imaginevid-imaginevid-ai-generation https://imaginevid.io/api/mcp{"mcpServers":{"io-imaginevid-imaginevid-ai-generation":{"type":"http","url":"https://imaginevid.io/api/mcp"}}}在 Cursor 中打开{"servers":{"io-imaginevid-imaginevid-ai-generation":{"type":"http","url":"https://imaginevid.io/api/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-imaginevid-imaginevid-ai-generation":{"type":"http","url":"https://imaginevid.io/api/mcp"}}}{"mcpServers":{"io-imaginevid-imaginevid-ai-generation":{"serverUrl":"https://imaginevid.io/api/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
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-client,类型化 Agent REST v1 客户端。imaginevid-cli,命令行适配器。imaginevid-mcp,本地 stdio MCP 适配器。server.json,托管 MCP Registry 元数据。
如需查看产品文档、生成工具和账户访问信息,请访问 ImagineVid 网站。源代码相关问题请提交至此 GitHub 代码库。
安全与许可证
请勿提交 API 密钥或账户配置。托管端点使用 OAuth;本地适配器从环境变量或仅所有者可访问的本地配置文件中读取凭据。请通过 ImagineVid 支持页面报告包或安全问题。
公开发行的代码采用 MIT-0 许可证。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。