---
title: "모델링 생성"
method: POST
path: "/api/v1/modelings"
tags: ["모델링"]
---

# 모델링 생성

`POST /api/v1/modelings`

파일을 업로드하여 모델링을 생성한다.

## Query parameters

- `isPersonal` boolean
- `startModeling` boolean

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- ApiResponseModelingResponse
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` ModelingResponse
    - `id` string, required — 모델링 ID
    - `name` string, required — 모델링 이름
    - `enterpriseId` string — 기업 ID
    - `userId` string, required — 사용자 ID
    - `renderingStatus` 'WAITING' | 'PROCESSING' | 'COMPLETED' | 'FAILED', required — 렌더링 상태
    - `renderingStartedAt` string, date-time — 렌더링 시작일시
    - `renderingFinishedAt` string, date-time — 렌더링 완료일시
    - `renderingFailedAt` string, date-time — 렌더링 실패일시
    - `dimension` ModelingDimension, required
      - `mmWidth` number, required — 너비 (mm)
      - `mmDepth` number, required — 깊이 (mm)
      - `mmHeight` number, required — 높이 (mm)
      - `inchWidth` number, required — 너비 (inch)
      - `inchDepth` number, required — 깊이 (inch)
      - `inchHeight` number, required — 높이 (inch)
    - `images` ModelingAsset[], required — 이미지 에셋 목록
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `file` ModelingAsset
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `editorAsset` ModelingAsset
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `renderAsset` ModelingAsset
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `decimateAsset` ModelingAsset
      - `id` string, required — 에셋 ID
      - `name` string, required — 에셋 이름
      - `url` string, required — 에셋 URL
    - `createdAt` string, date-time, required — 생성일시
    - `updatedAt` string, date-time, required — 수정일시
  - `error` ErrorMessage
    - `errorCode` 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN' — 에러 코드
    - `message` string — 에러 메시지

---

[API](https://skmtc.dev/archisketch/apis/open-api.md) · [All operations](https://skmtc.dev/archisketch/apis/open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archisketch/open-api/revisions/f6b0eda1a99d/schema)