애니메이션 생성

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은 저장된 파일이 아닙니다.

표준 워크플로 · 지출 안전장치

이 문서가 도움이 되었나요?

문서 이용 분석 허용

검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침

도움이 필요하신가요? 지원팀 문의