{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zet Studio API","colors":{"primary":"#16a34a","light":"#4ade80","dark":"#15803d"},"appearance":{"default":"dark"},"background":{"color":{"light":"#ffffff","dark":"#111113"}},"navbar":{"links":[{"href":"https://studio.thezet.io/settings/api-keys","label":"API 키 만들기"}],"primary":{"type":"button","label":"Zet Studio","href":"https://studio.thezet.io"}},"footer":{"links":[{"header":"약관","items":[{"label":"API 이용약관","href":"https://studio.thezet.io/api-terms"},{"label":"개인정보처리방침","href":"https://studio.thezet.io/privacy"}]}]},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":""}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zet-2b77ef1e","hasAudioNarration":false,"actualSubdomain":"zet-2b77ef1e","customDomains":["studio-docs.thezet.io"],"gitSource":{"type":"github","owner":"team-thezet","repo":"zet-studio","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":"","_id":"6aebef54cfe40a2486c8d45b"},"chroma":{"latestBuiltDeploymentHistoryId":"6aebef55cfe40a2486c8d470","collectionId":"6cc7726d-2248-4728-b782-308bc67b1417","liveDeploymentHistoryId":"6aebef55cfe40a2486c8d470","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aec3e7dfcdd00e0440f5055","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/입력-파일/업로드-시작","slug":"/api-reference/입력-파일/업로드-시작","pageMetadata":{"title":"업로드 시작","description":"파일을 보낼 주소를 줘요. `upload_url`로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads","href":"/api-reference/입력-파일/업로드-시작","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"파일을 보낼 주소를 줘요. \", _jsx(_components.code, {\n children: \"upload_url\"\n }), \"로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"업로드 시작","description":"파일을 보낼 주소를 줘요. `upload_url`로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads","href":"/api-reference/입력-파일/업로드-시작","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createUpload","tags":["입력 파일"],"summary":"업로드 시작","description":"파일을 보낼 주소를 줘요. `upload_url`로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.","security":["33c016d9-187b-44f0-a526-c3d07db2867f","b472ee46-7107-45d6-ad37-473a96be7606"],"parameters":["4e5895ff-f1e3-4743-9f16-05e17b48e190"],"requestBody":"045f8875-fb2a-4d99-841f-9a987b45cfb1","responses":{"201":"e07f9c6d-606f-41a7-81b5-949cc67f3a3e","400":"e5bc8e82-9a26-4927-bf01-942a41662a0c","401":"628f53f3-e567-42fb-8263-97c1aaac8c5f","403":"231cbe1b-5905-4098-a026-818971809e88","413":"e5a11318-0a5e-41dd-a235-c9040445dde0","415":"32686192-b3e2-4fd9-b4e3-3b3e1856fae1","429":"78024314-9227-4ce8-8357-fafb441e481c"},"method":"post","type":"path","servers":["ba79bf10-79e0-4cf9-be54-d2e3481b6bde"],"path":"/uploads","baseUrlOptions":["https://api.studio.thezet.io/v1"],"title":"업로드 시작","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4e5895ff-f1e3-4743-9f16-05e17b48e190":{"name":"Accept-Language","in":"header","required":false,"description":"`ko`면 메시지를 한국어로 줘요. 기본은 영어예요.","schema":{"type":"string","isRequired":false,"description":"`ko`면 메시지를 한국어로 줘요. 기본은 영어예요.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$id":"#/components/schemas/CreateUpload","type":"object","properties":{"content_type":{"type":"string","minLength":1,"description":"`image/png`, `image/jpeg`, `image/webp` 중 하나예요.","isRequired":true,"uniqueKey":"content_type","typeLabel":"string"},"size":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"파일 크기(바이트)예요. 20MB까지 올릴 수 있어요.","isRequired":true,"uniqueKey":"size","typeLabel":"integer"}},"required":["content_type","size"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"content_type":"\u003cstring>","size":123}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e07f9c6d-606f-41a7-81b5-949cc67f3a3e":{"description":"업로드 자리를 만들었어요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/UploadCreated","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","const":"pending","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"upload_url":{"type":"string","description":"파일을 보낼 주소예요.","isRequired":true,"uniqueKey":"upload_url","typeLabel":"string"},"method":{"type":"string","const":"PUT","isRequired":true,"uniqueKey":"method","typeLabel":"string"},"headers":{"type":"object","properties":{"content-type":{"type":"string","isRequired":true,"uniqueKey":"headers.content-type","typeLabel":"string"},"content-length":{"type":"string","isRequired":true,"uniqueKey":"headers.content-length","typeLabel":"string"}},"required":["content-type","content-length"],"additionalProperties":false,"description":"PUT 요청에 그대로 넣어야 하는 헤더예요.","isRequired":true,"uniqueKey":"headers","typeLabel":"object"},"expires_in_seconds":{"type":"number","description":"`upload_url`을 쓸 수 있는 시간이에요.","isRequired":true,"uniqueKey":"expires_in_seconds","typeLabel":"number"}},"required":["id","status","upload_url","method","headers","expires_in_seconds"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"pending","upload_url":"\u003cstring>","method":"PUT","headers":{"content-type":"\u003cstring>","content-length":"\u003cstring>"},"expires_in_seconds":123}}},"exampleType":"generated"}},"exampleType":"generated"},"e5bc8e82-9a26-4927-bf01-942a41662a0c":{"description":"요청 내용이 잘못됐어요. `details`에 항목별 문제가 있어요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"프로그램에서 구분할 때 쓰는 값이에요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽는 설명이에요. 기본은 영어이고 `Accept-Language: ko`면 한국어예요.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"oneOf":[{"description":"문의할 때 알려 주세요.","type":"string","isRequired":true,"uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"description":"문의할 때 알려 주세요.","type":"null","isRequired":true,"uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string | null"},"details":{"description":"항목별 문제처럼 더 자세한 내용이에요. 없으면 null이에요.","isRequired":true,"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","description":"같은 요청을 다시 보내도 되는지 알려줘요.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"oneOf":[{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"number","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"number"},{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"null","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.retry_after_seconds","typeLabel":"number | null"}},"required":["code","message","request_id","details","retryable","retry_after_seconds"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"628f53f3-e567-42fb-8263-97c1aaac8c5f":{"description":"API 키가 없거나 잘못됐어요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"프로그램에서 구분할 때 쓰는 값이에요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽는 설명이에요. 기본은 영어이고 `Accept-Language: ko`면 한국어예요.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"oneOf":[{"description":"문의할 때 알려 주세요.","type":"string","isRequired":true,"uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"description":"문의할 때 알려 주세요.","type":"null","isRequired":true,"uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string | null"},"details":{"description":"항목별 문제처럼 더 자세한 내용이에요. 없으면 null이에요.","isRequired":true,"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","description":"같은 요청을 다시 보내도 되는지 알려줘요.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"oneOf":[{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"number","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"number"},{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"null","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.retry_after_seconds","typeLabel":"number | null"}},"required":["code","message","request_id","details","retryable","retry_after_seconds"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"231cbe1b-5905-4098-a026-818971809e88":{"description":"이 계정은 아직 API 사용이 승인되지 않았어요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"프로그램에서 구분할 때 쓰는 값이에요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽는 설명이에요. 기본은 영어이고 `Accept-Language: ko`면 한국어예요.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"oneOf":[{"description":"문의할 때 알려 주세요.","type":"string","isRequired":true,"uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"description":"문의할 때 알려 주세요.","type":"null","isRequired":true,"uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string | null"},"details":{"description":"항목별 문제처럼 더 자세한 내용이에요. 없으면 null이에요.","isRequired":true,"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","description":"같은 요청을 다시 보내도 되는지 알려줘요.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"oneOf":[{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"number","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"number"},{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"null","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.retry_after_seconds","typeLabel":"number | null"}},"required":["code","message","request_id","details","retryable","retry_after_seconds"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"e5a11318-0a5e-41dd-a235-c9040445dde0":{"description":"요청이나 파일이 너무 커요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"프로그램에서 구분할 때 쓰는 값이에요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽는 설명이에요. 기본은 영어이고 `Accept-Language: ko`면 한국어예요.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"oneOf":[{"description":"문의할 때 알려 주세요.","type":"string","isRequired":true,"uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"description":"문의할 때 알려 주세요.","type":"null","isRequired":true,"uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string | null"},"details":{"description":"항목별 문제처럼 더 자세한 내용이에요. 없으면 null이에요.","isRequired":true,"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","description":"같은 요청을 다시 보내도 되는지 알려줘요.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"oneOf":[{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"number","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"number"},{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"null","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.retry_after_seconds","typeLabel":"number | null"}},"required":["code","message","request_id","details","retryable","retry_after_seconds"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"32686192-b3e2-4fd9-b4e3-3b3e1856fae1":{"description":"지원하지 않는 형식이에요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"프로그램에서 구분할 때 쓰는 값이에요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽는 설명이에요. 기본은 영어이고 `Accept-Language: ko`면 한국어예요.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"oneOf":[{"description":"문의할 때 알려 주세요.","type":"string","isRequired":true,"uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"description":"문의할 때 알려 주세요.","type":"null","isRequired":true,"uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string | null"},"details":{"description":"항목별 문제처럼 더 자세한 내용이에요. 없으면 null이에요.","isRequired":true,"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","description":"같은 요청을 다시 보내도 되는지 알려줘요.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"oneOf":[{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"number","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"number"},{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"null","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.retry_after_seconds","typeLabel":"number | null"}},"required":["code","message","request_id","details","retryable","retry_after_seconds"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"},"78024314-9227-4ce8-8357-fafb441e481c":{"description":"호출 한도나 동시 실행 한도를 넘었어요. `retry_after_seconds`만큼 기다린 뒤 다시 보내요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Error","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"프로그램에서 구분할 때 쓰는 값이에요.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","description":"사람이 읽는 설명이에요. 기본은 영어이고 `Accept-Language: ko`면 한국어예요.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"oneOf":[{"description":"문의할 때 알려 주세요.","type":"string","isRequired":true,"uniqueKey":"error.request_id.oneOf.0","typeLabel":"string"},{"description":"문의할 때 알려 주세요.","type":"null","isRequired":true,"uniqueKey":"error.request_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string | null"},"details":{"description":"항목별 문제처럼 더 자세한 내용이에요. 없으면 null이에요.","isRequired":true,"uniqueKey":"error.details","typeLabel":"any"},"retryable":{"type":"boolean","description":"같은 요청을 다시 보내도 되는지 알려줘요.","isRequired":true,"uniqueKey":"error.retryable","typeLabel":"boolean"},"retry_after_seconds":{"oneOf":[{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"number","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.0","typeLabel":"number"},{"description":"이만큼 기다린 뒤 다시 보내요. 없으면 null이에요.","type":"null","isRequired":true,"uniqueKey":"error.retry_after_seconds.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.retry_after_seconds","typeLabel":"number | null"}},"required":["code","message","request_id","details","retryable","retry_after_seconds"],"additionalProperties":false,"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>","request_id":"\u003cstring>","details":"\u003cunknown>","retryable":true,"retry_after_seconds":123}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"33c016d9-187b-44f0-a526-c3d07db2867f":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"zet_live_...","description":"`Authorization: Bearer \u003cAPI 키>`","scopes":[],"schemeName":"bearerAuth"}},"b472ee46-7107-45d6-ad37-473a96be7606":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"`x-api-key: \u003cAPI 키>`. 둘 중 하나만 보내요.","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"ba79bf10-79e0-4cf9-be54-d2e3481b6bde":{"url":"https://api.studio.thezet.io/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"zet_live_...","description":"`Authorization: Bearer \u003cAPI 키>`","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"`Authorization: Bearer \u003cAPI 키>`","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"`x-api-key: \u003cAPI 키>`. 둘 중 하나만 보내요.","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"`x-api-key: \u003cAPI 키>`. 둘 중 하나만 보내요.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"zet-2b77ef1e","siteName":"Zet Studio API","title":"업로드 시작 - Zet Studio API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/api-reference/입력-파일/업로드-시작","matchLevel":0}}},"lastModified":"2026-11-05T08:29:53.390Z","originalFileLocation":"api-reference/입력-파일/업로드-시작.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"파일을 보낼 주소를 줘요. upload_url로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zet Studio API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/zet-2b77ef1e/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/zet-2b77ef1e/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/zet-2b77ef1e/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/zet-2b77ef1e/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"업로드 시작 - Zet Studio API\">\u003cmeta data-mint-head property=\"og:description\" content=\"파일을 보낼 주소를 줘요. upload_url로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zet Studio API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://studio-docs.thezet.io/api-reference/입력-파일/업로드-시작\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zet-2b77ef1e.mintlify.app/_mintlify/api/og/v2?division=%EC%9E%85%EB%A0%A5+%ED%8C%8C%EC%9D%BC\u0026amp;title=%EC%97%85%EB%A1%9C%EB%93%9C+%EC%8B%9C%EC%9E%91\u0026amp;description=%ED%8C%8C%EC%9D%BC%EC%9D%84+%EB%B3%B4%EB%82%BC+%EC%A3%BC%EC%86%8C%EB%A5%BC+%EC%A4%98%EC%9A%94.+%60upload_url%60%EB%A1%9C+%ED%8C%8C%EC%9D%BC%EC%9D%84+PUT%ED%95%9C+%EB%92%A4+%EC%97%85%EB%A1%9C%EB%93%9C+%ED%99%95%EC%9D%B8%EC%9D%84+%ED%98%B8%EC%B6%9C%ED%95%B4+%EC%A3%BC%EC%84%B8%EC%9A%94.\u0026amp;theme=8c72780cd11fb41efa365b04\u0026amp;signature=9782881f1f5ca6c623389af07bcc772e98f04c78f4d8e3ea1179e23707cdaa24\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"업로드 시작 - Zet Studio API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"파일을 보낼 주소를 줘요. upload_url로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zet-2b77ef1e.mintlify.app/_mintlify/api/og/v2?division=%EC%9E%85%EB%A0%A5+%ED%8C%8C%EC%9D%BC\u0026amp;title=%EC%97%85%EB%A1%9C%EB%93%9C+%EC%8B%9C%EC%9E%91\u0026amp;description=%ED%8C%8C%EC%9D%BC%EC%9D%84+%EB%B3%B4%EB%82%BC+%EC%A3%BC%EC%86%8C%EB%A5%BC+%EC%A4%98%EC%9A%94.+%60upload_url%60%EB%A1%9C+%ED%8C%8C%EC%9D%BC%EC%9D%84+PUT%ED%95%9C+%EB%92%A4+%EC%97%85%EB%A1%9C%EB%93%9C+%ED%99%95%EC%9D%B8%EC%9D%84+%ED%98%B8%EC%B6%9C%ED%95%B4+%EC%A3%BC%EC%84%B8%EC%9A%94.\u0026amp;theme=8c72780cd11fb41efa365b04\u0026amp;signature=9782881f1f5ca6c623389af07bcc772e98f04c78f4d8e3ea1179e23707cdaa24\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/zet-2b77ef1e/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zet Studio API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16a34a\">\u003clink data-mint-head rel=\"canonical\" href=\"https://studio-docs.thezet.io/api-reference/입력-파일/업로드-시작\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://studio-docs.thezet.io/#organization\",\"name\":\"Zet Studio API\",\"url\":\"https://studio-docs.thezet.io\"},{\"@type\":\"WebSite\",\"@id\":\"https://studio-docs.thezet.io#website\",\"name\":\"Zet Studio API\",\"url\":\"https://studio-docs.thezet.io\",\"publisher\":{\"@id\":\"https://studio-docs.thezet.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91#webpage\",\"url\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91\",\"name\":\"업로드 시작\",\"description\":\"파일을 보낼 주소를 줘요. upload_url로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.\",\"dateModified\":\"2026-11-05T08:29:53.390Z\",\"isPartOf\":{\"@id\":\"https://studio-docs.thezet.io#website\"},\"breadcrumb\":{\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Zet Studio API\",\"item\":\"https://studio-docs.thezet.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"업로드 시작\",\"item\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91#apireference\",\"headline\":\"업로드 시작\",\"name\":\"업로드 시작\",\"description\":\"파일을 보낼 주소를 줘요. upload_url로 파일을 PUT한 뒤 업로드 확인을 호출해 주세요.\",\"url\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91\",\"mainEntityOfPage\":{\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%9E%85%EB%A0%A5-%ED%8C%8C%EC%9D%BC/%EC%97%85%EB%A1%9C%EB%93%9C-%EC%8B%9C%EC%9E%91#webpage\"},\"dateModified\":\"2026-11-05T08:29:53.390Z\",\"publisher\":{\"@id\":\"https://studio-docs.thezet.io/#organization\"},\"isPartOf\":{\"@id\":\"https://studio-docs.thezet.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zet Studio API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Zet Studio API","nav":{"global":null,"languages":[{"language":"ko","default":true,"tabs":[{"tab":"가이드","pages":[{"title":"가이드","href":""}]},{"tab":"모델","pages":[{"title":"모델","href":"/models/nano-banana-pro"}]},{"tab":"API 레퍼런스","groups":[{"group":"계정","pages":[{"title":"상태 확인","deprecated":null,"version":null,"openapi":"/openapi.json get /health","href":"/api-reference/계정/상태-확인"},{"title":"키 확인","deprecated":null,"version":null,"openapi":"/openapi.json get /me","href":"/api-reference/계정/키-확인"},{"title":"잔액 조회","deprecated":null,"version":null,"openapi":"/openapi.json get /balance","href":"/api-reference/계정/잔액-조회"},{"title":"사용량 조회","deprecated":null,"version":null,"openapi":"/openapi.json get /usage","href":"/api-reference/계정/사용량-조회"}]},{"group":"모델과 가격","pages":[{"title":"모델 목록","deprecated":null,"version":null,"openapi":"/openapi.json get /models","href":"/api-reference/모델과-가격/모델-목록"},{"title":"모델 조회","deprecated":null,"version":null,"openapi":"/openapi.json get /models/{id}","href":"/api-reference/모델과-가격/모델-조회"},{"title":"가격 견적","deprecated":null,"version":null,"openapi":"/openapi.json post /estimate","href":"/api-reference/모델과-가격/가격-견적"}]},{"group":"생성","pages":[{"title":"작업 목록","deprecated":null,"version":null,"openapi":"/openapi.json get /generations","href":"/api-reference/생성/작업-목록"},{"title":"생성 시작","deprecated":null,"version":null,"openapi":"/openapi.json post /generations","href":"/api-reference/생성/생성-시작"},{"title":"작업 조회","deprecated":null,"version":null,"openapi":"/openapi.json get /generations/{id}","href":"/api-reference/생성/작업-조회"},{"title":"작업 삭제","deprecated":null,"version":null,"openapi":"/openapi.json delete /generations/{id}","href":"/api-reference/생성/작업-삭제"},{"title":"작업 취소","description":"시작하기 전이면 취소하고 금액을 돌려드려요. 이미 시작했다면 409예요. 다시 호출해도 괜찮아요.","deprecated":null,"version":null,"openapi":"/openapi.json post /generations/{id}/cancel","href":"/api-reference/생성/작업-취소"}]},{"group":"입력 파일","pages":[{"title":"업로드 시작","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads","href":"/api-reference/입력-파일/업로드-시작"},{"title":"업로드 확인","description":"파일이 잘 도착했는지 확인해요. 이후 이 ID를 작업의 입력으로 쓸 수 있어요. 파일이 아직 없으면 409예요.","deprecated":null,"version":null,"openapi":"/openapi.json post /uploads/{id}/complete","href":"/api-reference/입력-파일/업로드-확인"},{"title":"입력 파일 삭제","deprecated":null,"version":null,"openapi":"/openapi.json delete /uploads/{id}","href":"/api-reference/입력-파일/입력-파일-삭제"}]},{"group":"웹훅","pages":[{"title":"작업 성공","version":null,"deprecated":null,"openapi":"/openapi.json webhook generation.succeeded","href":"/api-reference/웹훅/작업-성공"},{"title":"작업 실패","version":null,"deprecated":null,"openapi":"/openapi.json webhook generation.failed","href":"/api-reference/웹훅/작업-실패"},{"title":"작업 취소","version":null,"deprecated":null,"openapi":"/openapi.json webhook generation.canceled","href":"/api-reference/웹훅/작업-취소"}]}]}]}]},"basePath":"","title":"업로드 시작 - Zet Studio API","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}