Skip to main content

サブワークスペースでのモデルの呼び出し

このトピックでは Qwen-Plus を例に、サブワークスペース (デフォルトワークスペース以外) で API を介してモデルを呼び出す方法について説明します。

シナリオ

  • 特定ユーザーが呼び出せるモデルの制御:デフォルトワークスペースの API キー ではすべてのモデルを呼び出せるため、権限が過剰です。RAM ユーザー が呼び出せるモデルを制御するには、ユーザーをサブワークスペースに追加し、必要なモデルにのみ権限を付与したうえで、そのワークスペースの API キーを使用させます。
  • モデルの呼び出しコストの配分:複数のサービスやシナリオでデフォルトワークスペースを使用すると、それぞれのモデルの呼び出しコストを区別しにくくなります。サービスまたはシナリオごとに個別のサブワークスペースを作成して 個別の請求書 を生成し、コスト配分を簡素化します。

前提条件

  1. サブワークスペースの API キーの取得:大規模モデル API を呼び出すには、サブワークスペースで API キーを作成し、 DASHSCOPE_API_KEY という名前で環境変数に設定します。
  2. モデル呼び出し権限の設定 (標準モデルでは必須):サブワークスペースの API キーを使用して qwen-plus などの 標準モデル を呼び出すには、そのサブワークスペースに対して事前に モデル呼び出し権限を設定する必要があります。
  3. 開発言語の選択:大規模モデル API を呼び出すには、使い慣れた言語と SDK を選択します。

モデルの呼び出し

OpenAI

  • シンガポール
  • 中国 (北京)
SDK base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1HTTP エンドポイント: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions
この例では、サブワークスペースで qwen-plus 標準モデルを OpenAI 互換の方法で呼び出す方法を示します。デフォルトワークスペースでの呼び出しとは異なり、サブワークスペースの API キーを使用する必要があります。
  • Python (SDK)
  • Java (SDK)
  • Node.js (SDK)
  • Go (SDK)
  • C# (HTTP)
  • PHP (HTTP)
  • curl (HTTP)
import os
from openai import OpenAI

client = OpenAI(
    # 環境変数が設定されていない場合は、次の行を Model Studio の API キーに置き換えます: api_key="sk-xxx"
    # シンガポールリージョンと北京リージョンの API キーは異なります。WorkspaceId を実際のワークスペース ID に置き換えてください。API キーを取得するには、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください。
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # この base_url はシンガポールリージョン用です。WorkspaceId を実際のワークスペース ID に置き換えてください。北京リージョン内のモデルの場合は、https://dashscope.aliyuncs.com/compatible-mode/v1 を使用します。
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)

completion = client.chat.completions.create(
    # この例では qwen-plus を使用します。必要に応じて別のモデル名に置き換えることができます。モデルのリストについては、https://www.alibabacloud.com/help/model-studio/getting-started/models をご参照ください。
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
    # enable_thinking パラメーターは Qwen3 モデルの思考プロセスを制御します (オープンソース版のデフォルトはTrue、商用版のデフォルトはFalse)。
    # ストリーミング出力を有効にせずにオープンソースの Qwen3 モデルを使用する場合は、エラーを回避するために次の行のコメントを解除してください。
    # extra_body={"enable_thinking": False},
)
print(completion.model_dump_json())

DashScope

  • シンガポールリージョン
  • 中国 (北京)
HTTP エンドポイント:
  • Qwen 大規模言語モデル: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation
  • Qwen-VL/OCR モデル: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
SDK 呼び出し時は Client を構築してワークスペースとリージョンを渡します(リージョンごとに region の値は異なり、シンガポールリージョンは ap-southeast-1 です):
  • Python
  • Java
import os
import dashscope

client = dashscope.Client(
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)
この例では、DashScope を使用してサブワークスペースで qwen-plus モデルを呼び出す方法を示します。デフォルトワークスペースを使用する場合との主な違いは、サブワークスペースの API キーを使用する必要がある ことです。
  • Python (SDK)
  • Java (SDK)
  • PHP (HTTP)
  • Node.js (HTTP)
  • C# (HTTP)
  • Go (HTTP)
  • curl (HTTP)
import os
import dashscope

# 以下はシンガポールリージョンの設定です。リージョンによって region の値は異なります。呼び出し時は、{WorkspaceId} をお使いのワークスペース ID に置き換えてください。中国 (北京) リージョンのモデルを使用する場合は、workspace パラメーターを削除し、region="cn-beijing" を使用してください。
client = dashscope.Client(
    # 環境変数が設定されていない場合は、api_key = "sk-xxx" に置き換えてください
    # リージョンごとに API キーは異なります。API キーの取得方法については、https://www.alibabacloud.com/help/model-studio/get-api-key をご参照ください。
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    workspace="{WorkspaceId}",
    region="ap-southeast-1",
)

messages = [
    {'role': 'system', 'content': 'You are a helpful assistant.'},
    {'role': 'user', 'content': 'Who are you?'}
]
response = client.chat.completions.create(
    model="qwen-plus", # この例では qwen-plus を使用しています。必要に応じて別のモデル名に置き換えることができます。モデルのリストについては、https://www.alibabacloud.com/help/model-studio/getting-started/models をご参照ください。
    messages=messages,
    )
print(response)

エラーコード

モデルの呼び出しでエラーが返された場合は、エラーメッセージをご参照ください。

次のステップ

他のモデルの探索

サンプルコードでは qwen-plus モデルを使用しています。 Model Studio は、他の Qwen モデルもサポートしています。サポートされているモデルのリストと API リファレンスについては、モデルをご参照ください。

高度な使用方法

サンプルコードでは、基本的な Q&A シナリオを示しています。テキスト生成の概要では、ストリーミング出力、構造化出力、関数呼び出しなどの高度な Qwen API 機能について説明しています。