인증

Meshy API를 사용하려면 인증이 필요합니다. 이 가이드에서는 계정과 API 키를 생성하는 방법을 안내합니다.

API Keys

Meshy 계정 생성하기

Meshy API를 사용하려면 API 키를 생성하고 관리하기 위해 Meshy 계정이 있어야 합니다. API 키 없이 API에 요청을 보내면, API는 잘못된 자격 증명 오류로 응답합니다.

Meshy 공식 웹사이트에 방문하여 가입하면 Meshy 계정을 만들 수 있습니다.

API 키 생성하기

Meshy 계정을 생성한 후에는 개발자 플랫폼의 API 키 페이지에서 API 키를 생성할 수 있습니다.

여러 용도에 맞게 여러 개의 API 키를 생성할 수 있습니다. 예를 들어, iOS 앱용 API 키 하나와 웹 앱용 API 키 하나를 각각 만들 수 있습니다. 각 API 키의 사용량은 개별적으로 추적되며, 언제든지 해당 키를 폐기할 수 있습니다.

또한 각 키에 월별 크레딧 한도를 설정할 수도 있어, 계정 전체 사용량과 관계없이 해당 키가 사용할 수 있는 한도를 제한할 수 있습니다 — 이는 계약자나 특정 환경에 넘겨주는 키의 사용량을 제한할 때 유용합니다.

선택적 월별 크레딧 한도 필드가 있는 API 키 생성 대화 상자

API 키를 생성하려면 API 페이지에서 Create API Key 버튼을 클릭한 다음, API 키의 이름을 입력하세요.

API 키를 생성하면 API 키 값이 표시됩니다. 이 API 키 값을 복사하여 안전한 곳에 보관하세요.

이 API 키 값은 다시 볼 수 없습니다.

API 키 사용하기

API 키를 생성한 후에는 이를 사용하여 Meshy API에 대한 요청을 인증할 수 있습니다. API 키는 Authorization 헤더에 담아 API로 전달할 수 있으며, 아래는 예시 헤더입니다.

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

헤더 값에서 Bearer 접두사는 Meshy API와 프로그래밍 방식으로 상호작용하기 위해 반드시 필요합니다. 자세한 내용은 IETF RFC 6750에서 확인할 수 있습니다.

Meshy는 보안을 매우 중요하게 여기며, Meshy API가 안전하게 유지되도록 최선을 다하고 있습니다. 여러분과 여러분의 사용자의 데이터가 저희와 함께 안전하기를 바랍니다. Meshy API를 사용할 때 데이터와 요청을 안전하게 유지하는 데 도움이 되는 몇 가지 높은 수준의 가이드라인을 아래에 소개하지만, 소속된 팀이나 직장에서 따르는 가이드라인도 반드시 함께 지켜주시기 바랍니다.

전송 계층 보안

Meshy에 저장된 데이터는 저장 시 암호화되지만, Meshy API는 전송 중 데이터를 암호화하기 위해 TLS를 사용하며 이를 강제합니다. 즉, Meshy API를 오가는 모든 요청은 HTTPS를 통해 전송되며, HTTP를 통한 요청은 301 Moved Permanently 상태 코드를 반환받게 됩니다. 권장되지는 않지만, 부득이하게 HTTP로 통신해야 하는 경우, HTTP 클라이언트가 HTTP에서 HTTPS로의 리디렉션을 따르도록 명시적으로 설정해야 합니다. 다음은 몇 가지 예시입니다.

Follow HTTP to HTTPS redirections

# use `-L` to follow HTTP to HTTPS redirections
curl -L -X 'POST' \
  https://api.meshy.ai/openapi/v1/text-to-texture

API 키 보안

Meshy 팀원조차도 폐기된 API 키를 대신 확인하거나 복구할 수 없다는 점을 유의해 주세요!

한 번 발급된 API 키는 더 이상 대시보드에서 확인할 수 없으므로, 반드시 다운로드하여 안전하게 보관하시기 바랍니다. 이 값을 획득한 사람은 누구든지 이를 사용하여 여러분을 대신해 Meshy API와 통신할 수 있기 때문입니다. API 키가 유출되었다고 판단되는 경우, 언제든지 대시보드에서 해당 키를 폐기할 수 있으며, 폐기된 키는 더 이상 유효하지 않습니다.

보안 취약점 신고

Meshy API에서 보안 문제를 발견하셨다고 생각되시면, 저희에게 연락해 주세요. 책임감 있는 신고에 감사드리며, 여러분의 기여를 인정하기 위해 최선을 다하겠습니다.

인증