원본 동영상 생성
generate_video의 인수, 결과 스키마, OAuth 권한, 안전 주석을 확인된 MCP 계약에서 생성한 레퍼런스입니다.
이 페이지의 내용
도구
generate_video
승인된 quote_id 또는 max_credits로 유료 동영상 전용 작업을 시작합니다. ID를 저장하고 get_video_generation으로 조회하며 미리보기·내보내기용 동영상 에셋 ID를 보관하세요.
권한 및 안전
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 and reuse for this logical video generation. |
max_credits |
integer / null |
아니요 | null |
minimum: 0 |
Approved per-operation credit cap. |
quote_id |
string / null |
아니요 | null |
format: uuid |
— |
request |
VideoGenerationCreateRequest | 예 | — | — | — |
인수 예제
{
"idempotency_key": "example-video-001",
"max_credits": 0,
"request": {
"input": {
"first_frame": {
"file_id": "00000000-0000-4000-8000-000000000001",
"type": "file"
}
},
"prompt": "A character runs in place, side view, fixed camera."
}
}
구조화된 결과
| 필드 | 유형 | 필수 | 기본값 | 제약 | 설명 |
|---|---|---|---|---|---|
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은 저장된 파일이 아닙니다.
이 문서가 도움이 되었나요?
검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침