MCP 工具參考
從註冊 MCP 工具生成引數、返回結構、OAuth 權限、副作用、支出保護與經過核實的開放狀態。
本頁目錄
開放狀態與工作流
官方 MCP 已開放公開測試，端點為 https://api.animgen.com/mcp。使用 Streamable HTTP 與 OAuth，需要已驗證的 AnimGen 帳戶；訂閱提高限額，建立連線不等於批准消費。
工具列表
| 工具 | 權限 | 用途 |
|---|---|---|
| list_models | models:read |
查詢當前啟用模型、合法引數、預設值與輸入能力，不啟動生成。 |
| prepare_image_upload | files:write |
建立短期上傳會話；客戶端按返回的方法和請求頭上傳準確位元組，再完成上傳。本地路徑不能替代檔案傳輸。 |
| complete_image_upload | files:write |
校驗已傳輸的圖片並返回可複用 file_id；此 ID 用於生成輸入。 |
| quote_animation | animations:write |
計算當前費用並建立屬於當前使用者和 OAuth 客戶端的短期 quote_id，不啟動生成或扣費。 |
| quote_video_generation | animations:write |
只報價影片生成，不啟動匯出或生成。 |
| generate_animation | animations:write |
啟動付費非同步動畫，必須有使用者批准的 quote_id 或 max_credits，並儲存冪等鍵。兩個支出欄位與 request 同級；生成開始後可能扣費。 |
| generate_video | animations:write |
建立獨立影片任務；需批准的 quote_id 或 max_credits 及冪等鍵。儲存輸出影片資產 ID。 |
| get_animation | animations:read |
查詢狀態、進度、點數、錯誤和已有資產；失敗或取消也要檢查 outputs。 |
| get_video_generation | animations:read |
查詢獨立影片任務、媒體後設資料、部分產物和點數狀態。 |
| download_asset | assets:read |
返回所屬資產資訊和短期簽名 URL，不自動儲存本地檔案；下載不攜帶 API 或 OAuth 憑據。 |
| preview_video | assets:read |
返回最多 12 格帶時間標籤的聯絡表與實際源時間；下載圖片後檢視。不呼叫 AI 或扣點數，計入儲存並受媒體預算限制。 |
| quote_animation_export | animations:write |
為已有影片報價，FPS 模式返回確定的取樣摘要，不重新生成源影片。 |
| export_animation | animations:write |
從所屬影片資產匯出選區；需批准的報價或點數上限與冪等鍵，修改選區或 FPS 只重新匯出。 |
| get_animation_export | animations:read |
查詢獨立匯出任務、取樣摘要和產物；失敗或取消也檢查 outputs。 |
| cancel_animation | animations:write |
盡力取消所屬任務，可能仍需輪詢；已扣點數不自動退回，先前產物可能保留。 |
| cancel_video_generation | animations:write |
盡力取消影片任務並繼續輪詢，取消不保證退款。 |
| cancel_animation_export | animations:write |
只取消匯出，保留仍有效的源影片；繼續輪詢到終態。 |
這篇文件有幫助嗎？
不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。 隱私權政策