Communitygithub.com

ImagineVid AI 生成

使用 ImagineVid 的認證代理生成工具,在其當前的多模型能力目錄中建立 AI 圖像、AI 影片和 AI 音樂。

ImagineVid AI 生成 是什麼?

這項技能讓 AI 代理能夠透過統一的代理工具介面,存取 ImagineVid 的 AI 生成平台。它使用供應商中立的「能力目錄」,而非特定供應商的 API,因此代理可以動態發現並使用多種最新的 AI 模型來生成圖像、影片和音樂,無需硬編碼。技能透過五個穩定的代理工具(models_list、generation_quote、generation_create、generation_get 和 credits_get)定義了一個嚴格的工作流程,重點在於正確的資產上傳、準確的信用額度報價、使用者的明確同意以及冪等的請求處理。對於 Claude Code、Cursor 或 Codex 等平台,這項技能實現了安全且可靠的媒體生成,內建了處理重複提交、餘額不足和供應商錯誤的防護機制,確保不會進行未經授權的收費或重試。資產 ID 必須透過 MCP 傳遞,絕不能傳遞本機檔案路徑或遠端 URL。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imagineVid/agent-skills/tree/main/skills/imaginevid-ai-generation

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ImagineVid AI 生成 是做什麼的?

請使用能力目錄,而非特定供應商的 API。此公開技能 假設主機已連接 ImagineVid 的 OAuth 遠端 MCP 於 https://imaginevid.io/api/mcp。讓主機處理 OAuth 與同意授權;絕對不要 要求使用者貼上存取權杖或在提示中處理憑證。 絕不對外揭露供應商端點、回呼 URL、原始供應商參數或 完整的私人帳戶識別碼。

如果遠端 MCP 未連接,請停止並要求使用者透過主機的 OAuth 流程連接。 請勿使用任意的 API 端點作為替代。

關於 ImagineVid

ImagineVid 是一個用於生成 AI 圖像、AI 影片和 AI 音樂的 AI 創作平台。其代理介面透過五個穩定的代理工具,公開了一個不斷擴展、供應商中立的目錄,因此連接的代理可以發現並使用多種當前的模型與生成工具,無需逐一套用特定供應商的 API。

工作流程

  1. 發現。 在已知請求功能(image、video 或 music)時,呼叫 models_list。選擇一個回傳的穩定能力 id,將其作為 capabilityId 傳遞給後續工具,並使用其回傳的欄位、預設值與限制條件。請勿發明日錄未回傳的模型或能力。
  2. 準備自有資產。 如果需要本機媒體,請使用信任的主機上傳介面,或是在已安裝 ImagineVid CLI 的情況下使用其 CLI 上傳命令。保留回傳的擁有者範圍 assetId。透過 MCP 的 assetIds 欄位傳遞資產 ID;絕不傳遞本機檔案系統路徑、任意的遠端 URL,或大型 Base64 承載。
  3. 報價。 使用選定的 capabilityId、產品 values 以及 assetIds 物件分別呼叫 generation_quote。保留建立步驟所需的確切 prompt、values 和 assetIds 請求。將 quotedCredits 和伺服器回傳的正規化請求視為權威資訊。切勿在本機計算或選擇價格。僅在使用者要求查看其可花費餘額或主機需要前置檢查時,才使用 credits_get。
  4. 確認。 在 generation_create 之前,顯示選定的能力、重要的值/資產,以及確切的 quotedCredits。要求人類明確批准花費該金額。模糊的生成請求不等於信用額度確認。如果伺服器回報 quote_changed,則顯示新的報價並再次詢問。
  5. 建立一次。 在呼叫 generation_create 之前,生成一個穩定的 clientRequestId。發送與報價時相同的 capabilityId、prompt、values 和 assetIds,加上等於確認報價的 confirmedCredits。針對該請求,僅提交一次。僅在重播完全相同的請求時才重複使用相同的 ID;不同的輸入需要一個新報價的請求和新 ID。在逾時、網路不明確或供應商逾時後,請勿重試。
  6. 輪詢。 使用回傳的已擁有 generationId,以遞增的間隔呼叫 generation_get。僅報告其回傳的狀態、安全錯誤以及結果 URL/中繼資料。請勿宣稱工具未回傳的模型、輸出或成功。將 submission_unknown 視為特殊的不明確結果:不要再次建立;在可取得持久 ID 時持續輪詢。

防護措施

  • submission_unknown 表示供應商可能已接受該次提交:不要重試,也不要退款。在有回傳持久生成 ID 時持續輪詢該 ID;否則,回報此不明確情況以供操作人員後續處理。
  • insufficient_credits 會停止工作流程。不要重試、默默降級或建議本機計算的價格。
  • unauthorized 和 forbidden_scope 要求使用者進行身分驗證或授予所需範圍;不要使用 session cookie 或其他使用者的憑證來繞過它們。
  • invalid_input、capability_not_found、asset_not_found 和 asset_expired 需要修正請求或上傳新的自有資產。不要替代為供應商 URL。
  • idempotency_conflict 表示請求 ID 已用於不同的輸入;絕不要覆蓋現有請求。使用新的穩定 ID 重新報價修正後的請求。
  • 供應商失敗並不代表重複提交是安全的。呈現安全的伺服器錯誤,並等待新的人類批准嘗試。

如需確切的請求/回應欄位以及穩定的錯誤詞彙,請閱讀 references/tool-contract.md。該參考文件是 線路合約輔助檔案,不能取代即時能力目錄。

相關技能