{"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":"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 `Idempotency-Key`로 다시 보내면 응답에 `Idempotent-Replayed: true`가 붙어요.","deprecated":null,"version":null,"openapi":"/openapi.json post /generations","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: \"Idempotency-Key\"\n }), \"로 다시 보내면 응답에 \", _jsx(_components.code, {\n children: \"Idempotent-Replayed: true\"\n }), \"가 붙어요.\"]\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":"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 `Idempotency-Key`로 다시 보내면 응답에 `Idempotent-Replayed: true`가 붙어요.","deprecated":null,"version":null,"openapi":"/openapi.json post /generations","href":"/api-reference/생성/생성-시작","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createGeneration","tags":["생성"],"summary":"생성 시작","description":"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 `Idempotency-Key`로 다시 보내면 응답에 `Idempotent-Replayed: true`가 붙어요.","security":["8f6595f7-e646-4c6d-8740-6648233750da","7bc7f7f9-d30f-4322-8aed-836017f5211e"],"parameters":["dc9a8eb6-390d-4a74-94f4-7e7d3dd1dd79","64875bdc-b807-400c-b027-d1597f11e3b4"],"requestBody":"c0ee0169-27b7-4039-8c65-6b8234ea4459","responses":{"202":"7412dc73-eb6c-4e59-b71a-a71e7dcf0e3f","400":"d5532c47-3f49-43fb-a120-80a085b0f92a","401":"b1fe4fd7-edff-4b3c-8f04-6604f737c332","402":"6dffdac2-fcdc-4ee8-a0e7-ff86e2585e83","403":"e9a46c5b-5b80-409c-9b37-c7097187d045","404":"f1e91212-0d7b-4f19-9017-275cf2712b5d","409":"34cd50d7-995b-471b-ab9d-32eaf5d3e4ae","413":"9b3a0ff8-c83e-4807-8305-479500815c1d","415":"1dd2f424-742e-48eb-ab71-545b1525d790","429":"3899e52d-34e9-4310-a80b-8d056bdded27","503":"dd911f1a-0621-4c75-8394-fd63ad13080a"},"method":"post","type":"path","servers":["ba79bf10-79e0-4cf9-be54-d2e3481b6bde"],"path":"/generations","baseUrlOptions":["https://api.studio.thezet.io/v1"],"title":"생성 시작","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dc9a8eb6-390d-4a74-94f4-7e7d3dd1dd79":{"name":"Idempotency-Key","in":"header","required":false,"description":"같은 키로 다시 보내면 첫 작업을 돌려주고 다시 청구하지 않아요. 공백 없는 ASCII 255자까지예요.","schema":{"type":"string","maxLength":255,"isRequired":false,"description":"같은 키로 다시 보내면 첫 작업을 돌려주고 다시 청구하지 않아요. 공백 없는 ASCII 255자까지예요.","uniqueKey":"","typeLabel":"string"}},"64875bdc-b807-400c-b027-d1597f11e3b4":{"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/CreateGeneration","type":"object","properties":{"model":{"type":"string","minLength":1,"description":"모델 ID예요. `GET /models`에서 볼 수 있어요.","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"description":"만들 내용이에요. 필요한지는 모델의 `inputs.prompt`에 나와 있어요.","type":"string","maxLength":10000,"uniqueKey":"prompt","typeLabel":"string"},"params":{"description":"모델 옵션이에요. 빼면 기본값을 쓰고, 모델에 없는 값은 400으로 거절해요.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"params.additionalProperties","typeLabel":"any"},"uniqueKey":"params","typeLabel":"object"},"inputs":{"type":"object","properties":{"images":{"description":"레퍼런스 이미지예요. 업로드 ID나 끝난 작업의 `outputs[].id`를 넣어요.","maxItems":64,"type":"array","items":{"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)$","uniqueKey":"inputs.images.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"inputs.images","typeLabel":"string\u003cuuid>[]"},"start_frame":{"description":"영상의 시작 프레임 이미지예요.","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)$","uniqueKey":"inputs.start_frame","typeLabel":"string\u003cuuid>"},"end_frame":{"description":"영상의 끝 프레임 이미지예요.","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)$","uniqueKey":"inputs.end_frame","typeLabel":"string\u003cuuid>"}},"additionalProperties":false,"uniqueKey":"inputs","typeLabel":"object"}},"required":["model"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"model":"\u003cstring>","prompt":"\u003cstring>","params":{},"inputs":{"images":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"start_frame":"3c90c3cc-0d44-4b50-8888-8dd25736052a","end_frame":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"7412dc73-eb6c-4e59-b71a-a71e7dcf0e3f":{"description":"작업을 받았어요. `terminal`이 true가 될 때까지 조회해 주세요.","content":{"application/json":{"schema":{"$id":"#/components/schemas/Generation","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","enum":["queued","running","succeeded","failed","canceled"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"terminal":{"type":"boolean","description":"true면 더 바뀌지 않아요. 이때 조회를 멈추면 돼요.","isRequired":true,"uniqueKey":"terminal","typeLabel":"boolean"},"model":{"type":"string","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"model_name":{"type":"string","isRequired":true,"uniqueKey":"model_name","typeLabel":"string"},"modality":{"type":"string","enum":["image","video","remix"],"isRequired":true,"uniqueKey":"modality","typeLabel":"enum\u003cstring>"},"prompt":{"oneOf":[{"description":"삭제한 작업은 null이에요.","type":"string","isRequired":true,"uniqueKey":"prompt.oneOf.0","typeLabel":"string"},{"description":"삭제한 작업은 null이에요.","type":"null","isRequired":true,"uniqueKey":"prompt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"prompt","typeLabel":"string | null"},"params":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"params.additionalProperties","typeLabel":"any"},"description":"실제로 적용한 옵션이에요. 기본값도 들어 있어요.","isRequired":true,"uniqueKey":"params","typeLabel":"object"},"price_usd":{"type":"string","pattern":"^\\d+\\.\\d{4}$","description":"달러 금액이에요. 오차가 없도록 소수 넷째 자리까지 쓴 문자열로 줘요.","isRequired":true,"uniqueKey":"price_usd","typeLabel":"string"},"created_at":{"type":"string","description":"ISO 8601 시각이에요.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string"},"deleted_at":{"oneOf":[{"type":"string","description":"삭제한 시각이에요. 삭제 전에는 null이에요.","isRequired":true,"uniqueKey":"deleted_at.oneOf.0","typeLabel":"string"},{"type":"null","description":"삭제한 시각이에요. 삭제 전에는 null이에요.","isRequired":true,"uniqueKey":"deleted_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"deleted_at","typeLabel":"string | null"},"error":{"oneOf":[{"type":"object","description":"`failed`일 때만 있어요. 금액은 돌려드려요.","required":["code","message"],"properties":{"code":{"type":"string","description":"`content_rejected`면 내용을 바꿔야 하고, `generation_failed`면 그대로 다시 시도해도 돼요.","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","description":"`failed`일 때만 있어요. 금액은 돌려드려요.","isRequired":true,"uniqueKey":"error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error","typeLabel":"object | null"},"outputs":{"type":"array","items":{"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)$","description":"다음 작업의 입력으로 쓸 수 있어요.","isRequired":true,"uniqueKey":"outputs.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["image","video","audio"],"isRequired":true,"uniqueKey":"outputs.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"url":{"type":"string","description":"로그인 없이 열리는 주소예요.","isRequired":true,"uniqueKey":"outputs.items.[INDEX].url","typeLabel":"string"},"mime_type":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"outputs.items.[INDEX].mime_type.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"outputs.items.[INDEX].mime_type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"outputs.items.[INDEX].mime_type","typeLabel":"string | null"},"width":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"outputs.items.[INDEX].width.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"outputs.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"outputs.items.[INDEX].width","typeLabel":"number | null"},"height":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"outputs.items.[INDEX].height.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"outputs.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"outputs.items.[INDEX].height","typeLabel":"number | null"}},"required":["id","kind","url","mime_type","width","height"],"additionalProperties":false,"uniqueKey":"outputs.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"outputs","typeLabel":"object[]"}},"required":["id","status","terminal","model","model_name","modality","prompt","params","price_usd","created_at","deleted_at","error","outputs"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"queued","terminal":true,"model":"\u003cstring>","model_name":"\u003cstring>","modality":"image","prompt":"\u003cstring>","params":{},"price_usd":"\u003cstring>","created_at":"\u003cstring>","deleted_at":"\u003cstring>","error":{"code":"\u003cstring>","message":"\u003cstring>"},"outputs":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","kind":"image","url":"\u003cstring>","mime_type":"\u003cstring>","width":123,"height":123}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d5532c47-3f49-43fb-a120-80a085b0f92a":{"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"},"b1fe4fd7-edff-4b3c-8f04-6604f737c332":{"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"},"6dffdac2-fcdc-4ee8-a0e7-ff86e2585e83":{"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"},"e9a46c5b-5b80-409c-9b37-c7097187d045":{"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"},"f1e91212-0d7b-4f19-9017-275cf2712b5d":{"description":"찾을 수 없어요. 다른 고객사의 항목도 404예요.","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"},"34cd50d7-995b-471b-ab9d-32eaf5d3e4ae":{"description":"지금 상태에서는 처리할 수 없어요. `error.code`를 확인해 주세요.","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"},"9b3a0ff8-c83e-4807-8305-479500815c1d":{"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"},"1dd2f424-742e-48eb-ab71-545b1525d790":{"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"},"3899e52d-34e9-4310-a80b-8d056bdded27":{"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"},"dd911f1a-0621-4c75-8394-fd63ad13080a":{"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"}},"security":{"8f6595f7-e646-4c6d-8740-6648233750da":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"zet_live_...","description":"`Authorization: Bearer \u003cAPI 키>`","scopes":[],"schemeName":"bearerAuth"}},"7bc7f7f9-d30f-4322-8aed-836017f5211e":{"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.335Z","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=\"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 Idempotency-Key로 다시 보내면 응답에 Idempotent-Replayed: true가 붙어요.\">\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=\"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 Idempotency-Key로 다시 보내면 응답에 Idempotent-Replayed: true가 붙어요.\">\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%83%9D%EC%84%B1\u0026amp;title=%EC%83%9D%EC%84%B1+%EC%8B%9C%EC%9E%91\u0026amp;description=%EC%9E%91%EC%97%85%EC%9D%84+%EC%8B%9C%EC%9E%91%ED%95%98%EA%B3%A0+%EA%B8%88%EC%95%A1%EC%9D%84+%EC%9E%94%EC%95%A1%EC%97%90%EC%84%9C+%EB%AC%B6%EC%96%B4%EC%9A%94.+%EC%84%B1%EA%B3%B5%ED%95%98%EB%A9%B4+%EC%B2%AD%EA%B5%AC%EB%90%98%EA%B3%A0%2C+%EC%8B%A4%ED%8C%A8%ED%95%98%EA%B1%B0%EB%82%98+%EC%B7%A8%EC%86%8C%ED%95%98%EB%A9%B4+%EB%8F%8C%EB%A0%A4%EB%93%9C%EB%A0%A4%EC%9A%94.+%EA%B0%99%EC%9D%80+%60Idempotency-Key%60%EB%A1%9C+%EB%8B%A4%EC%8B%9C+%EB%B3%B4%EB%82%B4%EB%A9%B4+%EC%9D%91%EB%8B%B5%EC%97%90+%60Idempotent-Replayed%3A+true%60%EA%B0%80+%EB%B6%99%EC%96%B4%EC%9A%94.\u0026amp;theme=8c72780cd11fb41efa365b04\u0026amp;signature=70f8ed7f21069d8e1da837e66509c27a9fc48643ef49d135196a4c5a39e2678d\">\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=\"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 Idempotency-Key로 다시 보내면 응답에 Idempotent-Replayed: true가 붙어요.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zet-2b77ef1e.mintlify.app/_mintlify/api/og/v2?division=%EC%83%9D%EC%84%B1\u0026amp;title=%EC%83%9D%EC%84%B1+%EC%8B%9C%EC%9E%91\u0026amp;description=%EC%9E%91%EC%97%85%EC%9D%84+%EC%8B%9C%EC%9E%91%ED%95%98%EA%B3%A0+%EA%B8%88%EC%95%A1%EC%9D%84+%EC%9E%94%EC%95%A1%EC%97%90%EC%84%9C+%EB%AC%B6%EC%96%B4%EC%9A%94.+%EC%84%B1%EA%B3%B5%ED%95%98%EB%A9%B4+%EC%B2%AD%EA%B5%AC%EB%90%98%EA%B3%A0%2C+%EC%8B%A4%ED%8C%A8%ED%95%98%EA%B1%B0%EB%82%98+%EC%B7%A8%EC%86%8C%ED%95%98%EB%A9%B4+%EB%8F%8C%EB%A0%A4%EB%93%9C%EB%A0%A4%EC%9A%94.+%EA%B0%99%EC%9D%80+%60Idempotency-Key%60%EB%A1%9C+%EB%8B%A4%EC%8B%9C+%EB%B3%B4%EB%82%B4%EB%A9%B4+%EC%9D%91%EB%8B%B5%EC%97%90+%60Idempotent-Replayed%3A+true%60%EA%B0%80+%EB%B6%99%EC%96%B4%EC%9A%94.\u0026amp;theme=8c72780cd11fb41efa365b04\u0026amp;signature=70f8ed7f21069d8e1da837e66509c27a9fc48643ef49d135196a4c5a39e2678d\">\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%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%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%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91#webpage\",\"url\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91\",\"name\":\"생성 시작\",\"description\":\"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 Idempotency-Key로 다시 보내면 응답에 Idempotent-Replayed: true가 붙어요.\",\"dateModified\":\"2026-11-05T08:29:53.335Z\",\"isPartOf\":{\"@id\":\"https://studio-docs.thezet.io#website\"},\"breadcrumb\":{\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"생성\",\"item\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%9E%91%EC%97%85-%EB%AA%A9%EB%A1%9D\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"생성 시작\",\"item\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91#apireference\",\"headline\":\"생성 시작\",\"name\":\"생성 시작\",\"description\":\"작업을 시작하고 금액을 잔액에서 묶어요. 성공하면 청구되고, 실패하거나 취소하면 돌려드려요. 같은 Idempotency-Key로 다시 보내면 응답에 Idempotent-Replayed: true가 붙어요.\",\"url\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91\",\"mainEntityOfPage\":{\"@id\":\"https://studio-docs.thezet.io/api-reference/%EC%83%9D%EC%84%B1/%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%9E%91#webpage\"},\"dateModified\":\"2026-11-05T08:29:53.335Z\",\"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":"작업 목록","description":"API로 만든 작업을 최신순으로 줘요. 사이트에서 만든 작업은 나오지 않아요.","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":"작업 조회","description":null,"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":"작업 취소","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":"업로드 확인","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"]}