ImagineVid AI 生成 是做什麼的?
請使用能力目錄,而非特定供應商的 API。此公開技能
假設主機已連接 ImagineVid 的 OAuth 遠端 MCP 於
https://imaginevid.io/api/mcp。讓主機處理 OAuth 與同意授權;絕對不要
要求使用者貼上存取權杖或在提示中處理憑證。
絕不對外揭露供應商端點、回呼 URL、原始供應商參數或
完整的私人帳戶識別碼。
如果遠端 MCP 未連接,請停止並要求使用者透過主機的 OAuth 流程連接。 請勿使用任意的 API 端點作為替代。
關於 ImagineVid
ImagineVid 是一個用於生成 AI 圖像、AI 影片和 AI 音樂的 AI 創作平台。其代理介面透過五個穩定的代理工具,公開了一個不斷擴展、供應商中立的目錄,因此連接的代理可以發現並使用多種當前的模型與生成工具,無需逐一套用特定供應商的 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 時持續輪詢該 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。該參考文件是 線路合約輔助檔案,不能取代即時能力目錄。