Alibaba Cloud SDK:Windows üzerinde Java geliştirme ortamı kurma

1. API çağrısı yapmak için öncelikle erişim kimlik bilgileriniz olarak kullanacağınız bir AccessKey çifti edinmeniz gerekir. Bir RAM kullanıcısının AccessKey çiftini kullanmanızı öneririz. Daha fazla bilgi için bkz. RAM kullanıcısı için AccessKey çifti oluşturma.

   Önemli

   AccessKey çiftini edindikten sonra bunu bir ortam değişkeni olarak yapılandırın. Daha fazla bilgi için bkz. Linux, macOS ve Windows'ta ortam değişkenlerini yapılandırma.

2. SDK Center adresine gidin ve kullanmak istediğiniz ürünü seçin. Bu örnekte ECS'nin DescribeInstanceTypeFamilies API'si kullanılmaktadır.

3. Parameters sekmesinde parametreleri yapılandırın. API açıklaması, kullanım notları (özellikle faturalama bilgileri) ve her bir parametrenin anlamı ve kullanımıyla ilgili ayrıntılar için sağ taraftaki Document sekmesine bakın. Örneğin, DescribeInstanceTypeFamilies API'sini kullanırken zorunlu RegionId parametresini Çin (Qingdao) için cn-qingdao olarak, isteğe bağlı Generation parametresini ise seri V örnek ailesi için ecs-5 olarak ayarlayın. Document sekmesi her bir istek parametresi için türü, zorunlu olup olmadığı ve örnek değerler gibi daha fazla ayrıntı sunar.

4. SDK Sample sekmesinde Java seçeneğini belirleyin ve SDK projesini indirip sıkıştırmadan çıkarmak için Download Project öğesini tıklayın.

5. Örnek kod:

   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 retrieves the key from an environment variable.
                       .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) {
               // Print the error code.
               System.out.println(teaException.getCode());
               // Print the error message, which includes the RequestId.
               System.out.println(teaException.getMessage());
               // Print the specific error content returned by the server.
               System.out.println(teaException.getData());
           } catch (Exception e) {
               TeaException error = new TeaException(e.getMessage(), e);
               // Error message.
               System.out.println(error.getMessage());
               // Diagnostic address.
               System.out.println(error.getData().get("Recommend"));
               com.aliyun.teautil.Common.assertAsString(error.message);
           }
       }
   }
             

6. Sonuç: Kodu çalıştırdıktan sonra API, başarılı bir çağrıyı gösteren 200 statusCode değeri döndürür. Yanıt gövdesi InstanceTypeFamilies alanında bir örnek aileleri listesi içerir. Aşağıdaki kod parçacığı yanıtın bir bölümünü göstermektedir:

   ...'statusCode': 200, 'body': {'InstanceTypeFamilies': {'InstanceTypeFamily': [{'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.g6'}, {'Generation': 'ecs-5', 'InstanceTypeFamilyId': 'ecs.ebmg6'}]}}

7. Alibaba Cloud OpenAPI'yi çağırmak için Java SDK'yı kullanma hakkında daha fazla bilgi için bkz. IDE'de Alibaba Cloud SDK for Java kullanma.

1. Alibaba Cloud Model Studio, API kullanarak büyük bir modeli çağırmanıza olanak tanır. OpenAI uyumlu API ve DashScope SDK dahil olmak üzere birden çok erişim yöntemi sunar. Hizmeti çağırmak için önce Alibaba Cloud Model Studio'yu etkinleştirin ve bir API anahtarı alın. Daha fazla bilgi için bkz. Hesap Ayarları.

   Önemli

   Bir API anahtarı edindikten sonra bunu bir ortam değişkeni olarak yapılandırın. Bu işlem, anahtarın uygulamanızda sabit kodlanmasını önleyerek sızıntı riskini azaltır. Talimatlar için bkz. API anahtarını ortam değişkeni olarak yapılandırma.

2. DashScope SDK for Java'yı yüklemek için pom.xml dosyanıza aşağıdaki bağımlılığı ekleyin:

   <dependency>
       <groupId>com.alibaba</groupId>
       <artifactId>dashscope-sdk-java</artifactId>
       <!-- Replace 'the-latest-version' with the latest version from https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
       <version>the-latest-version</version>
   </dependency>

3. Java ve DashScope SDK'larını yükledikten sonra Qwen API'yi çağırmak için aşağıdaki örnek kodu çalıştırın:

   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 retrieves the API key from an environment variable. If you have not configured the environment variable, replace the following line with .apiKey("sk-xxx") and use your API key from Alibaba Cloud Model Studio.
                   .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. Sonuç: Kodu çalıştırdıktan sonra aşağıdakine benzer bir çıktı görmeniz gerekir:

   15:44:00.413 [main] DEBUG com.alibaba.dashscope.protocol.okhttp.OkHttpClientFactory - [connectionPool Config] connectionPoolSize: 32
   15:44:00.468 [main] DEBUG com.alibaba.dashscope.protocol.okhttp.OkHttpClientFactory - [connectionPool Config] maxRequests: 32
   15:44:00.468 [main] DEBUG com.alibaba.dashscope.protocol.okhttp.OkHttpClientFactory - [connectionPool Config] maxRequestsPerHost: 32
   I am Qwen, a large language model developed by the Tongyi Lab at Alibaba Group. I can answer questions, create content such as stories, official documents, emails, scripts, and poems, and perform logical reasoning, programming, and even play games. I am proficient in multiple languages and can provide you with a wide range of assistance. If you have any questions or need to create content

5. Qwen API'yi çağırma hakkında daha fazla bilgi için bkz. DashScope SDK for Java kullanma.

Bu bölümde, Alibaba Cloud Model Studio platformunda API'ler kullanılarak DeepSeek modellerinin nasıl çağrılacağı açıklanmaktadır. deepseek-r1 ve deepseek-v3 modellerinin her biri 1 milyon ücretsiz token sağlar ve bazı distile edilmiş modeller sınırlı süreyle ücretsiz deneme için kullanılabilir.

1. Hizmeti çağırmak için önce Alibaba Cloud Model Studio'yu etkinleştirin ve bir API anahtarı alın. Daha fazla bilgi için bkz. Hesap Ayarları.

   Önemli

   Bir API anahtarı edindikten sonra bunu bir ortam değişkeni olarak yapılandırın. Bu işlem, anahtarın uygulamanızda sabit kodlanmasını önleyerek sızıntı riskini azaltır. Talimatlar için bkz. API anahtarını ortam değişkeni olarak yapılandırma.

2. DashScope SDK for Java'yı yüklemek için pom.xml dosyanıza aşağıdaki bağımlılığı ekleyin:

   <dependency>
       <groupId>com.alibaba</groupId>
       <artifactId>dashscope-sdk-java</artifactId>
       <!-- Replace 'the-latest-version' with the latest version from https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
       <version>the-latest-version</version>
   </dependency>

   Önemli

   DashScope SDK sürümü 2.18.2 veya üzeri olmalıdır.

3. Java ve DashScope SDK'larını yükledikten sonra DeepSeek model hizmetini çağırmak için aşağıdaki örnek kodu çalıştırın:

   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()
                   // If you have not configured an environment variable, replace the following line with .apiKey("sk-xxx") and use your API key from Alibaba Cloud Model Studio.
                   .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                   .model("deepseek-r1")
                   .messages(Arrays.asList(userMsg))
                   // Do not set this to "text".
                   .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                   .build();
           return gen.call(param);
       }
       public static void main(String[] args) {
           try {
               GenerationResult result = callWithMessage();
               System.out.println("Reasoning:");
               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) {
               // Use a logging framework to record exception information.
               System.err.println("An error occurred while calling the generation service: " + e.getMessage());
           }
           System.exit(0);
       }
   }
                   

4. Çıktıyı inceleyin.

   Reasoning:
   Hmm, the user is asking which is larger, 9.9 or 9.11. This looks simple, but it may need careful analysis, especially how the numbers are interpreted. First, I should confirm whether the user means decimals or something else, like version numbers or dates. But as a common math question, it should be a decimal comparison.
   First, I need to clarify the structure of these numbers. 9.9 is usually 9 plus 0.9, which is 9.90. 9.11 is 9 plus 0.11. The integer parts are both 9, so I compare the fractional parts: 0.90 and 0.11. Clearly, 0.90 is greater than 0.11, so 9.9 is larger than 9.11. However, a common confusion happens when the numbers are treated as version numbers, such as software versions.
   But the user may have a different context. If treated as a version number, 9.11 can mean version 9, update 11, while 9.9 means version 9, update 9, and then 9.11 is greater. So I may need to confirm the context, but as a standard decimal comparison, 9.9 is larger.
   Final answer:
   When comparing 9.9 and 9.11 as **decimal numbers**:
   - Treat 9.9 as 9.90, so the fractional part is 0.90.
   - The fractional part of 9.11 is 0.11.
   - Since **0.90 > 0.11**, **9.9 > 9.11**.
   If you mean **version numbers** (such as software versions):
   - 9.11 can mean the 11th update of version 9, while 9.9 is the 9th update, so **9.11 > 9.9**.
   **By default, as decimals, 9.9 is larger.**