アニメーションを書き出す

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

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

このページの目次

ツール

export_animation

承認済みのquote_idまたはmax_creditsを使い、既存の動画素材から有料書き出しを開始します。区間やFPSを変えても新しい書き出しを作るだけで、元の動きは再生成しません。

権限と安全

OAuth権限：animations:write

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

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

入力引数

フィールド	型	必須	既定値	制約	説明
`idempotency_key`	`string`	はい	—	`minLength`: `8`; `maxLength`: `200`	Reuse unchanged on retry; use a new key when changing the selection or FPS.
`max_credits`	`integer` / `null`	いいえ	`null`	`minimum`: `0`	Approved per-operation credit cap.
`quote_id`	`string` / `null`	いいえ	`null`	`format`: `uuid`	—
`request`	AnimationExportCreateRequest	はい	—	—	—

引数の例

json

{
  "idempotency_key": "example-export-001",
  "max_credits": 0,
  "request": {
    "export": {
      "fps": 12,
      "output_formats": [
        "spritesheet",
        "spritesheet_json"
      ]
    },
    "selection": {
      "duration_seconds": 2,
      "mode": "range",
      "start_seconds": 1
    },
    "source_video_asset_id": "00000000-0000-4000-8000-000000000003"
  }
}

構造化された結果

フィールド	型	必須	既定値	制約	説明
`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は保存済みファイルではありません。

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

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

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

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

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