查詢動畫報價

從真實 quote_animation 工具生成輸入、輸出、OAuth 權限與安全註解，與經過核實的 MCP 契約保持一致。

公開測試最後核實 2026-09-15

本頁目錄

工具

quote_animation

計算當前費用並建立屬於當前使用者和 OAuth 客戶端的短期 quote_id，不啟動生成或扣費。

權限與安全

OAuth 權限：animations:write

訊號	值
`destructiveHint`	`false`
`idempotentHint`	`false`
`openWorldHint`	`false`
`readOnlyHint`	`true`
spendsCredits	`false`
requiresUserConfirmation	`false`
sideEffects	`temporary_quote_created`

註解用於描述安全屬性，不能替代使用者批准、OAuth 授權或服務端校驗。

輸入引數

欄位	型別	必填	預設值	約束	含義
`request`	AnimationCreateRequest	是	—	—	計劃生成的完整請求，報價不啟動生成。

引數示例

json

{
  "request": {
    "export": {
      "frame_count": 24,
      "output_formats": [
        "frames_zip"
      ],
      "output_height": 512,
      "output_width": 512
    },
    "input": {
      "first_frame": {
        "file_id": "00000000-0000-4000-8000-000000000001",
        "type": "file"
      }
    },
    "prompt": "A character runs in place, side view, fixed camera.",
    "selection": {
      "mode": "full"
    }
  }
}

結構化返回

欄位	型別	必填	預設值	約束	含義
`breakdown`	`object`	是	—	—	公開費用組成。
`credits`	`integer`	是	—	—	報價點數，生成前需向用戶展示。
`expires_at`	`string`	是	—	`format`: `date-time`	報價過期時間；過期或變價時重新報價並確認。
`quote_id`	`string`	是	—	`format`: `uuid`	屬於當前使用者和 OAuth 客戶端的短期報價，可繫結一次邏輯生成鍵。
`resolved_export`	ResolvedExport / `null`	否	`null`	—	獨立 FPS 匯出的確定取樣摘要。

McpQuoteOutput

錯誤與後續步驟

工具錯誤包含 error 物件，內有 code、message、retryable、request_id 和 details。不要依賴訊息文本分支或洩露私有輸入。終態失敗也要檢查部分產物；返回簽名 URL 不代表已儲存檔案。

標準工作流 · 支出保護

這篇文件有幫助嗎？

允許文件互動分析

不收集搜尋字詞、程式碼或自由文字。此開關僅控制文件互動事件。隱私權政策

需要協助？聯絡支援