ImagineVid AI 生成 是做什么的？
使用能力目录，而不是特定于提供商的 API。此公共技能假定主机已连接 ImagineVid 的 OAuth 远程 MCP，地址为 https://imaginevid.io/api/mcp。让主机处理 OAuth 和同意；切勿要求用户粘贴访问令牌或在提示中处理凭据。切勿公开提供商的端点、回调 URL、原始提供商参数或完整的私有账户标识符。
如果远程 MCP 未连接，则停止并要求用户通过主机的 OAuth 流程进行连接。不要替换为任意 API 端点。
关于 ImagineVid
ImagineVid 是一个用于生成 AI 图像、AI 视频和 AI 音乐的 AI 创作平台。其代理接口通过五个稳定的 Agent 工具公开一个不断增长的、供应商中立的目录，从而使连接的代理能够发现和使用许多当前的模型和生成工具，而无需逐个硬编码特定于提供商的 API。
工作流
- 发现。 当已知请求的功能（
image、video或music）时，调用models_list。选择返回的稳定能力id，将其作为capabilityId传递给后续工具，并使用其返回的字段、默认值和约束。不要发明目录未返回的模型或能力。 - 准备自有资源。 如果需要本地媒体，请使用受信任的主机上传界面或 ImagineVid CLI 上传命令（如果该 CLI 已安装）。保留返回的、属于所有者的
assetId。通过 MCP 的assetIds字段传递资源 ID；切勿传递本地文件系统路径、任意远程 URL 或大型 Base64 负载。 - 报价。 使用选定的
capabilityId、产品values和单独的assetIds对象调用generation_quote。为创建步骤保留确切的prompt、values和assetIds请求。将quotedCredits及服务器返回的规范化请求视为权威。切勿在本地计算或选择价格。仅当用户要求查看其可花费余额或主机需要预检检查时，才使用credits_get。 - 确认。 在
generation_create之前，显示选定的能力、重要的值/资源以及确切的quotedCredits。征求用户的明确批准以花费该金额。模糊的生成请求不算作积分确认。如果服务器报告quote_changed，则显示新报价并再次询问。 - 一次性创建。 在调用
generation_create之前生成一个稳定的clientRequestId。为报价发送相同的capabilityId、prompt、values和assetIds，加上等于已确认报价的confirmedCredits。为那个请求精确提交一次。仅为了重放完全相同的请求才重用相同的 ID；不同的输入需要一个新的已报价请求和一个新的 ID。切勿在超时、网络不确定性或提供商超时后重试。 - 轮询。 使用返回的、属于所有者的
generationId以递增的时间间隔调用generation_get。仅报告它返回的状态、安全错误和结果 URL/元数据。不要声称工具未返回的模型、输出或成功。将submission_unknown视为一种特殊的不确定结果：不要再次创建；当持久的 ID 可用时继续轮询。
防护措施
submission_unknown表示提供商可能已接受该唯一提交：不要重试，也不要退款。当返回了持久的生成 ID 时继续轮询；否则报告模糊性以供操作员跟进。insufficient_credits停止工作流。不要重试、静默降级或建议本地计算的价格。unauthorized和forbidden_scope要求用户进行身份验证或授予所需的作用域；不要使用会话 cookie 或其他用户的凭据绕过它们。invalid_input、capability_not_found、asset_not_found和asset_expired要求更正请求或上传新的自有资源。不要替换为提供商的 URL。idempotency_conflict表示请求 ID 曾用于不同的输入；切勿覆盖现有请求。使用新的稳定 ID 重新报价更正后的请求。- 提供商失败并不证明重复提交是安全的。显示安全的服务器错误并等待新的经用户批准的尝试。
有关确切的请求/响应字段和稳定的错误词汇表，请阅读 references/tool-contract.md。该参考是线缆合同辅助工具，而不是实时能力目录的替代品。