AI에게 3D 출력 시키는 법

3D 프린팅 출력 서비스입니다. STL, 3MF, OBJ, STEP 모델을 보내면 가격, 크기, 출력 가능 여부를 계산해 주문 화면 링크를 돌려줍니다. 사용자가 그 링크를 열어 미리보기를 보고 결제하면 출력과 배송까지 진행됩니다. 대한민국에서 운영합니다.

에이전트 작업 절차

1. 1사용자가 3D 출력을 원하면 모델 파일(.stl, .3mf, .obj, .step, .stp)의 공개 주소를 먼저 찾습니다.
2. 2실행 환경에 따라 아래 방식 중 하나를 선택합니다. 임의 주소로 HTTP 요청을 보낼 수 없으면 "1. 웹 에이전트", 보낼 수 있으면 "2. 로컬 에이전트", MCP 서버를 붙일 수 있는 클라이언트면 "3. MCP"입니다.
3. 3그 절에 적힌 대로 주문 화면 링크를 만듭니다.
4. 4링크를 바로 누를 수 있는 형태로 사용자에게 전달하세요. 주소를 말로만 설명하거나 사용자가 받아 적게 하면 안 됩니다.
5. 5그 화면을 열어 3D 미리보기와 가격을 직접 확인하라고 안내하세요. 모델이 맞는지, 크기와 방향이 원하는 대로인지는 사람이 눈으로 봐야 압니다.
6. 6결제와 배송 입력은 사용자가 그 화면에서 합니다. API로는 결제할 수 없습니다.

1. 웹 에이전트 (ChatGPT, Gemini 등)

임의 주소로 요청을 보낼 수 없는 환경입니다. API를 부르려 하지 말고, 아래 주소를 조립해 사용자에게 링크로 주세요. 파일 등록은 사용자의 브라우저가 대신합니다.

https://www.oneclickfactory.co.kr/print3D?fileUrl=<URL_ENCODED_FILE_URL>

사용자가 그 링크를 열면 3D 미리보기, 가격, 결제가 그대로 이어집니다. 가격과 크기는 사용자가 화면에서 보게 되므로 대화 중에 미리 알려줄 수는 없습니다.

사용자에게 `/api/v1/models` 주소를 건네지 마세요. 그건 프로그램이 부르는 주소입니다. 사용자가 받아야 할 것은 위 /print3D?fileUrl= 형태의 클릭 가능한 주문 링크입니다.

모델 파일 주소에 ?나 &가 들어 있으면 URL 인코딩해서 넣으세요. 주소에서 파일 형식을 알 수 없으면 &fileName=model.stl을 덧붙이면 됩니다. OBJ의 길이 단위를 알면 &unit=cm처럼 덧붙이세요(아래 규칙).

이 방식에서는 에이전트가 오류를 볼 수 없습니다. 주소가 잘못됐거나 파일이 너무 크면 사용자가 링크를 열 때 화면에서 이유가 뜹니다. 그래서 5번(확인하라고 안내하기)이 중요합니다.

2. 로컬 에이전트 (Claude Desktop, VS Code 확장 등)

임의 주소로 HTTP 요청을 보낼 수 있는 환경입니다. 가입도 API 키도 필요 없습니다. 이쪽은 가격과 크기를 미리 받아서 사용자에게 알려줄 수 있습니다.

GET https://www.oneclickfactory.co.kr/api/v1/models?fileUrl=https://example.com/model.stl&quantity=1

돌아오는 값 (JSON):

{
  "token": "...",
  "link": "https://www.oneclickfactory.co.kr/print3D?model=...",
  "price": 32400,
  "currency": "KRW",
  "quantity": 1,
  "unitPrice": 32400,
  "subtotal": 32400,
  "deliveryFee": 3700,
  "estimatedTotal": 36100,
  "delivery": { "standard": 3700, "jeju": 6700, "island": 8700, "pickup": 0 },
  "volumeCm3": 84.31,
  "dimensions": { "x": 82.0, "y": 40.0, "z": 115.0, "unit": "mm" },
  "printable": true,
  "blockedFor": null
}

link를 사용자에게 전달하세요. 그 화면에서 3D 미리보기, 옵션 변경, 결제, 배송 입력이 모두 이루어집니다.

quantity=N(1~999)을 붙이면 subtotal과 estimatedTotal이 그 수량으로 나오고 link에도 실려, 사용자가 열었을 때 그 수량이 채워져 있습니다. price와 unitPrice는 1개 값입니다. estimatedTotal은 택배 기본 배송비를 더한 값이고, 제주와 도서는 delivery의 값이 대신 붙습니다.

파일이 손에 있고 공개 주소가 없으면(또는 fileUrl 상한을 넘으면) 파일 서버에 멀티파트로 먼저 올리고, 돌아온 filePath로 등록합니다:

curl -F "file=@model.stl" https://oneclickcode.co.kr/oneclickfactory/upload-reserve
→ { "filePath": "..." }
GET https://www.oneclickfactory.co.kr/api/v1/models?filePath=<filePath>&fileName=model.stl

printable: false면 blockedFor에 이유가 담깁니다. 링크를 주기 전에 사용자에게 알리세요.

주소에서 파일 형식을 알 수 없으면 &fileName=model.stl을 함께 보내세요. POST(JSON 본문)도 같은 방식으로 동작합니다.

오류는 HTTP 상태와 error 필드(한국어 설명)로 옵니다: 400 입력 오류, 404 없는 토큰, 410 만료된 링크, 413 크기 초과, 429 호출 한도(Retry-After 초만큼 기다렸다 재시도), 502 파일 서버 응답 없음. 주소에서 형식을 알 수 없을 때는 어떻게 부르면 되는지 example 주소까지 함께 옵니다.

받아온 것이 모델 파일이 아니라 웹페이지면 400으로 그 자리에서 알려줍니다. 모델 소개 페이지 주소가 아니라, 파일이 로그인 없이 그대로 내려받아지는 직접 주소가 필요합니다. fileName은 확장자가 주소에 안 드러나는 경우(CDN, 서명 링크)의 대체 수단이며, 웹페이지를 파일로 만들어 주지 않습니다.

API 호출이 불가능한 경우 웹 에이전트 방식을 사용하세요. 위 "1. 웹 에이전트"의 링크 조립은 어디서나 됩니다.

3. MCP (Claude 커넥터, ChatGPT 플러그인 등)

MCP 클라이언트에는 아래 주소를 서버로 등록합니다. Streamable HTTP, 인증 없음. 2번의 API와 같은 함수를 부르므로 규칙, 상한, 응답 모양이 전부 같습니다.

https://www.oneclickfactory.co.kr/api/mcp

• quote_model: fileUrl, file(ChatGPT에 올린 파일), filePath 중 하나와 quantity를 받아 2번과 같은 값을 돌려줍니다. 파일을 저장하므로 읽기 전용이 아니고, 클라이언트가 실행 전에 확인을 물을 수 있습니다
• get_quote: token과 quantity로 같은 모델의 견적을 다시 봅니다

Claude는 설정의 커넥터에서, ChatGPT는 개발자 모드의 플러그인에서 이 주소를 넣으면 됩니다. ChatGPT 웹은 대화에 올린 파일을 file로 넘겨주지만 휴대폰 앱은 아직 파일 참조가 온전히 오지 않습니다. 앱별로 어느 메뉴를 누르는지는 https://www.oneclickfactory.co.kr/mcp-guide 에 있습니다.

규칙

• 지원 형식: .stl, .3mf, .obj, .step, .stp
• STL이 아닌 파일(3MF, OBJ, STEP)은 STL로 바꿔서 견적을 냅니다. 바꾼 STL이 100MB를 넘으면 413으로 돌려보냅니다. 파일의 색은 쓰지 않아 링크 화면은 한 색으로 열립니다
• OBJ는 파일에 길이 단위가 없습니다. mm로 읽은 크기가 이상하면 400과 함께 단위별 크기(sizesByUnit)와 추천 단위(suggestedUnit)가 오니, unit(mm, cm, m, inch)을 붙여 다시 부르세요. 주문 링크에도 &unit=cm처럼 붙일 수 있습니다
• fileUrl로 보낼 때: 50MB까지
• 더 큰 파일: https://oneclickcode.co.kr/oneclickfactory/upload-reserve로 먼저 올리고(멀티파트, 100MB까지) 돌려받은 파일명을 filePath로 등록
• 호출 한도: 같은 IP에서 분당 10건, 하루 100건 (알려진 AI 에이전트는 분당 30건, 하루 500건). 같은 fileUrl을 다시 부르면 기존 링크를 그대로 돌려주며 한도를 쓰지 않습니다
• 링크 수명: 28일
• 수량: quantity 1~999. 없으면 1
• 값은 파일이 놓인 자세로 계산합니다. 주문 화면이 방향을 자동으로 잡으면 값이 내려갈 수 있고 올라가지는 않습니다
• 가격은 기본 옵션(레이어 0.2mm, 채움 15%, 서포트 켬) 기준 1개 값입니다. 배송비는 택배 3,700원(제주 +3,000원, 도서 +5,000원), 직접 수령은 무료이며 응답의 delivery에 있습니다. 택배는 출력이 끝나면 1일 이내에 발송합니다

너무 작거나 프린터 베드보다 큰 모델은 출력할 수 없습니다. 링크를 열어보기 전에 응답에서 알 수 있습니다.

문서

• 요금 안내|www.oneclickfactory.co.kr/pricing
• 이용 안내|www.oneclickfactory.co.kr/guide
• 문의|www.oneclickfactory.co.kr/contact