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

문서 검색

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

검색 색인을 불러오는 중…

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

공유 스키마 정의

원본 계약에서 생성한 필드 정의, 중첩 유형, 기본값, 필수 지정 및 제약입니다.

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

대시(—)는 null이 아니라 선언된 기본값이 없다는 뜻입니다. JSON Schema에서 선택 필드여도 워크플로에서는 조건부 필수일 수 있습니다. 모델별 옵션은 현재 기능을 조회해야 합니다.

AnimationCreateRequest

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
export ExportOptions 아니요 {"fps":null,"frame_count":24,"output_formats":["spritesheet"],"output_height":512,"output_width":512,"transparent":{"enabled":false},"unity":{"pivot":"bottom_center","pixels_per_unit":100}} — Export after video generation. Alpha-bearing formats require an alpha_key source; compatible formats automatically enable its transparent export.
input GenerationInput 예 — — Images owned by the caller or supplied for this generation.
metadata object 아니요 {} — Caller metadata: simple string/number/boolean/null values, at most 4 KiB JSON. Do not store secrets.
negative_prompt string 아니요 "" maxLength: 4000 Optional exclusions, only when the model supports negative prompts.
prompt string 아니요 "" maxLength: 8000 Motion instruction; nonempty when the model requires a prompt. Keep private prompts out of logs.
selection Selection 아니요 {"duration_seconds":null,"mode":"full","start_seconds":0} — Interval selected after generation; full by default.
video VideoOptions 아니요 {"duration_seconds":null,"input_canvas":null,"model":null,"ratio":null,"resolution":null,"seed":null,"style_preset":null,"transparency":{"key_color":null,"key_selection":"auto","mode":"standard"},"watermark":null} — Model-compatible generation settings.

AnimationExportCreateRequest

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
export ExportOptions 아니요 {"fps":null,"frame_count":24,"output_formats":["spritesheet"],"output_height":512,"output_width":512,"transparent":{"enabled":false},"unity":{"pivot":"bottom_center","pixels_per_unit":100}} — Output formats and processing settings.
metadata object 아니요 {} — Simple scalar/null metadata; at most 4 KiB JSON, no credentials.
selection Selection 아니요 {"duration_seconds":null,"mode":"full","start_seconds":0} — Source interval to export.
source_video_asset_id string 예 — format: uuid Owned source video asset ID, not a task ID. Reuse an existing video to avoid generating motion again.

AssetResponse

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
byte_size integer 예 — — Expected file size in bytes.
created_at string 예 — format: date-time Creation timestamp in UTC.
download_expires_at string 예 — format: date-time Signed URL expiry in UTC; refresh via asset lookup when expired.
download_url string 예 — — Sensitive short-lived signed URL. Download without a Bearer header, including after redirects; never log the URL.
format string 예 — — Artifact format; inspect actual outputs rather than assuming an array order.
id string 예 — format: uuid Stable public asset ID; use it to refresh download metadata.
media MediaResponse / null 아니요 null — Whitelisted measured video metadata. Unknown fields are null; non-video assets return null.
mime_type string 예 — — Asset media type.
object string 아니요 "asset" const: "asset" —

AssetVideoSource

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
asset_id string 예 — format: uuid Owned video asset ID, not a task ID or download URL.
type string 예 — const: "asset" —

Base64ImageInput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
data string 예 — minLength: 4 Pure Base64 without a data URL prefix; decoded limits: 10 MiB per image, 20 MiB total.
media_type string 예 — enum: "image/png", "image/jpeg", "image/webp" Actual image MIME type.
type string 예 — const: "base64" —

CreditUsage

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
charged integer 예 — — Net charged credits. Confirmed provider moderation rejection is refunded; cancellation alone is not a refund.
held integer 예 — — Credits currently reserved, not an additional charge to sum with charged.
quoted integer 예 — — Quoted total, not necessarily the final charge.
refunded integer 아니요 0 — Credits returned after a charge; already excluded from charged. Not a cash refund.
released integer 아니요 0 — Credits returned from an uncommitted hold.
status string / null 아니요 null — Billing state: held, charged, released, refunded, or managed for internal child tasks.

ExportOptions

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
fps number / null 아니요 null maximum: 60; exclusiveMinimum: 0 Source-speed sampling frequency, without interpolation. Independent exports only; requires spritesheet and spritesheet_json. A short final frame preserves the selection duration.
frame_count integer / null 아니요 null minimum: 1; maximum: 240 Legacy uniform frame count, mutually exclusive with fps. When both are omitted, uses 24 frames.
output_formats array<string> 아니요 ["spritesheet"] minItems: 1; 항목: enum: "clip_video", "webm_alpha", "prores_4444", "gif", "frames_zip", "spritesheet", "spritesheet_json", "unity_meta", "unity_pack", "godot_pack", "unreal_paper2d_pack", "cocos_creator_pack", "construct3_pack" Requested asset formats; defaults to spritesheet in frame_count mode, or spritesheet plus spritesheet_json in FPS mode. Duplicates are removed. Metadata needs its matching texture.
output_height integer 아니요 512 minimum: 64; maximum: 1024 Output frame height in pixels.
output_width integer 아니요 512 minimum: 64; maximum: 1024 Output frame width in pixels.
transparent ExportTransparency 아니요 {"enabled":false} — Use the enabled object form. Legacy booleans are accepted but normalized to this object.
unity UnityOptions 아니요 {"pivot":"bottom_center","pixels_per_unit":100} — Settings for Unity-specific metadata and packs.

ExportTransparency

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
enabled boolean 아니요 false — Transparent processing for compatible outputs; requires an alpha_key source and does not make MP4 transparent.

ExportWarning

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
code string 예 — — —
details object 아니요 {} — —
message string 예 — — —

FileImageInput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
file_id string 예 — format: uuid Owned public file ID from POST /files or complete_image_upload; not a Studio upload ID.
type string 예 — const: "file" —

FileVideoSource

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
file_id string 예 — format: uuid Owned, completed video file ID; upload sessions cannot be used before completion.
type string 예 — const: "file" —

GenerationInput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
first_frame FileImageInput / Base64ImageInput / UrlImageInput 예 — discriminator: type Required image: starting frame in first-frame mode, character reference in reference mode. Use type to select its representation.
last_frame FileImageInput / Base64ImageInput / UrlImageInput / null 아니요 null discriminator: type Optional end image; the selected model must support first/last-frame mode.
reference_images array<FileImageInput / Base64ImageInput / UrlImageInput> 아니요 [] maxItems: 8; 항목: discriminator: type Additional references, excluding the first frame. The live model can impose a smaller limit.
reference_video ReferenceVideoInput / null 아니요 null — Optional motion reference. Selects reference_images mode even without additional images; first_frame becomes the character reference, not a fixed starting frame. Mutually exclusive with last_frame.

GenerationTransparency

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
key_color string / null 아니요 null — Temporary key color when using manual selection; normally leave automatic selection enabled.
key_selection string 아니요 "auto" enum: "auto", "manual" How the temporary key color is selected.
mode string 아니요 "standard" enum: "standard", "alpha_key" standard keeps the scene; alpha_key requires meaningful alpha in all active input images. Raw videos remain opaque.

InputCanvasOptions

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
aspect_ratio string 아니요 "follow_output" enum: "follow_output", "source" Follow the output ratio or preserve the source ratio.
background string 아니요 "auto" enum: "auto", "transparent", "solid" Canvas extension background strategy.
background_color string / null 아니요 null pattern: ^#[0-9A-Fa-f]{6}$ Six-digit RGB color for a solid extension.
enabled boolean 아니요 true — Whether to prepare an expanded input canvas.
position_x number 아니요 0.5 minimum: 0; maximum: 1 Normalized horizontal source position.
position_y number 아니요 0.5 minimum: 0; maximum: 1 Normalized vertical source position.
source_scale number 아니요 0.8 minimum: 0.5; maximum: 1 Source subject scale within the canvas.

McpQuoteOutput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
breakdown object 예 — — Public cost components.
credits integer 예 — — Quoted credits; show the amount to the user before generation.
expires_at string 예 — format: date-time Quote expiry; re-quote and confirm if it expires or price changes.
quote_id string 예 — format: uuid Short-lived quote owned by this user and OAuth client; can bind to one logical generation key.
resolved_export ResolvedExport / null 아니요 null — Resolved sampling summary for an independent FPS export.

McpUploadCompleteOutput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
byte_size integer 예 — — Validated image byte count.
file_id string 예 — format: uuid Reusable owned public file ID for request.input.first_frame.
mime_type string 예 — — Validated image MIME type.
sha256 string 예 — — SHA-256 of the uploaded image bytes.

McpUploadPrepareOutput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
expires_at string 예 — format: date-time Upload URL expiry.
headers object 예 — — Exact transfer headers; do not add MCP tokens or API Bearer credentials.
max_bytes integer 예 — — Maximum accepted upload byte count.
method string 아니요 "PUT" const: "PUT" HTTP method the client must use for the byte transfer.
upload_id string 예 — format: uuid Upload session ID for complete_image_upload, not the final file_id.
upload_url string 예 — — Sensitive short-lived upload URL. Transfer actual bytes; do not publish this URL.

MediaResponse

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
duration_seconds number / null 아니요 null — Playable video duration measured from presentation timestamps; never provider-requested duration.
fps number / null 아니요 null — Measured average source frame rate; use presentation timestamps for VFR selection.
frame_count integer / null 아니요 null — Decoded source frame count, or null when unknown.
height integer / null 아니요 null — Displayed video height in pixels, accounting for rotation.
width integer / null 아니요 null — Displayed video width in pixels, accounting for rotation.

ModelCapabilities

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
aspect_ratio_mode string 예 — — Provider's aspect-ratio handling mode.
default_duration_seconds integer 예 — — Default generation duration in seconds.
default_ratio string / null 예 — — Default ratio, or null when not applicable.
default_resolution string / null 예 — — Default resolution, or null when not applicable.
durations array<integer> 예 — — Supported generation durations in seconds; also inspect resolution-specific constraints.
durations_by_resolution object 아니요 {} — Resolution-specific supported durations in seconds.
id string 예 — — Stable provider:model selector for requests; use the live catalog.
label string 예 — — Human-readable model label.
max_reference_images integer 예 — — Model reference-image capacity; the first frame occupies the first reference slot in reference mode.
model string 예 — — Model identifier within the provider.
modes array<string> 예 — — Supported input modes, such as first_frame, first_last_frame, or reference_images.
provider string 예 — — Public provider identifier.
ratios array<string> 예 — — Supported aspect ratio values; check ratios_by_mode where present.
ratios_by_mode object 아니요 {} — Input-mode-specific supported ratios.
reference_image_duration_seconds integer / null 예 — — Required duration for reference mode, when constrained.
reference_video ReferenceVideoCapability / null 아니요 null — Reference-video limits, or null when unsupported. Source limits differ from the selected clip limits.
requires_prompt boolean 예 — — Whether prompt must be nonempty.
resolutions array<string> 예 — — Supported resolution values.
returns_last_frame boolean 예 — — Whether the model can return a last-frame asset.
supports_first_frame boolean 예 — — Whether a first-frame input is supported.
supports_last_frame boolean 예 — — Whether a last-frame input is supported.
supports_negative_prompt boolean 예 — — Whether negative_prompt is supported.
supports_reference_images boolean 예 — — Whether reference-image mode is supported.
supports_reference_video boolean 아니요 false — Whether one reference video can accompany the character image in reference_images mode.
supports_seed boolean 예 — — Whether seed is supported.
supports_watermark boolean 예 — — Whether the watermark setting is supported.

ModelsResponse

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
data array<ModelCapabilities> 예 — — Currently enabled models; do not hard-code this list in a client.
object string 아니요 "list" const: "list" —

PreviewCell

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
index integer 예 — minimum: 0 Zero-based position in the original timestamp request.
rect PreviewRect 예 — — Image area within the contact sheet; excludes the timestamp label.
requested_time_seconds number 예 — — Requested time relative to the playable source origin.
source_time_seconds number 예 — — Presentation time of the source frame displayed at the requested time.

PreviewRect

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
height integer 예 — exclusiveMinimum: 0 Thumbnail height, excluding padding and label.
width integer 예 — exclusiveMinimum: 0 Thumbnail width, excluding padding and label.
x integer 예 — minimum: 0 Left pixel from the sheet origin.
y integer 예 — minimum: 0 Top pixel from the sheet origin.

ReferenceVideoCapability

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
default_processing string 아니요 "original" const: "original" Default reference processing.
max_count integer 아니요 1 const: 1 Maximum number of reference videos per generation.
max_seconds number 예 — — Maximum selected reference duration for this model.
min_seconds number 예 — — Minimum selected reference duration.
processing array<string> 아니요 ["depth","original"] 항목: enum: "depth", "original" Supported reference processing choices.
selection_fps integer 아니요 24 const: 24 Reference selection grid; not the original video FPS.
source_max_aspect_ratio number 아니요 2.5 — Maximum displayed width/height ratio.
source_max_bytes integer 아니요 104857600 — Maximum full source bytes.
source_max_pixels integer 아니요 16777216 — Maximum source width times height.
source_max_seconds integer 아니요 30 — Maximum full source duration, independent of the selected clip.
source_min_aspect_ratio number 아니요 0.4 — Minimum displayed width/height ratio.

ReferenceVideoInput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
duration_seconds number 예 — minimum: 2; maximum: 5 Selected duration, 2–5 seconds; the live model may allow less. Rounded half up to 1/24 second; quotes and generation use the same normalized range.
processing string 아니요 "original" enum: "depth", "original" original is the default and uses the original clip; opt in to depth for motion/depth conversion, which adds processing time. Processing starts only after generation is submitted.
source FileVideoSource / AssetVideoSource 예 — discriminator: type Owned uploaded video or existing generated video; sources must share the character image workspace.
start_seconds number 아니요 0 minimum: 0; maximum: 30 Source start in seconds, rounded half up to the nearest 1/24 second. Independent of the source FPS.

ReferenceVideoSelection

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
duration_seconds number 예 — minimum: 2; maximum: 5 Selected duration, 2–5 seconds; the live model may allow less. Rounded half up to 1/24 second; quotes and generation use the same normalized range.
processing string 아니요 "original" enum: "depth", "original" original is the default and uses the original clip; opt in to depth for motion/depth conversion, which adds processing time. Processing starts only after generation is submitted.
start_seconds number 아니요 0 minimum: 0; maximum: 30 Source start in seconds, rounded half up to the nearest 1/24 second. Independent of the source FPS.

ResolvedExport

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
duration_ms integer 예 — — Sum of manifest frame durations in milliseconds.
fps number 예 — — Target sampling frequency; never recalculated as frame_count / duration.
frame_count integer 예 — — Number of samples strictly before the selected end.
selection Selection 예 — — Resolved source interval; full uses measured playable duration.
warnings array<ExportWarning> 아니요 [] — Sampling warnings, including repeated source frames without interpolation.

Selection

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
duration_seconds number / null 아니요 null exclusiveMinimum: 0 Required when mode=range; positive interval length in seconds.
mode string 아니요 "full" enum: "full", "range" full uses the complete source; range requires duration_seconds.
start_seconds number 아니요 0 minimum: 0 Range start in seconds from the source beginning.

TaskError

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
code string 예 — — Machine-readable task error code.
details object 아니요 {} — Public error details, without private storage or provider values.
message string 예 — — Human-readable summary, not a stable branching key.
param string / null 아니요 null — Related public parameter when available.
retryable boolean 아니요 false — Whether retry may help; inspect partial outputs before creating a new paid task.

TaskResponse

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
cancellation_allowed boolean 아니요 false — Whether a cancellation request can currently be accepted. Remote cancellation still needs confirmation.
cancellation_reason string / null 아니요 null — Stable reason when cancellation is unavailable: TASK_TERMINAL, CANCELLATION_PENDING, CANCELLATION_NOT_CONFIRMED, or GENERATION_ALREADY_SUBMITTED.
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. A failed animation resumes only through an explicitly offered error.details.recovery action.

UnityOptions

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
pivot string 아니요 "bottom_center" const: "bottom_center" Supported Unity sprite pivot.
pixels_per_unit integer 아니요 100 minimum: 1; maximum: 1000 Unity texture pixels per world unit.

UrlImageInput

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
type string 예 — const: "url" —
url string 예 — minLength: 9; maxLength: 2048 Public HTTPS image on port 443, without credentials or fragments. Private networks and unsafe redirects are rejected. Keep bytes stable across retries.

VideoFileResponse

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
byte_size integer 예 — — Validated source bytes.
duration_seconds number 예 — — Measured source duration; the selected range must fit it.
file_id string 예 — format: uuid Completed video file ID for input.reference_video.source, type=file.
height integer 예 — — Displayed source height in pixels.
mime_type string 예 — — Validated video media type.
object string 아니요 "file" const: "file" —
sha256 string 예 — — SHA-256 of the stored source bytes.
width integer 예 — — Displayed source width in pixels.

VideoGenerationCreateRequest

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
input GenerationInput 예 — — Images owned by the caller or supplied for this generation.
metadata object 아니요 {} — Caller metadata: simple string/number/boolean/null values, at most 4 KiB JSON. Do not store secrets.
negative_prompt string 아니요 "" maxLength: 4000 Optional exclusions, only when the model supports negative prompts.
prompt string 아니요 "" maxLength: 8000 Motion instruction; nonempty when the model requires a prompt. Keep private prompts out of logs.
video VideoOptions 아니요 {"duration_seconds":null,"input_canvas":null,"model":null,"ratio":null,"resolution":null,"seed":null,"style_preset":null,"transparency":{"key_color":null,"key_selection":"auto","mode":"standard"},"watermark":null} — Model-compatible generation settings.

VideoGenerationQuoteRequest

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
has_last_frame boolean 아니요 false — Whether the planned request includes a last frame.
reference_image_count integer 아니요 0 minimum: 0; maximum: 8 Number of additional references, excluding the first frame.
reference_video ReferenceVideoSelection / null 아니요 null — Planned reference selection, without source IDs. Uses the same normalization and pricing as generation; quoting never processes video.
video VideoOptions 아니요 {"duration_seconds":null,"input_canvas":null,"model":null,"ratio":null,"resolution":null,"seed":null,"style_preset":null,"transparency":{"key_color":null,"key_selection":"auto","mode":"standard"},"watermark":null} — Generation options to estimate; must match the later create.

VideoOptions

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
duration_seconds number / null 아니요 null exclusiveMinimum: 0 Seconds; choose a supported duration for the model and resolution. Omission uses its default.
input_canvas InputCanvasOptions / null 아니요 null — Optional input framing; omit to keep the source framing.
model string / null 아니요 null — provider:model ID from GET /models; omission uses the configured default model.
ratio string / null 아니요 null — Aspect ratio supported by the current model and input mode.
resolution string / null 아니요 null — Resolution value from the live model catalog.
seed integer / null 아니요 null minimum: 0; maximum: 2147483647 Optional seed only for models advertising seed support; not a universal determinism guarantee.
style_preset string / null 아니요 null — Optional style preset supported by the selected provider/model.
transparency GenerationTransparency 아니요 {"key_color":null,"key_selection":"auto","mode":"standard"} — Source transparency workflow; transparent exports require alpha_key.
watermark boolean / null 아니요 null — Optional watermark setting; check the model capability.

VideoPreviewRequest

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
max_frame_size integer 아니요 256 minimum: 32; maximum: 512 Maximum thumbnail side in pixels, preserving aspect ratio.
timestamps_seconds array<number> 예 — minItems: 1; maxItems: 12; 항목: minimum: 0 Source timeline timestamps in request order, each strictly before the playable end. At most 12.

VideoPreviewResponse

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
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.

VideoUploadRequest

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
byte_size integer 예 — maximum: 104857600; exclusiveMinimum: 0 Exact byte count, at most 100 MiB. The source must be 2–30 seconds.
filename string 예 — minLength: 1; maxLength: 240 Client filename, not a readable server path.
mime_type string 예 — enum: "video/mp4", "video/quicktime", "video/webm" Actual MP4, MOV or WebM media type.

VideoUploadSession

선언되지 않은 필드는 거부됩니다.

필드 유형 필수 기본값 제약 설명
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.

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

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

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