All Products
Search
Document Center

Alibaba Cloud Model Studio:Make your first API call to Qwen

Last Updated:Mar 15, 2026

Model Studio provides API access to models through OpenAI-compatible interfaces and the DashScope SDK.

This topic guides you through calling the Qwen API. You'll learn how to:

  • Get an API key

  • Set up your local development environment

  • Call the Qwen API

Account setup

  1. Create an account: If you don't have an Alibaba Cloud account, create one.

    If you encounter issues, see Register an Alibaba Cloud account.
  2. Activate Model Studio: Use your Alibaba Cloud account to go to Alibaba Cloud Model Studio. Read and accept the Terms of Service to activate the service. If no Terms of Service dialog appears, the service is already activated.

  3. Get an API key: Go to the Key Management page and click Create API key. Then use the API key to call models.

Set your API key as an environment variable

Store your API key in an environment variable to avoid hardcoding credentials and reduce security risks.

Steps

Linux

Add permanent environment variable

If you want the API key environment variable to persist across all new sessions for the current user, add it as a permanent environment variable.

  1. Run the following command to add the environment variable to the ~/.bashrc file.

    # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
    echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc

    Alternatively, you can manually modify the ~/.bashrc file.

    Edit manually

    Run the following command to open the ~/.bashrc file.

    nano ~/.bashrc

    Add the following content to the configuration file.

    # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

    In the nano editor, press Ctrl + X, then press Y, and then press Enter to save and close the file.

  2. Run the following command to make the changes take effect.

    source ~/.bashrc
  3. Open another terminal window and run the following command to check whether the environment variable takes effect.

    echo $DASHSCOPE_API_KEY

Add temporary environment variable

If you want to use the environment variable only in the current session, add it as a temporary environment variable.

  1. Run the following command.

    # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Run the following command to check whether the environment variable takes effect.

    echo $DASHSCOPE_API_KEY

macOS

Add permanent environment variable

If you want the API key environment variable to persist across all new sessions for the current user, add it as a permanent environment variable.

  1. Run the following command in the terminal to view the default shell type.

    echo $SHELL
  2. Follow the steps that correspond to your default shell type.

    Zsh
    1. Run the following command to add the environment variable to the ~/.zshrc file.

      # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc

      Alternatively, you can manually modify the ~/.zshrc file.

      Edit manually

      Run the following command to open the shell configuration file.

      nano ~/.zshrc

      Add the following content to the configuration file.

      # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      In the nano editor, press Ctrl + X, then press Y, and then press Enter to save and close the file.

    2. Run the following command to make the changes take effect.

      source ~/.zshrc
    3. Open another terminal window and run the following command to check whether the environment variable takes effect.

      echo $DASHSCOPE_API_KEY
    Bash
    1. Run the following command to add the environment variable to the ~/.bash_profile file.

      # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile

      Alternatively, you can manually modify the ~/.bash_profile file.

      Edit manually

      Run the following command to open the shell configuration file.

      nano ~/.bash_profile

      Add the following content to the configuration file.

      # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      To save and close the file in the nano editor, press Ctrl+X, then Y, and then Enter.

    2. Run the following command to make the changes take effect.

      source ~/.bash_profile
    3. Open another terminal window and run the following command to check whether the environment variable takes effect.

      echo $DASHSCOPE_API_KEY

Add temporary environment variable

If you want to use the environment variable only in the current session, add it as a temporary environment variable.

The following commands apply to Zsh and Bash.
  1. Run the following command.

    # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Run the following command to check whether the environment variable takes effect.

    echo $DASHSCOPE_API_KEY

Windows

In Windows, you can configure environment variables using System Properties, CMD, or PowerShell.

System properties

Note
  • An environment variable configured using this method is permanent.

  • You must have administrator permissions to modify system environment variables.

  • After you configure the environment variable, the change does not take effect immediately in open command windows, Integrated Development Environments (IDEs), or other running applications. You must restart these programs or open a new command line window for the environment variable to take effect.

  1. On the Windows desktop, press Win+Q, search for Edit the system environment variables in the search box, and open the System Properties window.

  2. In the System Properties window, click Environment Variables. Then, in the System variables area, click New. Set Variable name to DASHSCOPE_API_KEY and Variable value to your DashScope API key.

    image

  3. Click OK in all three open windows to save the changes and complete the environment variable configuration.

  4. Open a CMD window or a Windows PowerShell window and run the following command to check whether the environment variable takes effect.

    • CMD query command:

      echo %DASHSCOPE_API_KEY%

      image

    • Windows PowerShell query command:

      echo $env:DASHSCOPE_API_KEY

      image

CMD

Add permanent environment variable

If you want the API key environment variable to persist across all new sessions for the current user, you can perform the following steps.

  1. Run the following command in the Command Prompt.

    # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
    setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"
  2. Open a new Command Prompt window.

  3. Run the following command in the new Command Prompt window to check whether the environment variable takes effect.

    echo %DASHSCOPE_API_KEY%

    image

Add temporary environment variable

If you want to use the environment variable only in the current session, you can run the following command in the Command Prompt.

# Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
set DASHSCOPE_API_KEY=YOUR_DASHSCOPE_API_KEY

You can run the following command in the current session to check whether the environment variable takes effect.

echo %DASHSCOPE_API_KEY%

image

PowerShell

Add permanent environment variable

If you want the API key environment variable to persist across all new sessions for the current user, you can perform the following steps.

  1. Run the following command in PowerShell.

    # Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
    [Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
  2. Open a new PowerShell window.

  3. Run the following command in the new PowerShell window to check whether the environment variable takes effect.

    echo $env:DASHSCOPE_API_KEY

    image

Add temporary environment variable

If you want to use the environment variable only in the current session, you can run the following command in PowerShell.

# Replace YOUR_DASHSCOPE_API_KEY with your Alibaba Cloud Model Studio API key.
$env:DASHSCOPE_API_KEY = "YOUR_DASHSCOPE_API_KEY"

You can run the following command in the current session to check whether the environment variable takes effect.

echo $env:DASHSCOPE_API_KEY

image

Choose a development language

Select a language or tool to call model APIs.

Python

Step 1: Set up Python

Check Python version

Check whether Python and pip are installed:

Python 3.8 or later is required. For installation instructions, see Install Python.

python -V
pip --version

For example, on Windows Command Prompt:

image

FAQ

Q: The commands python -V and pip --version return errors:

  • 'python' is not recognized as an internal or external command, operable program or batch file.

  • 'pip' is not recognized as an internal or external command, operable program or batch file.

  • -bash: python: command not found

  • -bash: pip: command not found

Try these solutions:

Windows
  1. Confirm that you installed Python by following Install Python, and added python.exe to the PATH environment variable.image

  2. If Python and PATH are correctly configured but the error persists, close your current terminal and open a new one.

Linux and macOS

  1. Confirm that you installed Python by following Install Python.

  2. If Python is installed but the error persists, run which python pip to check whether python and pip exist in your system.

    • If this result appears, close the current terminal window, open a new terminal window, and try again.

      /usr/bin/python
      /usr/bin/pip
    • If this result is returned, run the which python3 pip3 query again.

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

      If the returned result is shown, use python3 -V and pip3 --version to check the version.

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

Set up a virtual environment (Optional)

Create a virtual environment to avoid dependency conflicts with other projects.

  1. Create a virtual environment

    Create a virtual environment named .venv:

    # If this fails, replace python with python3
    python -m venv .venv
  2. Activate the virtual environment

    On Windows, activate the virtual environment:

    .venv\Scripts\activate

    On macOS or Linux, run:

    source .venv/bin/activate

Install the OpenAI Python SDK or DashScope Python SDK

Call Model Studio models using the OpenAI or DashScope Python SDK.

Install the OpenAI Python SDK

Install or upgrade the OpenAI Python SDK:

# If this fails, replace pip with pip3
pip install -U openai

image

Look for Successfully installed ... openai-x.x.x to confirm installation.

Install the DashScope Python SDK

Install or upgrade the DashScope Python SDK:

# If this fails, replace pip with pip3
pip install -U dashscope

image

Look for Successfully installed ... dashscope-x.x.x to confirm installation.

Step 2: Call the API

OpenAI Python SDK

Send an API request:

  1. Create a file named hello_qwen.py.

  2. Copy this code into hello_qwen.py and save it.

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # If the environment variable is not configured, replace with: 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"Error message: {e}")
        print("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
  3. Run python hello_qwen.py or python3 hello_qwen.py from the command line.

    If you see No such file or directory, specify the full path to the file.

    The output is:

    I am a large-scale language model developed by Alibaba Cloud. My name is Qwen.

DashScope Python SDK

If you installed Python and the DashScope Python SDK, follow these steps to send an API request.

  1. Create a file named hello_qwen.py.

  2. Copy this code into hello_qwen.py and save it.

    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(
        # Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
        # If the environment variable is not configured, replace with: 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 status code: {response.status_code}")
        print(f"Error code: {response.code}")
        print(f"Error message: {response.message}")
        print("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code")
  3. Run python hello_qwen.py or python3 hello_qwen.py from the command line.

    Note

    Run this command from the directory containing hello_qwen.py. To run it from any location, specify the full path to the file.

    The output is:

    I am a large-scale language model from Alibaba Cloud. My name is Qwen.

Node.js

Step 1: Set up your Node.js environment

Check your Node.js installation

Check whether Node.js and npm are installed:

node -v
npm -v

For example, on Windows Command Prompt:

image

If Node.js is not installed, download it from the Node.js official website.

Install the model calling SDK

Run this command in your terminal:

npm install --save openai
# Or
yarn add openai
Note

If installation fails, configure a registry mirror:

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

After configuring the mirror, rerun the SDK installation command.

image

Look for added xx package in xxs to confirm installation. Check version: npm list openai.

Step 2: Call the model API

  1. Create a file named hello_qwen.mjs.

  2. Copy this code into the file.

    import OpenAI from "openai";
    
    try {
        const openai = new OpenAI(
            {
                // Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
                // If the environment variable is not configured, replace with: apiKey: "sk-xxx"
                apiKey: process.env.DASHSCOPE_API_KEY,
                // Note: Base URLs are not interchangeable across regions. This example uses Singapore.
                // - Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
                // - US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1
                // - China (Beijing): 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 message: ${error}`);
        console.log("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code");
    }
  3. Send the API request:

    node hello_qwen.mjs
    Note
    • Run this command from the directory containing hello_qwen.mjs. To run it from any location, specify the full path to the file.

    • Ensure the SDK is installed in the same directory as hello_qwen.mjs. If they are in different directories, you will see Cannot find package 'openai' imported from xxx.

    After successful execution, you will see the output:

    I am a language model from Alibaba Cloud. My name is Qwen.

Java

Step 1: Set up your Java environment

Check your Java version

Run this command in your terminal:

java -version
# (Optional) If you use Maven to manage and build Java projects, ensure Maven is installed
mvn --version

For example, on Windows Command Prompt:

image

Java 8 or later is required for the DashScope Java SDK. For example, openjdk version "16.0.1" 2021-04-20 means Java 16. If Java is not installed or the version is below Java 8, download and install it from Java downloads.

Install the model calling SDK

Install the DashScope Java SDK. For the latest version, see DashScope Java SDK. Add the SDK dependency, replacing the-latest-version with the latest version number.

XML

  1. Open your Maven project's pom.xml file.

  2. Add this dependency to the <dependencies> tag:

    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>dashscope-sdk-java</artifactId>
        <!-- Replace 'the-latest-version' with the latest version number: https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
        <version>the-latest-version</version>
    </dependency>
  3. Save the pom.xml file.

  4. Run a Maven command such as mvn compile or mvn clean install to update dependencies. Maven will automatically download and add the DashScope Java SDK to your project.

For example, in IntelliJ IDEA on Windows:

image

Gradle

  1. Open your Gradle project's build.gradle file.

  2. Add this dependency to the dependencies block:

    dependencies {
        // Replace 'the-latest-version' with the latest version number: https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java
        implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: 'the-latest-version'
    }
  3. Save the build.gradle file.

  4. In your terminal, navigate to your project root directory and run this Gradle command to update dependencies. It will automatically download and add the DashScope Java SDK to your project.

    ./gradlew build --refresh-dependencies

For example, in IntelliJ IDEA on Windows:

image

Step 2: Call the API

Run this code to call the model 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 {
        // Note: Base URLs are not interchangeable across regions. This example uses Singapore.
        // - Singapore: https://dashscope-intl.aliyuncs.com/api/v1
        // - US (Virginia): https://dashscope-us.aliyuncs.com/api/v1
        // - China (Beijing): 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()
                // Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
                // If the environment variable is not configured, replace with: .apiKey("sk-xxx")
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Model list: 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("Error message: "+e.getMessage());
            System.out.println("See: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code");
        }
        System.exit(0);
    }
}

The output is:

I am a large-scale language model developed by Alibaba Cloud. My name is Qwen.

curl

You can call models on Model Studio using either OpenAI-compatible HTTP endpoints or DashScope HTTP endpoints. For a list of models, see Model list.

Note

If DASHSCOPE_API_KEY isn't set, replace -H "Authorization: Bearer $DASHSCOPE_API_KEY" with -H "Authorization: Bearer sk-xxx".

OpenAI-compatible HTTP

The URL in this example uses the Singapore region. If you use the China (Beijing) region, replace the URL with https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions.

Send the API request:

Windows

Run this command in Command Prompt:

# ======= Important notice =======
# Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
# Note: Base URLs are not interchangeable across regions. This example uses Singapore.
# - Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
# - US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
# - China (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === Delete this comment before running ===

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

Run this command in Terminal:

# ======= Important notice =======
# Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
# Note: Base URLs are not interchangeable across regions. This example uses Singapore.
# - Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
# - US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
# - China (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === Delete this comment before running ===

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?"
        }
    ]
}'

After sending the API request, you receive this response:

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "I am a large-scale language model from Alibaba Cloud. My name is 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

The URL in this example uses the Singapore region.

  • If you use the US (Virginia) region, replace the URL with https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation.

  • If you use the China (Beijing) region, replace the URL with https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation.

Send the API request:

Windows

Run this command in Command Prompt:

# ======= Important notice =======
# Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
# Note: Base URLs are not interchangeable across regions. This example uses Singapore.
# - Singapore: https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - US (Virginia): https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - China (Beijing): https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === Delete this comment before running ===

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

Run this command in Terminal:

# ======= Important notice =======
# Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
# Note: Base URLs are not interchangeable across regions. This example uses Singapore.
# - Singapore: https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - US (Virginia): https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - China (Beijing): https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === Delete this comment before running ===

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"
    }
}'

After sending the API request, you receive this response:

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": "I am a large-scale language model from Alibaba Cloud. My name is Qwen."
                }
            }
        ]
    },
    "usage": {
        "total_tokens": 38,
        "output_tokens": 16,
        "input_tokens": 22
    },
    "request_id": "87f776d7-3c82-9d39-b238-d1ad38c9b6a9"
}

Other languages

Call the model 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() {
	// Create an HTTP client
	client := &http.Client{}
	// Build the request body
	requestBody := RequestBody{
		// Model list: 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)
	}
	// Create a POST request. Note: Base URLs are not interchangeable across regions. This example uses Singapore.
        // - Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
        // - US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
        // - China (Beijing): 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)
	}
	// Set request headers
	// Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
	// If the environment variable is not configured, replace with: apiKey := "sk-xxx"
	apiKey := os.Getenv("DASHSCOPE_API_KEY")
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")
	// Send the request
	resp, err := client.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer resp.Body.Close()
	// Read the response body
	bodyText, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}
	// Print the response
	fmt.Printf("%s\n", bodyText)
}
<?php
// Note: Base URLs are not interchangeable across regions. This example uses Singapore.
// - Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
// - US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
// - China (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
$url = 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions';
// Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
// If the environment variable is not configured, replace with: $apiKey = "sk-xxx"
$apiKey = getenv('DASHSCOPE_API_KEY');
// Set request headers
$headers = [
    'Authorization: Bearer '.$apiKey,
    'Content-Type: application/json'
];
// Set request body
$data = [
    "model" => "qwen-plus",
    "messages" => [
        [
            "role" => "system",
            "content" => "You are a helpful assistant."
        ],
        [
            "role" => "user",
            "content" => "Who are you?"
        ]
    ]
];
// Initialize a cURL session
$ch = curl_init();
// Set cURL options
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);
// Execute the cURL session
$response = curl_exec($ch);
// Check for errors
if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
}
// Close the cURL resource
curl_close($ch);
// Output the response
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)
    {
        // Singapore, US (Virginia), and China (Beijing) API keys are not interchangeable. Get your API key: https://www.alibabacloud.com/help/model-studio/get-api-key
        // If the environment variable is not configured, replace with: string? apiKey = "sk-xxx"
        string? apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY");

        if (string.IsNullOrEmpty(apiKey))
        {
            Console.WriteLine("API Key not set. Make sure the 'DASHSCOPE_API_KEY' environment variable is set.");
            return;
        }
        // Note: Base URLs are not interchangeable across regions. This example uses Singapore.
        // - Singapore: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
        // - US (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
        // - China (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
        string url = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions";
        // Model list: 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?""
                }
            ]
        }";

        // Send the request and get the response
        string result = await SendPostRequestAsync(url, jsonContent, apiKey);

        // Output the result
        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"))
        {
            // Set request headers
            httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
            httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

            // Send the request and get the response
            HttpResponseMessage response = await httpClient.PostAsync(url, content);

            // Handle the response
            if (response.IsSuccessStatusCode)
            {
                return await response.Content.ReadAsStringAsync();
            }
            else
            {
                return $"Request failed: {response.StatusCode}";
            }
        }
    }
}

API reference

FAQ

How do I fix the Model.AccessDenied error after calling the model API?

A: This error occurs when you use an API key from a sub-workspace. A sub-workspace cannot access applications or models in the default workspace. Use your Alibaba Cloud account to authorize the sub-workspace, see Permissions.

Next steps

Explore more models

The example code uses qwen-plus. Model Studio also supports other Qwen models. See the Model list for supported models and their API references.

Learn advanced features

The example code covers basic Q&A only. To learn more about the Qwen API, such as streaming output, structured output, and function calling, see Text generation model overview.

Try models in the browser

If you want to interact with models through a dialog box, like on Qwen Chat, go to the Playground (Singapore, US (Virginia), or China (Beijing)).