Developer Platform

Developer Platform에서 Meshy API 연동을 실행, 모니터링, 구성하세요. 코드를 작성하지 않고도 엔드포인트를 시험해 볼 수 있는 플레이그라운드, 계정의 모든 API 요청을 보여주는 대시보드, API 키 및 webhook 관리 기능을 제공합니다.

Free 플랜에서는 테스트용으로 내장된 키를 통해 플레이그라운드에서 이미지로 3D만 시험해 볼 수 있습니다. Free 계정은 API 키를 생성하거나 관리할 수 없으며, 사용량 대시보드나 요청 로그도 제공되지 않습니다. Pro, Premium, Ultra, Studio, Enterprise 플랜은 모든 플레이그라운드 엔드포인트, 사용량 대시보드와 요청 로그, 그리고 자체 API 키를 사용할 수 있습니다.

개요

웹 앱에서 Developer Platform을 여세요. 사이드바는 세 그룹으로 구성되어 있습니다:

Build: 엔드포인트를 대화형으로 시험해 볼 수 있는 플레이그라운드.
Monitor: 사용량 대시보드와 요청 로그.
Configure: API 키와 Webhooks.

Overview 페이지는 신규 계정을 위해 키 생성, 플레이그라운드에서 요청 시도, 요청 로그에서 결과 확인이라는 세 단계를 안내합니다. 또한 계정 사용량의 최근 7일 스냅샷과 변경 로그의 최신 항목도 함께 보여줍니다.

Developer Platform의 Overview 페이지. 3단계 시작 안내 카드, 7일간 사용량 스냅샷, 최신 Meshy API 변경 로그 항목을 보여줍니다

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

플레이그라운드

플레이그라운드는 코드를 작성하지 않고도 엔드포인트를 시험해 볼 수 있는 대화형 콘솔입니다. 엔드포인트를 선택하고, 인라인 안내에 따라 매개변수를 채운 다음 요청을 제출하세요. 작업은 API 작업과 동일한 비동기 파이프라인을 통해 실행됩니다. PENDING에서 SUCCEEDED로 이동하는 과정을 지켜본 다음, 전체 응답과 결과 모델을 확인할 수 있습니다.

이미지로 3D 요청을 실행 중인 플레이그라운드. 실시간 모델 미리보기와 함께 Preview, Request, Response 탭이 표시됩니다

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

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

Request 탭은 cURL, Python, JavaScript로 바로 실행 가능한 코드 스니펫을 보여주며, Response 탭은 전체 JSON을 보여줍니다. 웹 앱 작업 공간과 달리, 플레이그라운드는 여러분이 만드는 모든 요청을 여러분의 앱에 그대로 복사해 넣을 수 있는 코드로 제공합니다.

Request 및 Response 탭

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

현재 요청에 해당하는 cURL 명령을 보여주는 플레이그라운드의 Request 탭 — Request

원시 JSON 응답을 보여주는 플레이그라운드의 Response 탭 — Response

사용량 대시보드

사용량 대시보드는 직접 API 호출과 플레이그라운드를 통한 것을 포함해 계정의 모든 API 활동을 차트로 보여줍니다. 생성 성공률, 총 요청 수, 평균 처리 시간, 사용된 크레딧을 보여줍니다. 또한 시간에 따른 요청 양, 엔드포인트별 성공률과 지연 시간도 보여줍니다.

생성 성공률, 시간에 따른 요청 양, 엔드포인트별로 나뉜 성공률과 지연 시간을 보여주는 사용량 대시보드

요청 로그

요청 로그는 직접 API 호출과 플레이그라운드를 통한 것을 포함해 계정의 모든 API 작업을 나열합니다. 각 항목은 상태, 타이밍, 요청을 수행한 API 키를 보여줍니다.

작업을 선택하면 전체 입력과 출력, 요청 본문, 사용된 크레딧을 확인할 수 있습니다. 이를 통해 API를 다시 쿼리하지 않고도 호출을 디버그할 수 있습니다. 작업을 플레이그라운드에서 열려면 Open in Playground를 클릭하세요. 리포트나 대사 작업을 위해 전체 목록을 다운로드하려면 Export CSV를 클릭하세요.

요청 로그. 선택된 작업의 상태, 입력 및 출력 미리보기, 세부 패널의 요청 본문을 보여줍니다. Export CSV 및 Open in Playground 버튼이 강조 표시되어 있습니다.

API 관리

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

피드백

Developer Platform의 모든 페이지에는 Feedback 버튼이 있습니다. 이를 사용해 버그를 리포트하거나, 기능을 요청하거나, 헷갈리는 부분을 알려주세요. Meshy 팀은 모든 제출 내용을 읽습니다.

인증 및 크레딧

플레이그라운드 요청은 직접 API 호출과 마찬가지로 Authorization: Bearer 헤더에 API 키를 담아 전송합니다. 플레이그라운드는 여러분 자신의 계정에서 실행되므로, 다른 모든 API 호출과 마찬가지로 모든 요청은 여러분의 플랜 크레딧을 사용하고 속도 제한(rate limit)에 포함됩니다. API 키와 보안에 대한 자세한 내용은 인증을 참조하세요.