認証

Meshy APIを使用するには認証が必要です。このガイドでは、アカウントとAPIキーを作成する方法を説明します。


APIキー

Meshyアカウントの作成

Meshy APIを利用するには、Meshyアカウントを作成し、APIキーを管理する必要があります。APIキーなしでAPIにリクエストを行うと、無効な資格情報エラーが返されます。

Meshy公式ウェブサイトを訪問し、サインアップすることでMeshyアカウントを作成できます。

APIキーの作成

Meshyアカウントを作成した後、API設定ページにアクセスしてAPIキーを作成できます。

異なる目的のために複数のAPIキーを作成することができます。例えば、iOSアプリ用に1つのAPIキーを、ウェブアプリ用に別のAPIキーを作成することができます。各APIキーの使用状況は個別に追跡され、いつでも取り消すことができます。

APIキーを作成するには、APIページでCreate API Keyボタンをクリックし、APIキーの名前を入力します。

APIキーを作成すると、APIキーの値が表示されます。APIキーの値をコピーして安全な場所に保管してください。

このAPIキーの値は再度表示されません。

APIキーの使用

APIキーを作成したら、それを使用してMeshy APIへのリクエストを認証できます。APIキーをAuthorizationヘッダーに渡すことができます。以下に例を示します。

{
  "Authorization": "Bearer msy_sOmEbOgUsApIkEyFoReXaMpLe1234567890"
}

セキュリティ

Meshyではセキュリティを非常に重視しており、Meshy APIが安全であることを確保するために努力しています。あなたのデータとユーザーのデータが私たちと共に安全であることを願っています。 Meshy APIを使用する際にデータとリクエストを安全に保つための高レベルのガイドラインを以下に示しますが、チームや職場で実践されているガイドラインにも従ってください。

トランスポート層セキュリティ

Meshyに保存されたデータは保存時に暗号化されますが、Meshy APIはTLSを使用してデータを転送中に暗号化します。これにより、Meshy APIへのすべてのリクエストはHTTPSを介して送信され、HTTPで行われたリクエストは301 Moved Permanentlyステータスコードを受け取ります。推奨されませんが、場合によってはHTTPに接続する必要がある場合、HTTPクライアントにHTTPからHTTPSへのリダイレクトを明示的に指示する必要があります。以下に例を示します。

HTTPからHTTPSへのリダイレクトをフォロー

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

APIキーの安全性

発行されたAPIキーはダッシュボードに表示されなくなるため、ダウンロードして安全に保管してください。取得した人は誰でもあなたに代わってMeshy APIと通信できるためです。APIキーが漏洩したと思われる場合は、ダッシュボードからいつでも取り消すことができ、取り消された後は無効になります。

セキュリティ開示

Meshy APIにセキュリティ問題を発見したと思われる場合は、ご連絡ください。責任ある開示を感謝し、貢献を認めるためにあらゆる努力をいたします。