원본 동영상 미리보기
preview_video의 인수, 결과 스키마, OAuth 권한, 안전 주석을 확인된 MCP 계약에서 생성한 레퍼런스입니다.
이 페이지의 내용
도구
preview_video
최대 12개 시각의 라벨 있는 콘택트 시트와 실제 원본 시각을 반환합니다. AI·크레딧을 쓰지 않지만 저장·미디어 한도가 적용됩니다. 인라인 이미지 대신 서명 이미지 URL을 반환하므로 인증 정보를 붙이지 않고 받으세요. 최종 알파 품질 검사는 아닙니다.
권한 및 안전
OAuth 권한: assets:read
| 안전 신호 | 값 |
|---|---|
destructiveHint |
false |
idempotentHint |
true |
openWorldHint |
false |
readOnlyHint |
false |
| spendsCredits | false |
| requiresUserConfirmation | false |
| sideEffects | preview_asset_cached, signed_url_issued |
주석은 안전 특성을 설명하며 사용자 동의, OAuth 승인, 서버 검사를 대체하지 않습니다.
입력 인수
| 필드 | 유형 | 필수 | 기본값 | 제약 | 설명 |
|---|---|---|---|---|---|
asset_id |
string |
예 | — | format: uuid |
— |
request |
VideoPreviewRequest | 예 | — | — | — |
인수 예제
{
"asset_id": "00000000-0000-4000-8000-000000000003",
"request": {
"max_frame_size": 256,
"timestamps_seconds": [
0,
1,
2
]
}
}
구조화된 결과
| 필드 | 유형 | 필수 | 기본값 | 제약 | 설명 |
|---|---|---|---|---|---|
cells |
array<PreviewCell> | 예 | — | — | Thumbnails in request order, preserving duplicates. |
height |
integer |
예 | — | — | Contact sheet height in pixels, including labels and padding. |
image |
AssetResponse | 예 | — | — | Cached PNG contact sheet with a refreshable signed download URL. |
object |
string |
아니요 | "video_preview" |
const: "video_preview" |
— |
source_video_asset_id |
string |
예 | — | format: uuid |
Stable source video asset ID. |
width |
integer |
예 | — | — | Contact sheet width in pixels, including labels and padding. |
오류 및 다음 단계
도구 오류의 error 객체에는 code, message, retryable, request_id, details가 있습니다. 메시지 문구로 분기하거나 비공개 입력을 노출하지 마세요. 종료 실패 후에도 부분 출력을 확인하세요. 서명 URL은 저장된 파일이 아닙니다.
이 문서가 도움이 되었나요?
검색어, 코드 또는 자유 입력 텍스트는 수집하지 않습니다. 이 설정은 문서 상호작용 이벤트만 제어합니다. 개인정보 처리방침