すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:Qwen への最初の API 呼び出し

最終更新日:Mar 25, 2026

Alibaba Cloud Model Studio では、OpenAI 互換インターフェイスおよび DashScope SDK を使用してモデルへの API 呼び出しが可能です。

Qwen API を呼び出すには、以下の手順を実行します。

  • API キーを取得する

  • ローカル開発環境をセットアップする

  • Qwen API を呼び出す

アカウントのセットアップ

  1. アカウントの作成:Alibaba Cloud アカウント (root ユーザー) をお持ちでない場合は、アカウントを作成してください。

    問題が発生した場合は、「Alibaba Cloud アカウントの登録」をご参照ください。
  2. Model Studio の有効化:ご利用の Alibaba Cloud アカウント (root ユーザー) を使用して、「Alibaba Cloud Model Studio」にアクセスします。サービスを有効化するために、利用規約をお読みになり、同意してください。利用規約のダイアログボックスが表示されない場合は、すでにサービスが有効化されています。

  3. API キーの取得:「キー管理」ページに移動し、Create API key をクリックします。その後、取得した API キーを使用してモデルを呼び出します。

API キーを環境変数として設定

認証情報をコード内にハードコーディングせずに済むよう、API キーを環境変数として保存することを推奨します。これにより、セキュリティリスクも低減されます。

手順

Linux

永続的な環境変数

API キーを今後のすべてのセッションで利用可能にするには、永続的に設定します。

  1. 次のコマンドを実行して、環境変数を ~/.bashrc ファイルに追加します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc

    また、~/.bashrc ファイルを手動で編集することもできます。

    手動編集

    次のコマンドを実行して、~/.bashrc ファイルを開きます。

    nano ~/.bashrc

    ファイルに以下の内容を追加します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

    nano エディターで、Ctrl+X を押し、次に Y を押します。Enter キーを押してファイルを保存し、閉じます。

  2. 変更を有効化するには、次のコマンドを実行します。

    source ~/.bashrc
  3. 新しいセッションを作成し、次のコマンドを実行して、環境変数が正しく設定されたかを確認します。

    echo $DASHSCOPE_API_KEY

一時的な環境変数

API キーを現在のセッションでのみ使用する場合は、一時的に設定します。

  1. 次のコマンドを実行します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. 環境変数が正しく設定されたかを確認するには、次のコマンドを実行します。

    echo $DASHSCOPE_API_KEY

macOS

永続的な環境変数

API キーを今後のすべてのセッションで利用可能にするには、永続的に設定します。

  1. デフォルトのシェルの種類を確認するには、次のコマンドを実行します。

    echo $SHELL
  2. シェルの種類に応じて、以下の操作を行います。

    Zsh
    1. 次のコマンドを実行して、環境変数を ~/.zshrc ファイルに追加します。

      # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc

      また、~/.zshrc ファイルを手動で編集することもできます。

      手動編集

      構成ファイルを開くには、次のコマンドを実行します。

      nano ~/.zshrc

      ファイルに以下の内容を追加します。

      # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      nano エディターで、Ctrl+X を押し、次に Y を押します。Enter キーを押してファイルを保存し、閉じます。

    2. 変更を有効化するには、次のコマンドを実行します。

      source ~/.zshrc
    3. 新しいセッションを作成し、次のコマンドを実行して、環境変数が正しく設定されたかを確認します。

      echo $DASHSCOPE_API_KEY
    Bash
    1. 次のコマンドを実行して、環境変数を ~/.bash_profile ファイルに追加します。

      # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile

      また、~/.bash_profile ファイルを手動で編集することもできます。

      手動編集

      ファイルを開くには、次のコマンドを実行します。

      nano ~/.bash_profile

      ファイルに以下の内容を追加します。

      # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      nano エディターで、Ctrl+X を押し、次に Y を押します。Enter キーを押してファイルを保存し、閉じます。

    2. 変更を有効化するには、次のコマンドを実行します。

      source ~/.bash_profile
    3. 新しいセッションを作成し、次のコマンドを実行して、環境変数が正しく設定されたかを確認します。

      echo $DASHSCOPE_API_KEY

一時的な環境変数

API キーを現在のセッションでのみ使用する場合は、一時的に設定します。

以下のコマンドは、Zsh および Bash のみで動作します。
  1. 次のコマンドを実行します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. 環境変数が正しく設定されたかを確認するには、次のコマンドを実行します。

    echo $DASHSCOPE_API_KEY

Windows

Windows では、システムのプロパティ、コマンドライン、または PowerShell を使用して環境変数をエクスポートできます。

システムのプロパティ

説明
  • この方法で設定した環境変数は、永続的に有効になります。

  • システム環境変数の変更には管理者権限が必要です。

  • 環境変数を設定した後、既に実行中のプログラムには影響しません。IDE やコマンドウィンドウを再起動するか、新しいコマンドラインを開いて、新しい変数を読み込んでください。

  1. デスクトップで Win+Q を押します。検索ボックスに「システム環境変数の編集」と入力し、システムのプロパティ ウィンドウを開きます。

  2. システムのプロパティ ウィンドウで、環境変数 をクリックします。システム変数 セクションで、新規 をクリックし、変数名に DASHSCOPE_API_KEY、変数値に 実際の API キー を入力します。

    image

  3. すべての 3 つのダイアログボックスで OK をクリックします。

  4. CMD または Windows PowerShell を開き、次のコマンドを実行して、環境変数が正しく設定されたかを確認します。

    • CMD:

      echo %DASHSCOPE_API_KEY%

      image

    • Windows PowerShell:

      echo $env:DASHSCOPE_API_KEY

      image

CMD

永続的な環境変数

API キーを今後のすべてのセッションで利用可能にするには、永続的に設定します。

  1. 次のコマンドを実行します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"
  2. 新しいセッションを作成します。

  3. 環境変数が正しく設定されたかを確認するには、次のコマンドを実行します。

    echo %DASHSCOPE_API_KEY%

    image

一時的な環境変数

API キーを現在のセッションでのみ使用する場合は、一時的に設定します。

  1. 次のコマンドを実行します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    set DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. 現在のセッションで、環境変数が正しく設定されたかを確認するには、次のコマンドを実行します。

    echo %DASHSCOPE_API_KEY%

    image

PowerShell

永続的な環境変数

API キーを今後のすべてのセッションで利用可能にするには、永続的に設定します。

  1. 次のコマンドを実行します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    [Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
  2. 新しいセッションを作成します。

  3. 環境変数が正しく設定されたかを確認するには、次のコマンドを実行します。

    echo $env:DASHSCOPE_API_KEY

    image

一時的な環境変数

API キーを現在のセッションでのみ使用する場合は、一時的に設定します。

  1. 次のコマンドを実行します。

    # YOUR_DASHSCOPE_API_KEY を実際の API キーに置き換えます。
    $env:DASHSCOPE_API_KEY = "YOUR_DASHSCOPE_API_KEY"
  2. 現在のセッションで、環境変数が正しく設定されたかを確認するには、次のコマンドを実行します。

    echo $env:DASHSCOPE_API_KEY

    image

開発言語の選択

モデルの API を呼び出すために、言語またはツールを選択します。

Python

ステップ 1:Python のセットアップ

Python のバージョンを確認

Python および pip がインストールされているかを確認するには、次のコマンドを実行します。

Python 3.8 以降が必要です。インストール手順については、「Python のインストール」をご参照ください。

python -V
pip --version

たとえば、Windows コマンドプロンプトでは次のようになります。

image

よくある質問

Q:python -V および pip --version のコマンドでエラーが返される場合:

  • 'python' は内部コマンドまたは外部コマンドとして認識されていません。また、実行可能なプログラムまたはバッチファイルでもありません。

  • 'pip' は内部コマンドまたは外部コマンドとして認識されていません。また、実行可能なプログラムまたはバッチファイルでもありません。

  • -bash: python: command not found

  • -bash: pip: command not found

以下の解決策をお試しください。

Windows
  1. Python のインストール」に従って Python をインストールし、PATH 環境変数に python.exe を追加したことを確認してください。image

  2. Python および PATH の設定が正しく行われているにもかかわらずエラーが続く場合は、現在のターミナルを閉じ、新しいターミナルを開いてください。

Linux および macOS

  1. Python のインストール」に従って Python をインストールしたことを確認してください。

  2. Python はインストールされていますがエラーが続く場合は、which python pip を実行して、python および pip がシステムに存在するかを確認してください。

    • この結果が表示された場合は、現在のターミナルウィンドウを閉じ、新しいターミナルウィンドウを開いて再度お試しください。

      /usr/bin/python
      /usr/bin/pip
    • この結果が返された場合は、which python3 pip3 のクエリを再度実行してください。

      /usr/bin/which: no python in (/root/.local/bin:/root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin)
      /usr/bin/which: no pip in (/root/.local/bin:/root/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin)

      返された結果が上記のとおりの場合は、python3 -V および pip3 --version を使用してバージョンを確認してください。

      /usr/bin/python3
      /usr/bin/pip3

仮想環境のセットアップ(任意)

Python が既にインストールされている場合は、OpenAI Python SDK または DashScope Python SDK をインストールし、依存関係の競合を回避するために仮想環境を作成できます。

  1. 仮想環境の作成

    仮想環境を .venv という名前で作成します。

    # 失敗した場合は、python を python3 に置き換えます。
    python -m venv .venv
  2. 仮想環境の有効化

    Windows では、仮想環境を有効化します。

    .venv\Scripts\activate

    macOS または Linux では、次のコマンドを実行します。

    source .venv/bin/activate

OpenAI Python SDK または DashScope Python SDK のインストール

Model Studio 上のモデルを呼び出すには、OpenAI Python SDK または DashScope Python SDK を使用できます。

OpenAI Python SDK のインストール

OpenAI Python SDK をインストールまたはアップグレードします。

# 失敗した場合は、pip を pip3 に置き換えます。
pip install -U openai

image

インストールが成功したかどうかを確認するには、Successfully installed ... openai-x.x.x が表示されることを確認してください。

DashScope Python SDK のインストール

DashScope Python SDK をインストールまたはアップグレードします。

# 失敗した場合は、pip を pip3 に置き換えます。
pip install -U dashscope

image

インストールが成功したかどうかを確認するには、Successfully installed ... dashscope-x.x.x が表示されることを確認してください。

ステップ 2:API の呼び出し

OpenAI Python SDK

Python および OpenAI Python SDK をインストールした後、最初の API リクエストを送信します。

  1. hello_qwen.py という名前のファイルを作成します。

  2. このコードを hello_qwen.py にコピーして保存します。

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # 環境変数が設定されていない場合は、api_key="sk-xxx" に置き換えます。
            api_key=os.getenv("DASHSCOPE_API_KEY"),
            base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        )
    
        completion = client.chat.completions.create(
            model="qwen-plus",  
            messages=[
                {'role': 'system', 'content': 'You are a helpful assistant.'},
                {'role': 'user', 'content': 'Who are you?'}
            ]
        )
        print(completion.choices[0].message.content)
    except Exception as e:
        print(f"エラー メッセージ: {e}")
        print("参照:https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
  3. コマンドラインから python hello_qwen.py または python3 hello_qwen.py を実行します。

    No such file or directory というエラーが表示された場合は、ファイルの完全なパスを指定してください。

    出力は以下のとおりです。

    私は Alibaba Cloud が開発した大規模言語モデルです。私の名前は Qwen です。

DashScope Python SDK

Python および DashScope Python SDK をインストールした後、最初の API リクエストを送信します。

  1. hello_qwen.py という名前のファイルを作成します。

  2. このコードを hello_qwen.py にコピーして保存します。

    import os
    from dashscope import Generation
    import dashscope
    
    dashscope.base_http_api_url = 'https://dashscope-intl.aliyuncs.com/api/v1'
    messages = [
        {'role': 'system', 'content': 'You are a helpful assistant.'},
        {'role': 'user', 'content': 'Who are you?'}
    ]
    response = Generation.call(
        # シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
        # 環境変数が設定されていない場合は、api_key = "sk-xxx" に置き換えます。
        api_key=os.getenv("DASHSCOPE_API_KEY"), 
        model="qwen-plus",   
        messages=messages,
        result_format="message"
    )
    
    if response.status_code == 200:
        print(response.output.choices[0].message.content)
    else:
        print(f"HTTP ステータスコード: {response.status_code}")
        print(f"エラー コード: {response.code}")
        print(f"エラー メッセージ: {response.message}")
        print("参照:https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
  3. コマンドラインから python hello_qwen.py または python3 hello_qwen.py を実行します。

    説明

    この例のコマンドは、Python ファイルが格納されているディレクトリから実行する必要があります。他の場所から実行する場合は、完全なパスを指定してください。

    出力は以下のとおりです。

    私は Alibaba Cloud の大規模言語モデルです。私の名前は Qwen です。

Node.js

ステップ 1:Node.js 環境のセットアップ

Node.js のインストール状況の確認

Node.js および npm がインストールされているかを確認します。

node -v
npm -v

たとえば、Windows コマンドプロンプトでは次のようになります。

image

これは、現在の Node.js のバージョンを表示します。Node.js がインストールされていない場合は、Node.js の公式 Web サイトからダウンロードしてください。

モデル呼び出し用 SDK のインストール

ターミナルで次のコマンドを実行します。

npm install --save openai
# または
yarn add openai
説明

インストールに失敗した場合は、レジストリのミラーを設定します。

npm config set registry https://registry.npmmirror.com/

ミラーを設定した後、SDK のインストールコマンドを再実行してください。

image

インストールが成功したかどうかを確認するには、added xx package in xxs が表示されることを確認してください。バージョンを確認するには、npm list openai を実行します。

ステップ 2:モデル API の呼び出し

  1. hello_qwen.mjs という名前のファイルを作成します。

  2. このコードをファイルにコピーします。

    import OpenAI from "openai";
    
    try {
        const openai = new OpenAI(
            {
                // シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
                // 環境変数が設定されていない場合は、apiKey: "sk-xxx" に置き換えます。
                apiKey: process.env.DASHSCOPE_API_KEY,
                // 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
                // - シンガポール:https://dashscope-intl.aliyuncs.com/compatible-mode/v1
                // - 米国 (バージニア):https://dashscope-us.aliyuncs.com/compatible-mode/v1
                // - 中国 (北京):https://dashscope.aliyuncs.com/compatible-mode/v1
                baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
            }
        );
        const completion = await openai.chat.completions.create({
            model: "qwen-plus",  
            messages: [
                { role: "system", content: "You are a helpful assistant." },
                { role: "user", content: "Who are you?" }
            ],
        });
        console.log(completion.choices[0].message.content);
    } catch (error) {
        console.log(`エラー メッセージ: ${error}`);
        console.log("参照:https://www.alibabacloud.com/help/model-studio/developer-reference/error-code");
    }
  3. API リクエストを送信するには、次のコマンドを実行します。

    node hello_qwen.mjs
    説明
    • hello_qwen.mjs が格納されているディレクトリからこのコマンドを実行してください。任意の場所から実行する場合は、ファイルの完全なパスを指定してください。

    • SDK が hello_qwen.mjs と同じディレクトリにインストールされていることを確認してください。異なるディレクトリにある場合、「Cannot find package 'openai' imported from xxx」というエラーが表示されます。

    正常に実行された場合の出力は以下のとおりです。

    私は Alibaba Cloud の言語モデルです。私の名前は Qwen です。

Java

ステップ 1:Java 環境のセットアップ

Java のバージョンを確認

ターミナルで次のコマンドを実行します。

java -version
# (オプション)Maven を使用して Java プロジェクトを管理およびビルドする場合、Maven がインストールされていることを確認してください。
mvn --version

たとえば、Windows コマンドプロンプトでは次のようになります。

image

DashScope Java SDK には Java 8 以降が必要です。たとえば、openjdk version "16.0.1" 2021-04-20 は Java 16 を意味します。Java がインストールされていない場合、またはバージョンが Java 8 より古い場合は、Java のダウンロードからダウンロードしてインストールしてください。

モデル呼び出し用 SDK のインストール

DashScope Java SDK をインストールします。最新バージョンについては、「DashScope Java SDK」をご参照ください。この依存関係を追加し、the-latest-version を最新のバージョン番号に置き換えます。

XML

  1. Maven プロジェクトの pom.xml ファイルを開きます。

  2. <dependencies> タグに、この依存関係を追加します。

    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>dashscope-sdk-java</artifactId>
        <!-- 'the-latest-version' を最新のバージョン番号に置き換えます:https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
        <version>the-latest-version</version>
    </dependency>
  3. pom.xml ファイルを保存します。

  4. Maven コマンド(例:mvn compile または mvn clean install)を実行して、依存関係を更新します。Maven が自動的に DashScope Java SDK をプロジェクトにダウンロードして追加します。

たとえば、Windows の IntelliJ IDEA では次のようになります。

image

Gradle

  1. Gradle プロジェクトの build.gradle ファイルを開きます。

  2. dependencies ブロックに、この依存関係を追加します。

    dependencies {
        // 'the-latest-version' を最新のバージョン番号に置き換えます:https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java
        implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: 'the-latest-version'
    }
  3. build.gradle ファイルを保存します。

  4. ターミナルでプロジェクトのルートディレクトリに移動し、依存関係を更新する Gradle コマンドを実行します。これにより、DashScope Java SDK が自動的にプロジェクトにダウンロードされて追加されます。

    ./gradlew build --refresh-dependencies

たとえば、Windows の IntelliJ IDEA では次のようになります。

image

ステップ 2:API の呼び出し

このコードを実行して、モデル API を呼び出します。

import java.util.Arrays;
import java.lang.System;
import com.alibaba.dashscope.aigc.generation.Generation;
import com.alibaba.dashscope.aigc.generation.GenerationParam;
import com.alibaba.dashscope.aigc.generation.GenerationResult;
import com.alibaba.dashscope.common.Message;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.InputRequiredException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.protocol.Protocol;
public class Main {
    public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
        // 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
        // - シンガポール:https://dashscope-intl.aliyuncs.com/api/v1
        // - 米国 (バージニア):https://dashscope-us.aliyuncs.com/api/v1
        // - 中国 (北京):https://dashscope.aliyuncs.com/api/v1
        Generation gen = new Generation(Protocol.HTTP.getValue(), "https://dashscope-intl.aliyuncs.com/api/v1");
        Message systemMsg = Message.builder()
                .role(Role.SYSTEM.getValue())
                .content("You are a helpful assistant.")
                .build();
        Message userMsg = Message.builder()
                .role(Role.USER.getValue())
                .content("Who are you?")
                .build();
        GenerationParam param = GenerationParam.builder()
                // シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
                // 環境変数が設定されていない場合は、.apiKey("sk-xxx") に置き換えます。
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // モデル一覧:https://www.alibabacloud.com/help/model-studio/getting-started/models
                .model("qwen-plus")
                .messages(Arrays.asList(systemMsg, userMsg))
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .build();
        return gen.call(param);
    }
    public static void main(String[] args) {
        try {
            GenerationResult result = callWithMessage();
            System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            System.err.println("エラー メッセージ: "+e.getMessage());
            System.out.println("参照:https://www.alibabacloud.com/help/model-studio/developer-reference/error-code");
        }
        System.exit(0);
    }
}

出力は以下のとおりです。

私は Alibaba Cloud が開発した大規模言語モデルです。私の名前は Qwen です。

curl

OpenAI 互換 HTTP エンドポイントまたは DashScope HTTP エンドポイントを使用して、Model Studio 上のモデルを呼び出します。サポートされているモデルについては、「モデル一覧」をご参照ください。

説明

DASHSCOPE_API_KEY が設定されていない場合は、-H "Authorization: Bearer $DASHSCOPE_API_KEY" を -H "Authorization: Bearer sk-xxx" に置き換えてください。

OpenAI 互換 HTTP

この例の URL では シンガポール リージョンを使用しています。中国 (北京) リージョンを使用する場合は、URL を https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions に置き換えてください。

API リクエストを送信します。

Windows

コマンドプロンプトで次のコマンドを実行します。

# ======= 重要なお知らせ =======
# シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
# 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
# - シンガポール:https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
# - 米国 (バージニア):https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
# - 中国 (北京):https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === 実行前にこのコメントを削除してください ===

curl -X POST "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
-H "Authorization: Bearer %DASHSCOPE_API_KEY%" \
-H "Content-Type: application/json" \
-d "{
    \"model\": \"qwen-plus\",
    \"messages\": [
        {
            \"role\": \"system\",
            \"content\": \"You are a helpful assistant.\"
        },
        {
            \"role\": \"user\",
            \"content\": \"Who are you?\"
        }
    ]
}"

Linux および macOS

ターミナルで次のコマンドを実行します。

# ======= 重要なお知らせ =======
# シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
# 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
# - シンガポール:https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
# - 米国 (バージニア):https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
# - 中国 (北京):https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === 実行前にこのコメントを削除してください ===

curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user", 
            "content": "Who are you?"
        }
    ]
}'

API リクエストを送信した後、次の応答が返されます。

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "私は Alibaba Cloud の大規模言語モデルです。私の名前は Qwen です。"
            },
            "finish_reason": "stop",
            "index": 0,
            "logprobs": null
        }
    ],
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 22,
        "completion_tokens": 16,
        "total_tokens": 38
    },
    "created": 1728353155,
    "system_fingerprint": null,
    "model": "qwen-plus",
    "id": "chatcmpl-39799876-eda8-9527-9e14-2214d641cf9a"
}

DashScope HTTP

この例の URL ではシンガポール リージョンを使用しています。

  • 米国 (バージニア) リージョンを使用する場合は、URL を https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation に置き換えてください。

  • 中国 (北京) リージョンを使用する場合は、URL を https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation に置き換えてください。

API リクエストを送信します。

Windows

コマンドプロンプトで次のコマンドを実行します。

# ======= 重要なお知らせ =======
# シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
# 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
# - シンガポール:https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - 米国 (バージニア):https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - 中国 (北京):https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === 実行前にこのコメントを削除してください ===

curl -X POST "https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation" \
-H "Authorization: Bearer %DASHSCOPE_API_KEY%" \
-H "Content-Type: application/json" \
-d "{
  \"model\": \"qwen-plus\",
  \"input\": {
    \"messages\": [
      {
        \"role\": \"system\",
        \"content\": \"You are a helpful assistant.\"
      },
      {
        \"role\": \"user\",
        \"content\": \"Who are you?\"
      }
    ]
  },
  \"parameters\": {
    \"result_format\": \"message\"
  }
}"

Linux および macOS

ターミナルで次のコマンドを実行します。

# ======= 重要なお知らせ =======
# シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
# 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
# - シンガポール:https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - 米国 (バージニア):https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - 中国 (北京):https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === 実行前にこのコメントを削除してください ===

curl -X POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "input":{
        "messages":[      
            {
                "role": "system",
                "content": "You are a helpful assistant."
            },
            {
                "role": "user",
                "content": "Who are you?"
            }
        ]
    },
    "parameters": {
        "result_format":"message"
    }
}'

API リクエストを送信した後、次の応答が返されます。

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": "私は Alibaba Cloud の大規模言語モデルです。私の名前は Qwen です。"
                }
            }
        ]
    },
    "usage": {
        "total_tokens": 38,
        "output_tokens": 16,
        "input_tokens": 22
    },
    "request_id": "87f776d7-3c82-9d39-b238-d1ad38c9b6a9"
}

その他の言語

モデル API の呼び出し

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"log"
	"net/http"
	"os"
)

type Message struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}
type RequestBody struct {
	Model    string    `json:"model"`
	Messages []Message `json:"messages"`
}

func main() {
	// HTTP クライアントを作成
	client := &http.Client{}
	// リクエストボディを構築
	requestBody := RequestBody{
		// モデル一覧:https://www.alibabacloud.com/help/model-studio/getting-started/models
		Model: "qwen-plus",
		Messages: []Message{
			{
				Role:    "system",
				Content: "You are a helpful assistant.",
			},
			{
				Role:    "user",
				Content: "Who are you?",
			},
		},
	}
	jsonData, err := json.Marshal(requestBody)
	if err != nil {
		log.Fatal(err)
	}
	// POST リクエストを作成。注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
        // - シンガポール:https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
        // - 米国 (バージニア):https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
        // - 中国 (北京):https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
	req, err := http.NewRequest("POST", "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions", bytes.NewBuffer(jsonData))
	if err != nil {
		log.Fatal(err)
	}
	// リクエストヘッダーを設定
	// シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
	// 環境変数が設定されていない場合は、apiKey := "sk-xxx" に置き換えます。
	apiKey := os.Getenv("DASHSCOPE_API_KEY")
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")
	// リクエストを送信
	resp, err := client.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer resp.Body.Close()
	// 応答ボディを読み取り
	bodyText, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}
	// 応答を出力
	fmt.Printf("%s\n", bodyText)
}
<?php
// 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
// - シンガポール:https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
// - 米国 (バージニア):https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
// - 中国 (北京):https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
$url = 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions';
// シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
// 環境変数が設定されていない場合は、$apiKey = "sk-xxx" に置き換えます。
$apiKey = getenv('DASHSCOPE_API_KEY');
// リクエストヘッダーを設定
$headers = [
    'Authorization: Bearer '.$apiKey,
    'Content-Type: application/json'
];
// リクエストボディを設定
$data = [
    "model" => "qwen-plus",
    "messages" => [
        [
            "role" => "system",
            "content" => "You are a helpful assistant."
        ],
        [
            "role" => "user",
            "content" => "Who are you?"
        ]
    ]
];
// cURL セッションを初期化
$ch = curl_init();
// cURL オプションを設定
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
// cURL セッションを実行
$response = curl_exec($ch);
// エラーを確認
if (curl_errno($ch)) {
    echo 'Curl エラー: ' . curl_error($ch);
}
// cURL リソースを閉じる
curl_close($ch);
// 応答を出力
echo $response;
?>
using System.Net.Http.Headers;
using System.Text;

class Program
{
    private static readonly HttpClient httpClient = new HttpClient();

    static async Task Main(string[] args)
    {
        // シンガポール、米国 (バージニア)、および中国 (北京) の API キーは相互に交換できません。API キーの取得方法:https://www.alibabacloud.com/help/model-studio/get-api-key
        // 環境変数が設定されていない場合は、string? apiKey = "sk-xxx" に置き換えます。
        string? apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY");

        if (string.IsNullOrEmpty(apiKey))
        {
            Console.WriteLine("API キーが設定されていません。'DASHSCOPE_API_KEY' 環境変数が設定されていることを確認してください。");
            return;
        }
        // 注:ベース URL はリージョン間で交換できません。この例ではシンガポールを使用しています。
        // - シンガポール:https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
        // - 米国 (バージニア):https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
        // - 中国 (北京):https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
        string url = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions";
        // モデル一覧:https://www.alibabacloud.com/help/model-studio/getting-started/models
        string jsonContent = @"{
            ""model"": ""qwen-plus"",
            ""messages"": [
                {
                    ""role"": ""system"",
                    ""content"": ""You are a helpful assistant.""
                },
                {
                    ""role"": ""user"", 
                    ""content"": ""Who are you?""
                }
            ]
        }";

        // リクエストを送信し、応答を取得
        string result = await SendPostRequestAsync(url, jsonContent, apiKey);

        // 結果を出力
        Console.WriteLine(result);
    }

    private static async Task<string> SendPostRequestAsync(string url, string jsonContent, string apiKey)
    {
        using (var content = new StringContent(jsonContent, Encoding.UTF8, "application/json"))
        {
            // リクエストヘッダーを設定
            httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
            httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

            // リクエストを送信し、応答を取得
            HttpResponseMessage response = await httpClient.PostAsync(url, content);

            // 応答を処理
            if (response.IsSuccessStatusCode)
            {
                return await response.Content.ReadAsStringAsync();
            }
            else
            {
                return $"リクエストに失敗しました: {response.StatusCode}";
            }
        }
    }
}

API リファレンス

よくある質問

モデル API の呼び出し後に Model.AccessDenied エラーを修正する方法

A: このエラーは、サブワークスペースの API キーを使用しているために発生します。サブワークスペースは、デフォルトワークスペース のアプリケーションまたはモデルにアクセスできません。サブワークスペースの API キーを使用するには、ルートアカウント管理者が対応するサブワークスペースにモデルの権限付与を行う必要があります (例: このトピックでは Qwen-Plus モデルを使用します)。詳細な手順については、「モデル呼び出しの権限設定」をご参照ください。

次のステップ

他のモデルを試す

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

高度な機能について

サンプルコードは基本的な Q&A のみを対象としています。ストリーミング出力構造化出力関数呼び出しなど、Qwen API の詳細については、「テキスト生成モデルの概要」をご参照ください。

ブラウザでモデルを試す

Qwen Chat のように ダイアログボックス を通じてモデルと対話したい場合は、プレイグラウンド (シンガポール米国 (バージニア)中国 (北京)中国 (香港)、または ドイツ (フランクフルト)) にアクセスしてください。