Developer Platform

Developer Platform은 Meshy API 통합에 관한 모든 것을 실행, 모니터링, 구성하는 곳입니다 — 코드를 작성하지 않고도 엔드포인트를 사용해 볼 수 있는 Playground, 계정의 모든 API 요청을 다루는 대시보드, 그리고 API 키 및 webhook 관리 기능을 제공합니다.

Free 계정은 테스트용으로 제공되는 전용 내장 키를 통해 Image to 3D 엔드포인트에 대해서만 Playground를 사용해 볼 수 있습니다 — Free 계정은 자체 API 키를 생성하거나 관리할 수 없으며, 사용량 대시보드와 요청 로그도 이용할 수 없습니다. Pro, Premium, Ultra, Studio, Enterprise 플랜은 모든 Playground 엔드포인트, 사용량 대시보드 및 요청 로그에 대한 전체 접근 권한, 그리고 자체 API 키를 제공받습니다.

개요

웹 앱에서 Developer Platform 열기를 클릭하세요. 사이드바는 다음과 같이 구성되어 있습니다:

Build — 엔드포인트를 대화식으로 사용해 볼 수 있는 Playground.
Monitor — 사용량 대시보드 및 요청 로그.
Configure — API 키 및 Webhooks.

개요 페이지 자체는 신규 계정을 대상으로 아래 세 단계(키 생성, Playground에서 요청 시도, 요청 로그에서 결과 확인)를 안내한 다음, 자신의 계정 활동에 대한 7일간 사용량 스냅샷과 Meshy API 변경 로그의 최신 항목을 보여줍니다.

세 단계 시작 안내 카드, 7일간 사용량 스냅샷, 최신 Meshy API 변경 로그 업데이트를 보여주는 Developer Platform의 개요 페이지

API를 처음 사용하시나요? 빠른 시작부터 시작해 보세요.

Playground

Playground는 코드를 작성하지 않고도 엔드포인트를 사용해 볼 수 있는 대화형 콘솔입니다. 엔드포인트를 선택하고, 인라인 안내에 따라 매개변수를 입력한 다음 제출하면 됩니다 — 작업은 API와 동일한 비동기 파이프라인을 통해 실행되므로, 작업이 PENDING에서 SUCCEEDED로 이동하는 과정을 지켜볼 수 있고, 전체 응답과 결과 모델도 확인할 수 있습니다.

Preview, Request, Response 탭과 함께 실시간 모델 미리보기가 표시된, Image to 3D 요청을 실행 중인 Playground

작업이 실행되는 동안 Preview 탭은 실시간 상태 업데이트를 스트리밍합니다 — 폴링할 필요가 없습니다.

작업이 진행되는 동안 실시간 상태 업데이트를 스트리밍하는 Playground의 Preview 탭 로그

Request 탭으로 전환하면 cURL, Python, JavaScript로 바로 실행 가능한 코드 스니펫을 확인할 수 있고, Response 탭에서는 전체 JSON을 확인할 수 있습니다 — 바로 이 지점에서 Playground는 웹 앱 작업 공간보다 더 유용해집니다: 여러분이 구성한 모든 요청은 복사-붙여넣기 한 번이면 여러분 자신의 코드에서 바로 실행할 수 있습니다.

Request 및 Response 탭

동일한 작업을 두 가지 방식으로 본 모습입니다: 동등한 cURL 요청과 원본 JSON 응답.

현재 요청에 해당하는 cURL 명령어를 보여주는 Playground의 Request 탭 — Request

원본 JSON 응답을 보여주는 Playground의 Response 탭 — Response

사용량 대시보드

사용량 대시보드는 계정의 모든 API 활동을 시각화합니다 — API를 통해 직접 이루어진 요청이든 Playground에서 이루어진 요청이든 모두 포함됩니다. 생성 성공률, 총 요청 수, 평균 처리 시간, 소비된 크레딧을 보여주며, 시간에 따른 요청 볼륨과 엔드포인트별 성공률 및 지연 시간 분석도 함께 제공합니다.

생성 성공률, 시간에 따른 요청 볼륨, 엔드포인트별 성공률 및 지연 시간 분석을 보여주는 사용량 대시보드

요청 로그

요청 로그는 계정의 모든 API 작업을 나열합니다 — API를 직접 호출한 경우와 Playground 요청 모두 포함되며, 상태, 타이밍, 요청을 수행한 API 키가 함께 표시됩니다. 작업을 선택하면 전체 입력 및 출력, 요청 본문, 사용된 크레딧을 확인할 수 있습니다 — 특정 호출을 다시 조회하지 않고도 디버깅할 때 유용합니다 — 또는 Playground에서 바로 해당 작업으로 이동할 수도 있습니다. Export CSV를 사용하면 리포트 작성이나 대조를 위해 전체 목록을 내보낼 수 있습니다.

선택한 작업의 상태, 입력/출력 미리보기, 요청 본문이 상세 패널에 표시된 요청 로그 — Export CSV 및 Open in Playground 버튼이 강조 표시되어 있음

API 관리

API Keys — 키를 생성, 이름 지정, 취소하고, 각 키에 월별 크레딧 한도를 설정하며, 각 키의 사용량을 확인할 수 있습니다.
Webhooks — 폴링 대신 API 작업의 상태가 변경될 때 실시간 업데이트를 받을 수 있습니다. 설정 단계, 전송 요구 사항, 샘플 페이로드에 대해서는 Webhooks 가이드를 참고하세요.

피드백

Developer Platform의 모든 페이지 우측 하단에는 Feedback 버튼이 있습니다 — 버그를 신고하거나, 기능을 요청하거나, 헷갈리는 부분을 알려주고 싶을 때 사용하세요. 모든 제출 내용을 저희가 직접 확인합니다.

인증 및 크레딧

요청은 직접 API를 호출할 때와 정확히 동일하게, Authorization: Bearer 헤더에 전달된 API 키로 인증됩니다. Playground는 여러분 자신의 계정을 대상으로 실행되므로, 다른 모든 API 호출과 마찬가지로 모든 요청은 플랜 크레딧을 사용하며 요청 제한(rate limit)에도 포함됩니다. 키 형식과 보안에 대한 자세한 내용은 인증 가이드를 참고하세요.