본문으로 건너뛰기
사용 문서

문서 검색

검색은 브라우저 안에서만 이루어지며 검색어를 전송하거나 저장하지 않습니다. 인증 정보를 입력하지 마세요.

검색 색인을 불러오는 중…

Tab 또는 방향키로 이동 · Enter로 열기 · Esc로 닫기
문서 탐색

동영상 업로드 준비

prepare_video_upload의 인수, 결과 스키마, OAuth 권한, 안전 주석을 확인된 MCP 계약에서 생성한 레퍼런스입니다.

공개 베타최종 확인
이 페이지의 내용

도구

prepare_video_upload

최대 100 MiB, 30초의 비공개 MP4/MOV/WebM 업로드를 준비합니다. 바이트 전송 후 완료하세요. 깊이 처리나 생성은 시작하지 않습니다.

권한 및 안전

OAuth 권한: files:write

안전 신호 값
destructiveHint false
idempotentHint false
openWorldHint true
readOnlyHint false
spendsCredits false
requiresUserConfirmation false
sideEffects temporary_upload_created

주석은 안전 특성을 설명하며 사용자 동의, OAuth 승인, 서버 검사를 대체하지 않습니다.

입력 인수

필드 유형 필수 기본값 제약 설명
request VideoUploadRequest 예 — — —

인수 예제

json
{
  "request": {
    "byte_size": 1024,
    "filename": "motion.mp4",
    "mime_type": "video/mp4"
  }
}

구조화된 결과

필드 유형 필수 기본값 제약 설명
expires_at string 예 — format: date-time Upload session expiry in UTC.
headers object 예 — — Use these exact headers for byte transfer.
max_bytes integer 예 — — Source byte limit.
method string 아니요 "PUT" const: "PUT" —
upload_id string 예 — format: uuid Session to complete after transferring bytes; not usable as a video input yet.
upload_url string 예 — — Sensitive short-lived upload URL. Transfer bytes without API/OAuth credentials.

VideoUploadSession

오류 및 다음 단계

도구 오류의 error 객체에는 code, message, retryable, request_id, details가 있습니다. 메시지 문구로 분기하거나 비공개 입력을 노출하지 마세요. 종료 실패 후에도 부분 출력을 확인하세요. 서명 URL은 저장된 파일이 아닙니다.

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

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

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

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