Alibaba Cloud SDK:Windows で Java 開発環境を構築する

1. 呼び出しを行う前に、アクセス資格情報として AccessKey ペアを取得する必要があります。Resource Access Management (RAM) ユーザーの AccessKey ペアを使用することをお勧めします。詳細については、「AccessKey ペアを作成する」をご参照ください。

   重要

   RAM ユーザーの AccessKey ペアを取得したら、環境変数で AccessKey ペアを指定する必要があります。詳細については、「Linux、macOS、および Windows で環境変数を構成する」をご参照ください。

2. SDK センター にログインし、使用するサービス (Elastic Compute Service (ECS) の DescribeInstanceTypeFamilies API 操作など) を選択します。

3. ページ中央の [ パラメーター ] タブで、必須パラメーターを構成します。右側の [ ドキュメント ] タブを参照して、操作の説明と使用上の注意 (特に課金ルール)、および各パラメーターの定義と使用方法を確認できます。たとえば、DescribeInstanceTypeFamilies 操作は 2 つのパラメーターをサポートしており、RegionId パラメーターは必須で、中国 (青島) リージョンを示す cn-qingdao を入力できます。Generation パラメーターはオプションで、シリーズ V インスタンスファミリーを示す ecs-5 を入力できます。詳細なパラメーター値は、右側の [ ドキュメント ] タブで確認できます。例に示されている形式でパラメーター値を入力します。

4. ページ右側の [ SDK サンプルコード ] タブで、[ Java ] 言語を選択し、[ プロジェクトのダウンロード ] をクリックして完全な SDK プロジェクトをローカルマシンにダウンロードし、プロジェクトを解凍します。

5. サンプルコード:

   import com.aliyun.ecs20140526.Client;
   import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesRequest;
   import com.aliyun.ecs20140526.models.DescribeInstanceTypeFamiliesResponse;
   import com.aliyun.tea.TeaException;
   import com.aliyun.teaopenapi.models.Config;
   import com.google.gson.Gson;
   
   public class Sample {
       public static void main(String[] args) {
           try {
               Config config = new Config()
                       // System.getenv は、キーが環境変数から取得されることを示します。
                       .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                       .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
               config.endpoint = "ecs-cn-hangzhou.aliyuncs.com";
               Client client = new Client(config);
               DescribeInstanceTypeFamiliesRequest describeInstanceTypeFamiliesRequest = new DescribeInstanceTypeFamiliesRequest();
               describeInstanceTypeFamiliesRequest.setRegionId("cn-qingdao");
               describeInstanceTypeFamiliesRequest.setGeneration("ecs-5");
               DescribeInstanceTypeFamiliesResponse describeInstanceTypeFamiliesResponse = client.describeInstanceTypeFamilies(describeInstanceTypeFamiliesRequest);
               System.out.println(new Gson().toJson(describeInstanceTypeFamiliesResponse));
           } catch (TeaException teaException) {
               // エラーコードを表示します。
               System.out.println(teaException.getCode());
               // リクエスト ID を含むエラーメッセージを表示します。
               System.out.println(teaException.getMessage());
               // サーバーから返された詳細なエラー情報を表示します。
               System.out.println(teaException.getData());
           } catch (Exception e) {
               TeaException error = new TeaException(e.getMessage(), e);
               // エラーメッセージ。
               System.out.println(error.getMessage());
               // トラブルシューティング用の URL。
               System.out.println(error.getData().get("Recommend"));
               com.aliyun.teautil.Common.assertAsString(error.message);
           }
       }
   }
   

6. 期待される結果:

7. Alibaba Cloud SDK for Java を使用して Alibaba Cloud API を呼び出す方法の詳細については、「IDE で Alibaba Cloud SDK for Java を使用する」をご参照ください。

1. Alibaba Cloud Model Studio では、API を呼び出すことによって大規模モデルを使用できます。API は、API Explorer または DashScope SDK を介して呼び出すことができます。サービスを呼び出す前に、Alibaba Cloud Model Studio をアクティブ化し、API キーを取得する必要があります。詳細については、Qwen への最初の API 呼び出しを行う の「アカウントの管理」セクションをご参照ください。

   重要

   API キーを取得したら、API キーの漏洩を防ぐために、環境変数で API キーを指定します。コードで API キーを公開しないでください。詳細については、Qwen への最初の API 呼び出しを行う の「API キーを環境変数に設定する」セクションをご参照ください。

2. SDK for Java をインストールするには、pom.xml ファイルに次の依存関係を追加します。

   <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. Java と SDK for Java をインストールしたら、次のサンプルコードを実行して Qwen API を呼び出すことができます。

   package org.example.nlp.ai;
   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;
   public class Sample {
       public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
           Generation gen = new Generation();
           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()
                   // System.getenv は、API キーが環境変数から取得されることを示します。環境変数が構成されていない場合は、次の行を Alibaba Cloud Model Studio API キーを使用して api_key="sk-xxx" に置き換えます。
                   .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                   .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("Error message:"+e.getMessage());
           }
           System.exit(0);
       }
   }
   
   

4. 期待される出力:

5. Qwen API の呼び出し方法の詳細については、OpenAI JavQwen への最初の API 呼び出しを行うa SDK の「開発言語を選択する」セクションの [ Java ] タブをご参照ください。

このセクションでは、Alibaba Cloud Model Studio プラットフォームで API 操作を使用して DeepSeek モデルを呼び出す方法について説明します。 deepseek-r1 と deepseek-v3 は、100 万の無料トークンを提供します。一部の蒸留モデルは、期間限定で無料です。

1. サービスを呼び出す前に、Alibaba Cloud Model Studio をアクティブ化し、API キーを取得する必要があります。詳細については、Qwen への最初の API 呼び出しを行う の「アカウントの管理」セクションをご参照ください。

   重要

   API キーを取得したら、API キーの漏洩を防ぐために、環境変数で API キーを指定します。コードで API キーを公開しないでください。詳細については、Qwen への最初の API 呼び出しを行う の「API キーを環境変数に設定する」セクションをご参照ください。

2. SDK for Java をインストールするには、pom.xml ファイルに次の依存関係を追加します。

   <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>

   重要

   DashScope SDK のバージョンは 2.18.2 以降である必要があります。

3. Java と SDK for Java をインストールしたら、次のサンプルコードを実行して DeepSeek モデルサービスを呼び出すことができます。

   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;
   
   
   public class Sample {
       public static GenerationResult callWithMessage() throws ApiException, NoApiKeyException, InputRequiredException {
           Generation gen = new Generation();
           Message userMsg = Message.builder()
                   .role(Role.USER.getValue())
                   .content("Which is larger, 9.9 or 9.11?")
                   .build();
           GenerationParam param = GenerationParam.builder()
                   // 環境変数が構成されていない場合は、次の行を Alibaba Cloud Model Studio API キーを使用して .apiKey("sk-xxx") に置き換えます。
                   .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                   .model("deepseek-r1")
                   .messages(Arrays.asList(userMsg))
                   // 値を text に設定しないでください。
                   .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                   .build();
           return gen.call(param);
       }
       public static void main(String[] args) {
           try {
               GenerationResult result = callWithMessage();
               System.out.println("Thinking process:");
               System.out.println(result.getOutput().getChoices().get(0).getMessage().getReasoningContent());
               System.out.println("Final answer:");
               System.out.println(result.getOutput().getChoices().get(0).getMessage().getContent());
           } catch (ApiException | NoApiKeyException | InputRequiredException e) {
               // ロギングフレームワークを使用して例外情報を記録します。
               System.err.println("An error occurred while calling the generation service: " + e.getMessage());
           }
           System.exit(0);
       }
   }
   
   

4. 期待される出力: