アニメーションを中止
cancel_animationの引数、結果スキーマ、OAuth権限、安全注釈を確認済みMCP契約から生成した参考資料です。
このページの目次
ツール
cancel_animation
所有するアニメーションの中止を可能な範囲で試みます。制作中の作業は止まらない場合があり、既に請求されたクレジットは返還されません。
権限と安全
OAuth権限：animations:write
| 安全シグナル | 値 |
|---|---|
destructiveHint |
true |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | true |
| sideEffects | cancellation_requested |
注釈は安全上の特性であり、利用者の同意、OAuth認可、サーバー検査の代わりではありません。
入力引数
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
animation_id |
string |
はい | — | format: uuid |
Owned task the user has asked to cancel. |
引数の例
{
"animation_id": "00000000-0000-4000-8000-000000000002"
}
構造化された結果
| フィールド | 型 | 必須 | 既定値 | 制約 | 説明 |
|---|---|---|---|---|---|
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. |
エラーと次の対応
ツールエラーのerrorにはcode、message、retryable、request_id、detailsがあります。メッセージ本文に依存した分岐や私的入力の漏えいを避けてください。終状態の失敗でも部分成果物を調べます。署名付きURLは保存済みファイルではありません。
この記事は役に立ちましたか？
検索語句、コード、自由記述は収集しません。この設定はドキュメントの操作イベントのみを制御します。 プライバシーポリシー