アニメーションを生成

generate_animationの引数、結果スキーマ、OAuth権限、安全注釈を確認済みMCP契約から生成した参考資料です。

公開ベータ最終確認 2026-09-15

このページの目次

ツール

generate_animation

有料の非同期アニメーションを開始します。事前のquote_idまたは明示的なmax_credits上限と、冪等性キーが必要です。制作開始後にクレジットが請求され得ます。

権限と安全

OAuth権限：animations:write

安全シグナル	値
`destructiveHint`	`true`
`idempotentHint`	`true`
`openWorldHint`	`true`
`readOnlyHint`	`false`
spendsCredits	`true`
requiresUserConfirmation	`true`
sideEffects	`generation_started`, `credits_reserved_or_charged`

注釈は安全上の特性であり、利用者の同意、OAuth認可、サーバー検査の代わりではありません。

入力引数

フィールド	型	必須	既定値	制約	説明
`idempotency_key`	`string`	はい	—	`minLength`: `8`; `maxLength`: `200`	Persist per logical generation; reuse with the same OAuth client and user after a timeout.
`max_credits`	`integer` / `null`	いいえ	`null`	`minimum`: `0`	User-approved per-operation credit cap. Never silently increase it; this is not a multi-task budget.
`quote_id`	`string` / `null`	いいえ	`null`	`format`: `uuid`	Fresh approved quote. At least quote_id or max_credits is required; both are allowed.
`request`	AnimationCreateRequest	はい	—	—	Exact user-approved request; keep unchanged across retries.

引数の例

json

{
  "idempotency_key": "example-operation-001",
  "max_credits": 0,
  "quote_id": "00000000-0000-4000-8000-000000000006",
  "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"
    }
  }
}

構造化された結果

フィールド	型	必須	既定値	制約	説明
`created_at`	`string`	はい	—	`format`: `date-time`	UTC acceptance timestamp.
`credits`	CreditUsage	はい	—	—	Quoted, reserved, and charged credit states.
`error`	TaskError / `null`	いいえ	`null`	—	Task failure details, independently of any usable outputs.
`finished_at`	`string` / `null`	いいえ	`null`	`format`: `date-time`	UTC terminal timestamp when known.
`id`	`string`	はい	—	`format`: `uuid`	Persist this task ID immediately after create; poll it instead of creating again.
`metadata`	`object`	いいえ	`{}`	—	Caller-provided metadata.
`normalized_input`	`object`	いいえ	`{}`	—	Normalized public input; may contain private prompts or image references. Do not log wholesale.
`object`	`string`	はい	—	enum: `"video_generation"`, `"animation_export"`, `"animation"`	Public task resource type.
`outputs`	array<AssetResponse>	いいえ	`[]`	—	Available assets, including partial outputs on failed/cancelled tasks. Always inspect them at a terminal state.
`progress`	`number`	はい	—	`minimum`: `0`; `maximum`: `1`	Fraction from 0 to 1, not a completion-time estimate.
`resolved_export`	ResolvedExport / `null`	いいえ	`null`	—	Persisted FPS sampling summary shared with the quote and manifest; null for legacy tasks.
`stage`	`string` / `null`	いいえ	`null`	enum: `"queued"`, `"video_generation"`, `"animation_export"`, `"completed"`	Current pipeline stage when available.
`started_at`	`string` / `null`	いいえ	`null`	`format`: `date-time`	UTC production start when known.
`status`	`string`	はい	—	enum: `"queued"`, `"running"`, `"cancelling"`, `"succeeded"`, `"failed"`, `"cancelled"`	succeeded, failed, and cancelled are terminal; cancelling is not terminal.

TaskResponse

エラーと次の対応

ツールエラーのerrorにはcode、message、retryable、request_id、detailsがあります。メッセージ本文に依存した分岐や私的入力の漏えいを避けてください。終状態の失敗でも部分成果物を調べます。署名付きURLは保存済みファイルではありません。

標準ワークフロー · 支出保護

この記事は役に立ちましたか？

ドキュメントの利用状況解析を許可

検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。プライバシーポリシー

お困りですか？サポートへ