查询动画报价

从真实 quote_animation 工具生成输入、输出、OAuth 权限与安全注解，与经过核实的 MCP 契约保持一致。

公开测试最后核实 2026-08-30

本页目录

工具

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 客户端的短期报价，可绑定一次逻辑生成键。

McpQuoteOutput

错误与后续步骤

工具错误包含 error 对象，内有 code、message、retryable、request_id 和 details。不要依赖消息文本分支或泄露私有输入。终态失败也要检查部分产物；返回签名 URL 不代表已保存文件。

标准工作流 · 支出保护

这篇文档有帮助吗？

允许文档使用分析

不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。隐私政策

需要帮助？联系支持