{"componentChunkName":"component---src-templates-docs-js","path":"/ko-kr/integrations/api","result":{"data":{"site":{"siteMetadata":{"title":"Documentation | DesignerBox","docsLocation":""}},"mdx":{"fields":{"id":"cc0bed27-2bd3-5beb-9494-9359bdec273c","title":"API","slug":"/ko-kr/integrations/api","locale":"ko-KR"},"body":"var _excluded = [\"components\"];\nfunction _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }\nfunction _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }\nfunction _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {\n  \"title\": \"API\",\n  \"metaTitle\": \"DesignerBox API | 이미지 및 영상 생성\",\n  \"metaDescription\": \"DesignerBox REST API(/api/v1)로 AI 이미지와 영상을 생성하고, 에셋을 관리하고, 워크플로를 프로그래밍 방식으로 실행하세요.\",\n  \"order\": 1\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h1\", null, \"API\"), mdx(\"p\", null, \"DesignerBox\\uB294 REST API\\uB97C \\uC81C\\uACF5\\uD574 \\uBBF8\\uB514\\uC5B4\\uB97C \\uC0DD\\uC131\\uD558\\uACE0 \\uC5D0\\uC14B\\uC744 \\uD504\\uB85C\\uADF8\\uB798\\uBC0D \\uBC29\\uC2DD\\uC73C\\uB85C \\uAD00\\uB9AC\\uD560 \\uC218 \\uC788\\uC2B5\\uB2C8\\uB2E4. \\uC571\\uC5D0\\uC11C \\uC0AC\\uC6A9\\uD558\\uB294 \\uAC83\\uACFC \\uB3D9\\uC77C\\uD55C \\uAE30\\uB2A5\\uC744 \\uC9C0\\uC6D0\\uD569\\uB2C8\\uB2E4.\"), mdx(\"p\", null, mdx(\"span\", {\n    parentName: \"p\",\n    \"className\": \"gatsby-resp-image-wrapper\",\n    \"style\": {\n      \"position\": \"relative\",\n      \"display\": \"block\",\n      \"marginLeft\": \"auto\",\n      \"marginRight\": \"auto\",\n      \"maxWidth\": \"800px\"\n    }\n  }, \"\\n      \", mdx(\"a\", {\n    parentName: \"span\",\n    \"className\": \"gatsby-resp-image-link\",\n    \"href\": \"/docs/static/22f2eb7e101ec8093af2a604793b65d2/356e8/home.jpg\",\n    \"style\": {\n      \"display\": \"block\"\n    },\n    \"target\": \"_blank\",\n    \"rel\": \"noopener\"\n  }, \"\\n    \", mdx(\"span\", {\n    parentName: \"a\",\n    \"className\": \"gatsby-resp-image-background-image\",\n    \"style\": {\n      \"paddingBottom\": \"56.49999999999999%\",\n      \"position\": \"relative\",\n      \"bottom\": \"0\",\n      \"left\": \"0\",\n      \"backgroundImage\": \"url('data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAALABQDASIAAhEBAxEB/8QAFgABAQEAAAAAAAAAAAAAAAAAAAEF/8QAFAEBAAAAAAAAAAAAAAAAAAAAAP/aAAwDAQACEAMQAAAB3bKAf//EABQQAQAAAAAAAAAAAAAAAAAAACD/2gAIAQEAAQUCX//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQMBAT8BP//EABQRAQAAAAAAAAAAAAAAAAAAABD/2gAIAQIBAT8BP//EABQQAQAAAAAAAAAAAAAAAAAAACD/2gAIAQEABj8CX//EABkQAAIDAQAAAAAAAAAAAAAAAAEQABExIf/aAAgBAQABPyGhYXJuv//aAAwDAQACAAMAAAAQ0+//xAAUEQEAAAAAAAAAAAAAAAAAAAAQ/9oACAEDAQE/ED//xAAUEQEAAAAAAAAAAAAAAAAAAAAQ/9oACAECAQE/ED//xAAbEAEAAgIDAAAAAAAAAAAAAAABESEAURAxQf/aAAgBAQABPxBsKUisaSOsdowJeod8/wD/2Q==')\",\n      \"backgroundSize\": \"cover\",\n      \"display\": \"block\"\n    }\n  }), \"\\n  \", mdx(\"img\", {\n    parentName: \"a\",\n    \"className\": \"gatsby-resp-image-image\",\n    \"alt\": \"이미지, 영상, 에셋 기능이 API를 통해서도 사용 가능한 DesignerBox 앱\",\n    \"title\": \"이미지, 영상, 에셋 기능이 API를 통해서도 사용 가능한 DesignerBox 앱\",\n    \"src\": \"/docs/static/22f2eb7e101ec8093af2a604793b65d2/4b190/home.jpg\",\n    \"srcSet\": [\"/docs/static/22f2eb7e101ec8093af2a604793b65d2/e07e9/home.jpg 200w\", \"/docs/static/22f2eb7e101ec8093af2a604793b65d2/066f9/home.jpg 400w\", \"/docs/static/22f2eb7e101ec8093af2a604793b65d2/4b190/home.jpg 800w\", \"/docs/static/22f2eb7e101ec8093af2a604793b65d2/e5166/home.jpg 1200w\", \"/docs/static/22f2eb7e101ec8093af2a604793b65d2/356e8/home.jpg 1512w\"],\n    \"sizes\": \"(max-width: 800px) 100vw, 800px\",\n    \"style\": {\n      \"width\": \"100%\",\n      \"height\": \"100%\",\n      \"margin\": \"0\",\n      \"verticalAlign\": \"middle\",\n      \"position\": \"absolute\",\n      \"top\": \"0\",\n      \"left\": \"0\"\n    },\n    \"loading\": \"lazy\"\n  }), \"\\n  \"), \"\\n    \")), mdx(\"h2\", null, \"\\uAE30\\uBCF8 \\uACBD\\uB85C\"), mdx(\"p\", null, \"\\uBAA8\\uB4E0 \\uC5D4\\uB4DC\\uD3EC\\uC778\\uD2B8\\uB294 \\uBC84\\uC804\\uC774 \\uC9C0\\uC815\\uB41C \\uC811\\uB450\\uC0AC \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/api/v1/\"), \" \\uC544\\uB798\\uC5D0 \\uC788\\uC2B5\\uB2C8\\uB2E4. \\uC694\\uCCAD\\uACFC \\uC751\\uB2F5\\uC740 JSON \\uD615\\uC2DD\\uC785\\uB2C8\\uB2E4.\"), mdx(\"h2\", null, \"\\uC0AC\\uC6A9 \\uAC00\\uB2A5\\uD55C \\uAE30\\uB2A5\"), mdx(\"p\", null, \"API\\uB294 \\uC81C\\uD488\\uC758 \\uD575\\uC2EC \\uC601\\uC5ED\\uC744 \\uBC18\\uC601\\uD569\\uB2C8\\uB2E4.\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"ai\"), \" - \\uC774\\uBBF8\\uC9C0\\uC640 \\uC601\\uC0C1 \\uC0DD\\uC131.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"assets\"), \" - \\uD30C\\uC77C \\uBC0F \\uC0DD\\uC131\\uB41C \\uBBF8\\uB514\\uC5B4.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"video-tasks\"), \" - \\uC601\\uC0C1 \\uC0DD\\uC131 \\uC791\\uC5C5 \\uCD94\\uC801.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"templates\"), \"\\uC640 \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"pipelines\"), \" - \\uAE30\\uBC95\\uACFC \\uC6CC\\uD06C\\uD50C\\uB85C \\uC2E4\\uD589.\")), mdx(\"h2\", null, \"\\uD06C\\uB808\\uB527\"), mdx(\"p\", null, \"API \\uC0DD\\uC131\\uC740 \\uD50C\\uB79C\\uC758 \\uD06C\\uB808\\uB527\\uC744 \\uC18C\\uBAA8\\uD558\\uBA70, \\uC571\\uC5D0\\uC11C \\uC0AC\\uC6A9\\uD558\\uB294 \\uAC83\\uACFC \\uB3D9\\uC77C\\uD55C \\uD480\\uC785\\uB2C8\\uB2E4. \\uC0DD\\uC131\\uC774 \\uC2E4\\uD589\\uB420 \\uB54C \\uD06C\\uB808\\uB527\\uC774 \\uCC28\\uAC10\\uB418\\uBBC0\\uB85C \\uC571\\uC5D0\\uC11C \\uC794\\uC561\\uC744 \\uBAA8\\uB2C8\\uD130\\uB9C1\\uD558\\uC138\\uC694. \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/docs/ko-kr/knowledge-base/plans-credits-and-limits\"\n  }, \"\\uD50C\\uB79C, \\uD06C\\uB808\\uB527, \\uD55C\\uB3C4\"), \"\\uB97C \\uCC38\\uACE0\\uD558\\uC138\\uC694.\"), mdx(\"p\", null, \"\\uACC4\\uC815\\uC5D0 \\uC5F0\\uACB0\\uB41C \\uD504\\uB85C\\uADF8\\uB798\\uBC0D \\uBC29\\uC2DD \\uC811\\uADFC\\uC744 \\uC704\\uD574 \\uC571\\uC758 \\uACC4\\uC815 \\uC124\\uC815\\uC5D0\\uC11C \\uC811\\uADFC \\uAD8C\\uD55C\\uC744 \\uAD00\\uB9AC\\uD558\\uC138\\uC694.\"), mdx(\"h2\", null, \"\\uAD00\\uB828 \\uD56D\\uBAA9\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/ko-kr/features/workflows-and-canvas\"\n  }, \"\\uC6CC\\uD06C\\uD50C\\uB85C\\uC640 Canvas\"), \" - API\\uAC00 \\uC2E4\\uD589\\uD560 \\uC218 \\uC788\\uB294 \\uD30C\\uC774\\uD504\\uB77C\\uC778.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/ko-kr/integrations/white-label\"\n  }, \"White-Label\"), \" - \\uC790\\uC2E0\\uC758 \\uBE0C\\uB79C\\uB4DC \\uC544\\uB798 \\uC0DD\\uC131 \\uAE30\\uB2A5 \\uC81C\\uACF5.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/ko-kr/knowledge-base/plans-credits-and-limits\"\n  }, \"\\uD50C\\uB79C, \\uD06C\\uB808\\uB527, \\uD55C\\uB3C4\"), \" - API \\uC0DD\\uC131\\uC774 \\uD06C\\uB808\\uB527\\uC744 \\uC18C\\uBAA8\\uD558\\uB294 \\uBC29\\uC2DD.\")));\n}\n;\nMDXContent.isMDXComponent = true;","rawBody":"---\ntitle: \"API\"\nmetaTitle: \"DesignerBox API | 이미지 및 영상 생성\"\nmetaDescription: \"DesignerBox REST API(/api/v1)로 AI 이미지와 영상을 생성하고, 에셋을 관리하고, 워크플로를 프로그래밍 방식으로 실행하세요.\"\norder: 1\n---\n\n# API\n\nDesignerBox는 REST API를 제공해 미디어를 생성하고 에셋을 프로그래밍 방식으로 관리할 수 있습니다. 앱에서 사용하는 것과 동일한 기능을 지원합니다.\n\n![이미지, 영상, 에셋 기능이 API를 통해서도 사용 가능한 DesignerBox 앱](../images/docs/home.jpg)\n\n## 기본 경로\n\n모든 엔드포인트는 버전이 지정된 접두사 `/api/v1/` 아래에 있습니다. 요청과 응답은 JSON 형식입니다.\n\n## 사용 가능한 기능\n\nAPI는 제품의 핵심 영역을 반영합니다.\n\n- `ai` - 이미지와 영상 생성.\n- `assets` - 파일 및 생성된 미디어.\n- `video-tasks` - 영상 생성 작업 추적.\n- `templates`와 `pipelines` - 기법과 워크플로 실행.\n\n## 크레딧\n\nAPI 생성은 플랜의 크레딧을 소모하며, 앱에서 사용하는 것과 동일한 풀입니다. 생성이 실행될 때 크레딧이 차감되므로 앱에서 잔액을 모니터링하세요. [플랜, 크레딧, 한도](/ko-kr/knowledge-base/plans-credits-and-limits)를 참고하세요.\n\n계정에 연결된 프로그래밍 방식 접근을 위해 앱의 계정 설정에서 접근 권한을 관리하세요.\n\n## 관련 항목\n\n- [워크플로와 Canvas](/ko-kr/features/workflows-and-canvas) - API가 실행할 수 있는 파이프라인.\n- [White-Label](/ko-kr/integrations/white-label) - 자신의 브랜드 아래 생성 기능 제공.\n- [플랜, 크레딧, 한도](/ko-kr/knowledge-base/plans-credits-and-limits) - API 생성이 크레딧을 소모하는 방식.\n","tableOfContents":{"items":[{"url":"#api","title":"API","items":[{"url":"#기본-경로","title":"기본 경로"},{"url":"#사용-가능한-기능","title":"사용 가능한 기능"},{"url":"#크레딧","title":"크레딧"},{"url":"#관련-항목","title":"관련 항목"}]}]},"parent":{"__typename":"File","relativePath":"ko-kr/integrations/api.md"},"frontmatter":{"metaTitle":"DesignerBox API | 이미지 및 영상 생성","metaDescription":"DesignerBox REST API(/api/v1)로 AI 이미지와 영상을 생성하고, 에셋을 관리하고, 워크플로를 프로그래밍 방식으로 실행하세요.","order":1}},"allMdx":{"edges":[{"node":{"fields":{"slug":"/ko-kr/features","title":"기능"}}},{"node":{"fields":{"slug":"/ko-kr/knowledge-base","title":"지식 베이스"}}},{"node":{"fields":{"slug":"/ko-kr/guides","title":"가이드"}}},{"node":{"fields":{"slug":"/ko-kr/integrations","title":"통합"}}},{"node":{"fields":{"slug":"/ko-kr/pricing-faqs","title":"가격 FAQ"}}},{"node":{"fields":{"slug":"/ko-kr/features/brand-profile","title":"브랜드 프로필과 Library"}}},{"node":{"fields":{"slug":"/ko-kr/features/avatars-and-models","title":"AI Character"}}},{"node":{"fields":{"slug":"/ko-kr/features/image-generation","title":"AI Image"}}},{"node":{"fields":{"slug":"/ko-kr/features/relighting-and-angles","title":"조명 변경과 각도"}}},{"node":{"fields":{"slug":"/ko-kr/features/community","title":"Community"}}},{"node":{"fields":{"slug":"/ko-kr/features/upscaling","title":"업스케일링"}}},{"node":{"fields":{"slug":"/ko-kr/features/video","title":"AI Video"}}},{"node":{"fields":{"slug":"/ko-kr/features/techniques-and-templates","title":"기법과 템플릿"}}},{"node":{"fields":{"slug":"/ko-kr/features/workflows-and-canvas","title":"워크플로와 Canvas"}}},{"node":{"fields":{"slug":"/ko-kr/integrations/white-label","title":"White-Label"}}},{"node":{"fields":{"slug":"/ko-kr/features/virtual-try-on","title":"Virtual Try-On"}}},{"node":{"fields":{"slug":"/ko-kr/guides/create-your-first-image","title":"첫 번째 이미지 만들기"}}},{"node":{"fields":{"slug":"/ko-kr/guides/building-workflows-on-the-canvas","title":"캔버스에서 워크플로 구축하기"}}},{"node":{"fields":{"slug":"/ko-kr/integrations/api","title":"API"}}},{"node":{"fields":{"slug":"/ko-kr/guides/using-techniques-and-templates","title":"기법과 템플릿 사용하기"}}},{"node":{"fields":{"slug":"/ko-kr/guides/teams-and-brand-profiles","title":"팀과 브랜드 프로필"}}},{"node":{"fields":{"slug":"/ko-kr/knowledge-base/plans-credits-and-limits","title":"플랜, 크레딧, 한도"}}},{"node":{"fields":{"slug":"/ko-kr/guides/creating-videos","title":"영상 만들기"}}},{"node":{"fields":{"slug":"/ko-kr/knowledge-base/how-to-update-card-details","title":"카드 정보 업데이트 방법"}}},{"node":{"fields":{"slug":"/ko-kr/knowledge-base/understanding-declined-card-payments","title":"카드 결제 거절 이해하기"}}},{"node":{"fields":{"slug":"/ko-kr","title":"DesignerBox 문서"}}},{"node":{"fields":{"slug":"/ko-kr/features/workflows-and-canvas/node-types","title":"노드 유형"}}},{"node":{"fields":{"slug":"/ko-kr/features/image-generation/editing-modes","title":"편집 모드"}}}]}},"pageContext":{"id":"cc0bed27-2bd3-5beb-9494-9359bdec273c","locale":"ko-KR"}},"staticQueryHashes":["361965504","361965504","417421954","417421954","445494767","445494767"]}