인증

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 페이지에서 Create API Key 버튼을 클릭한 다음, API 키의 이름을 입력하세요.

API 키를 생성하면, API 키 값이 표시됩니다. 이 API 키 값을 복사하여 안전한 곳에 보관할 수 있습니다.

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

API 키 사용하기

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

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

Security

저희 Meshy는 보안을 매우 중요하게 생각하며, Meshy API를 안전하게 유지하기 위해 많은 노력을 기울이고 있습니다. 여러분의 데이터와 사용자의 데이터가 저희와 함께 안전하게 보호되기를 바랍니다. Meshy API를 사용할 때 데이터와 요청을 안전하게 유지하는 데 도움이 되는 몇 가지 상위 수준의 가이드라인을 소개하지만, 팀이나 직장에서 준수하는 가이드라인도 반드시 따라주시기 바랍니다.

Transport Layer Security

Meshy에 저장된 데이터는 저장 시 암호화되지만, Meshy API는 전송 중인 데이터를 암호화하기 위해 TLS를 사용하고 강제합니다. 이는 Meshy API로 보내고 받는 모든 요청이 HTTPS를 통해 전송되며, HTTP를 통해 이루어진 요청은 301 Moved Permanently 상태 코드를 받게 됨을 의미합니다. 권장하지는 않지만, HTTP로 통신해야 하는 경우, HTTP 클라이언트에 HTTP에서 HTTPS로의 리다이렉션을 따르도록 명시적으로 지시해야 합니다. 다음은 몇 가지 예시입니다:

# use `-L` to follow HTTP to HTTPS redirections
curl -L https://api.meshy.ai/openapi/v1/balance \
  -H "Authorization: Bearer ${YOUR_API_KEY}"

리다이렉션은 GET 요청에만 적용됩니다. HTTP 클라이언트는 리다이렉션된 POST 요청을 본문 없이 GET 요청으로 재전송하므로, 작업을 생성할 때는 항상 https://를 직접 호출하세요.

API Key Safety

생성된 후에는 API 키가 더 이상 대시보드에 표시되지 않으므로, 다운로드하여 안전하게 보관해 주세요. 이 키를 입수한 사람은 누구든지 여러분을 대신하여 Meshy API와 통신할 수 있습니다. API 키가 유출되었다고 생각되면, 언제든지 대시보드에서 취소할 수 있으며, 취소된 후에는 더 이상 유효하지 않게 됩니다.

Security Disclosure

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