すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:API キーの取得

    ドキュメントセンター

    Alibaba Cloud Model Studio:API キーの取得

    最終更新日:Jun 26, 2026

    Alibaba Cloud Model Studio でモデルやアプリケーションを使用する前に、認証用の API キーを取得する必要があります。

    説明

    このトピックでは、Model Studio の従量課金 API キーについて説明します。 Token Plan または Coding Plan を使用している場合は、対応する専用 API キー (sk-sp- で始まります) を使用してください。 詳細については、「Token Plan API Key」 および 「Coding Plan API Key」をご参照ください。

    API キーの作成

    重要

    この手順は、Alibaba Cloud アカウント、または 管理者 権限か API-Key ページ権限 を持つ RAM ユーザー が実行する必要があります。

    中国 (北京)、シンガポール、およびその他のリージョン

    1. Alibaba Cloud Model Studio コンソール に移動します。 右上隅で、[China (Beijing)]、[Singapore]、日本 (東京)、[China (Hong Kong)]、 または [Germany (Frankfurt)] などのリージョンを選択します。 [API Key] ページに移動し、Create API Key をクリックします。

    2. ダイアログボックスで、次の設定を行い、確定 をクリックします。

      • [ワークスペース]：デフォルトのワークスペースを選択することを推奨します。

      • 権限：全部 を選択することを推奨します。 よりきめ細かな制御を行うには、カスタム を選択して、アクセス可能な IP アドレスとモデルを設定します。

      API キーの権限設定の選択方法

      Alibaba Cloud Model Studio では、2種類の権限設定が提供されています。 ビジネス要件に応じていずれかを選択してください。

      • [全部]：API キーにすべてのモデルとアプリケーションを呼び出す権限を付与します。

      • [カスタム]：IP アドレスホワイトリストとアクセス可能なモデル範囲を設定できます。

        デフォルトでは、すべての IPv4 (0.0.0.0/0) トラフィックが許可されます。 IPv6 のサポートは、中国 (北京) リージョンでのみ利用可能です。
        IP アドレスホワイトリストには、最大 20 個の IPv4 または IPv6 アドレス、あるいは CIDR ブロックを追加できます。

      image

    3. キーが作成されると、完全な API キーがダイアログボックスに表示されます。 すぐにコピーまたはダウンロードして保存し、厳重に保管してください。 API キーがあれば、誰でもあなたに代わってサービスリクエストを行えるようになり、料金が発生する可能性があります。 ダイアログボックスを閉じると、プレーンテキストの API キーを二度と表示・コピーすることはできません。 キーを紛失した場合は、リセットするか、新しいキーを作成してください。

      Alibaba Cloud アカウントはすべての API キーを表示できます。 RAM ユーザーは自身が作成した API キーのみを表示できます。

      [API key] 管理ページで、右上隅の [+ Create API key] をクリックして別のキーを作成します。 既存の API キーについては、[Actions] 列で [Disable]、[Edit]、または [Delete] を実行できます。

    米国 (バージニア) リージョン

    1. Alibaba Cloud Model Studio コンソール に移動します。 右上隅で、リージョンを [US (Virginia)] に切り替えます。 Dashboard タブで、ナビゲーションウィンドウから [API Key] を選択します。 API キー管理ページで、Create API Key をクリックします。

    2. ダイアログボックスで、次の情報を設定し、確定 をクリックします。

      • [ワークスペース]：デフォルトのワークスペースを選択することを推奨します。

      • 説明：API キーの目的を識別しやすくするための説明を入力します。

    3. キーが作成されると、完全な API キーがダイアログボックスに表示されます。 すぐにコピーして安全に保管してください。 ダイアログボックスを閉じると、完全な API キーを再度表示することはできません。

    4. API キーリストで、API キーの横にある image アイコンをクリックして、マスクされたキーをコピーします。

      Alibaba Cloud アカウントはすべての API キーを表示できます。 RAM ユーザーは自身が作成した API キーのみを表示できます。

      右上隅の [+ Create API key] ボタンをクリックして、新しい API キーを作成します。

    他の所有者アカウントまたはワークスペースを使用する場合

    チームでの共同作業やコスト配分が必要な場合は、以下を検討してください。

    • ワークスペース：ワークスペースは、異なるプロジェクトやチームのリソースを分離するために使用されます。 ユーザーグループが呼び出せるモデルを制御したり、モデル呼び出しのコストを配分したりするには、リストからサブワークスペースを作成または選択します。

    詳細については、「API キーの権限」 および 「請求の照会とコスト管理」をご参照ください。

    API キーの使用

    API キーを公開しないでください。

    API キーのセキュリティ強化

    Model Studio は、セキュリティ強化のため、従量課金の API キー生成およびストレージメカニズムをアップグレードしました (米国 (バージニア) リージョンを除く)。 アップグレード前に作成された sk- で始まる API キーは、引き続き完全に機能し、影響はありません。 アップグレード後に作成されたすべての API キーは sk-ws で始まります。

    次の表に、アップグレード前と後で作成された API キーの主な違いを示します。

    比較項目

    アップグレード前のキー

    アップグレード後のキー

    キーの形式

    sk- で始まり、長さは約 32 文字です。

    sk-ws で始まり、以前の形式より長くなっています。

    プレーンテキストの表示

    いつでもコンソールから完全なプレーンテキストキーをコピーできます。

    プレーンテキストキーは作成時に一度だけ表示されます。 ダイアログボックスを閉じた後は、再度表示することはできません。 紛失した場合は、リセットするか、新しいキーを作成してください。

    呼び出し機能

    通常どおりモデルの呼び出しに使用でき、機能に影響はありません。

    通常どおりモデルの呼び出しに使用でき、機能はアップグレード前のキーと同じです。

    推奨アクション

    セキュリティを向上させるために、新しいキーを作成して古いキーを置き換えることを推奨します。

    作成後すぐにキーをコピーして保存し、安全に保管してください。

    API キーの権限

    API キーの権限は、そのキーが属するワークスペースによって完全に決定されます。 同じワークスペース内のすべての API キーは、同一の権限を持ちます。 Text-to-Text、Text-to-Image、音声合成モデルなど、モデルごとに異なる API キーを作成する必要はありません。

    • デフォルトワークスペースの API キー：すべての標準モデルと、デフォルトワークスペース内の任意のアプリケーションを呼び出すことができます。

    • サブワークスペースの API キー：サブワークスペースに権限が付与された標準モデルと、そのサブワークスペース内の任意のアプリケーションを呼び出すことができます。

    説明

    新しい API キーを作成する をクリックするか、既存の API キーの Edit をクリックすると、権限 を カスタム に切り替えて、以下を設定できます。

    以下の設定は、米国 (バージニア) リージョンではサポートされていません。

    • IP アドレスホワイトリスト：ホワイトリストに登録された IP アドレスからのみ、API キーを使用した呼び出しを許可します (IPv4、IPv6、および CIDR ブロックをサポート)。

    • [アクセス権限の範囲]：この API キーがアクセスできる特定のモデルまたはアプリケーションを選択できます。 選択されていないリソースは、このキーでは呼び出せません。

    API キーの有効期間

    API キーに有効期限はありません。 手動で削除するまで有効です。

    サードパーティのアプリケーションやユーザーに一時的なアクセスを許可する場合、または機密データのアクセスや削除などの高リスクな操作を厳密に制御する場合には、一時的な API キー (有効期間 60 秒) を生成できます。 これにより、長期間有効な API キーの漏洩リスクを低減できます。

    エラーコード

    モデルの呼び出しが失敗し、エラーメッセージが返された場合は、「エラーコード」を参照してトラブルシューティングを行ってください。

    よくある質問

    Q：1つの Alibaba Cloud アカウントで、いくつの API キーを作成できますか。

    A：シンガポール、中国 (北京)、中国 (香港)、日本 (東京)、ドイツ (フランクフルト) のリージョンでは、各 Alibaba Cloud アカウントはリージョンごとに最大 50 個の API キーを作成できます。

    米国 (バージニア) リージョンでは、Alibaba Cloud アカウントを含む各所有者アカウントは、最大 20 個の API キーを作成できます。

    Q：RAM ユーザーが削除された後、そのユーザーが作成した API キーは引き続き有効ですか。

    A：いいえ。 RAM コンソールで RAM ユーザーを無効化または削除すると、そのユーザーが作成したすべての API キーは無効になり、モデルの呼び出しには使用できなくなります。