All Products
Search
Document Center

Alibaba Cloud Model Studio:Lakukan panggilan API pertama Anda ke Qwen

Last Updated:Mar 25, 2026

Alibaba Cloud Model Studio mendukung panggilan API ke model melalui antarmuka yang kompatibel dengan OpenAI dan SDK DashScope.

Untuk memanggil API Qwen:

  • Dapatkan kunci API

  • Siapkan lingkungan pengembangan lokal Anda

  • Panggil API Qwen

Persiapan akun

  1. Buat akun: Jika Anda belum memiliki Akun Alibaba Cloud, buat satu.

    Jika mengalami kendala, lihat Daftar Akun Alibaba Cloud.
  2. Aktifkan Model Studio: Gunakan Akun Alibaba Cloud Anda untuk membuka Alibaba Cloud Model Studio. Baca dan terima Ketentuan Layanan untuk mengaktifkan layanan. Jika dialog Ketentuan Layanan tidak muncul, layanan telah diaktifkan.

  3. Dapatkan kunci API: Buka halaman Key Management dan klik Create API key. Lalu gunakan kunci API tersebut untuk memanggil model.

Atur kunci API Anda sebagai variabel lingkungan

Simpan kunci API Anda dalam variabel lingkungan untuk menghindari hardcoding kredensial dan mengurangi risiko keamanan.

Langkah-langkah

Linux

Variabel lingkungan permanen

Agar kunci API tersedia di semua sesi mendatang, ekspor secara permanen.

  1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.bashrc:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bashrc

    Anda juga dapat mengedit file ~/.bashrc secara manual.

    Edit secara manual

    Jalankan perintah berikut untuk membuka file ~/.bashrc .

    nano ~/.bashrc

    Tambahkan konten berikut ke file tersebut.

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

    Pada editor nano, tekan Ctrl+X lalu Y. Tekan Enter untuk menyimpan dan menutup file.

  2. Jalankan perintah berikut agar perubahan berlaku:

    source ~/.bashrc
  3. Buat sesi baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo $DASHSCOPE_API_KEY

Variabel lingkungan sementara

Untuk menggunakan kunci API hanya pada sesi saat ini, ekspor secara sementara.

  1. Jalankan perintah berikut:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo $DASHSCOPE_API_KEY

macOS

Variabel lingkungan permanen

Agar kunci API tersedia di semua sesi mendatang, ekspor secara permanen.

  1. Jalankan perintah berikut untuk memeriksa jenis Shell default.

    echo $SHELL
  2. Lakukan operasi berikut berdasarkan jenis Shell Anda.

    Zsh
    1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.zshrc.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.zshrc

      Anda juga dapat mengedit file ~/.zshrc secara manual.

      Edit secara manual

      Jalankan perintah berikut untuk membuka file konfigurasi.

      nano ~/.zshrc

      Tambahkan konten berikut ke file tersebut.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      Pada editor nano, tekan Ctrl+X lalu Y. Tekan Enter untuk menyimpan dan menutup file.

    2. Jalankan perintah berikut agar perubahan berlaku:

      source ~/.zshrc
    3. Buat sesi baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

      echo $DASHSCOPE_API_KEY
    Bash
    1. Jalankan perintah berikut untuk menambahkan variabel lingkungan ke file ~/.bash_profile.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile

      Anda juga dapat mengedit file ~/.bash_profile secara manual.

      Edit secara manual

      Jalankan perintah berikut untuk membuka file tersebut.

      nano ~/.bash_profile

      Tambahkan konten berikut ke file tersebut.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      Pada editor nano, tekan Ctrl+X lalu Y. Tekan Enter untuk menyimpan dan menutup file.

    2. Jalankan perintah berikut agar perubahan berlaku:

      source ~/.bash_profile
    3. Buat sesi baru dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

      echo $DASHSCOPE_API_KEY

Variabel lingkungan sementara

Untuk menggunakan kunci API hanya pada sesi saat ini, ekspor secara sementara.

Perintah berikut hanya berlaku untuk Zsh dan Bash.
  1. Jalankan perintah berikut:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo $DASHSCOPE_API_KEY

Windows

Di Windows, Anda dapat mengekspor variabel lingkungan menggunakan System Properties, Command Line, atau PowerShell.

System Properties

Catatan
  • Variabel lingkungan yang dikonfigurasi dengan cara ini berlaku secara permanen.

  • Memodifikasi variabel lingkungan sistem memerlukan izin administratif.

  • Setelah mengonfigurasi variabel lingkungan, perubahan tersebut tidak akan memengaruhi program yang sedang berjalan. Mulai ulang IDE dan jendela command, atau buka command line baru, untuk memuat variabel baru.

  1. Tekan Win+Q di desktop Anda. Masukkan "Edit the system environment variables" di kotak pencarian, lalu klik untuk membuka jendela System Properties.

  2. Di jendela System Properties, klik Environment Variables. Di bagian System Variables, klik New, masukkan DASHSCOPE_API_KEY sebagai nama variabel, dan kunci API aktual Anda sebagai nilai variabel.

    image

  3. Klik OK pada ketiga kotak dialog.

  4. Buka CMD atau Windows PowerShell dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku.

    • CMD:

      echo %DASHSCOPE_API_KEY%

      image

    • Windows PowerShell:

      echo $env:DASHSCOPE_API_KEY

      image

CMD

Variabel lingkungan permanen

Agar kunci API tersedia di semua sesi mendatang, ekspor secara permanen.

  1. Jalankan perintah berikut:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"
  2. Buat sesi baru.

  3. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo %DASHSCOPE_API_KEY%

    image

Variabel lingkungan sementara

Untuk menggunakan kunci API hanya pada sesi saat ini, ekspor secara sementara.

  1. Jalankan perintah berikut:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    set DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Jalankan perintah berikut pada sesi saat ini untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo %DASHSCOPE_API_KEY%

    image

PowerShell

Variabel lingkungan permanen

Agar kunci API tersedia di semua sesi mendatang, ekspor secara permanen.

  1. Jalankan perintah berikut:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    [Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
  2. Buat sesi baru.

  3. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo $env:DASHSCOPE_API_KEY

    image

Variabel lingkungan sementara

Untuk menggunakan kunci API hanya pada sesi saat ini, ekspor secara sementara.

  1. Jalankan perintah berikut:

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Anda.
    $env:DASHSCOPE_API_KEY = "YOUR_DASHSCOPE_API_KEY"
  2. Jalankan perintah berikut pada sesi saat ini untuk memeriksa apakah variabel lingkungan telah berlaku:

    echo $env:DASHSCOPE_API_KEY

    image

Pilih bahasa pengembangan

Pilih bahasa atau tool untuk memanggil API model.

Python

Langkah 1: Siapkan Python

Periksa versi Python Anda

Jalankan perintah ini untuk memeriksa apakah Python dan pip telah terinstal:

Diperlukan Python 3.8 atau versi lebih baru. Untuk instruksi instalasi, lihat Instal Python.

python -V
pip --version

Contohnya, pada Windows Command Prompt:

image

FAQ

T: Perintah python -V dan pip --version menghasilkan error:

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

Coba solusi berikut:

Windows
  1. Pastikan Anda telah menginstal Python sesuai petunjuk di Instal Python, dan menambahkan python.exe ke variabel lingkungan PATH.image

  2. Jika Python dan PATH telah dikonfigurasi dengan benar tetapi error masih muncul, tutup terminal saat ini dan buka yang baru.

Linux dan macOS

  1. Pastikan Anda telah menginstal Python sesuai petunjuk di Instal Python.

  2. Jika Python telah terinstal tetapi error masih muncul, jalankan which python pip untuk memeriksa apakah python dan pip ada di sistem Anda.

    • Jika hasil berikut muncul, tutup jendela terminal saat ini, buka jendela terminal baru, lalu coba lagi.

      /usr/bin/python
      /usr/bin/pip
    • Jika hasil berikut dikembalikan, jalankan kueri which python3 pip3 lagi.

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

      Jika hasil yang dikembalikan seperti di atas, gunakan python3 -V dan pip3 --version untuk memeriksa versi.

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

Siapkan lingkungan virtual (opsional)

Jika Python telah terinstal, Anda dapat membuat lingkungan virtual untuk menginstal OpenAI Python SDK atau DashScope Python SDK dan menghindari konflik dependensi.

  1. Buat lingkungan virtual

    Buat lingkungan virtual bernama .venv:

    # Jika gagal, ganti python dengan python3
    python -m venv .venv
  2. Aktifkan lingkungan virtual

    Pada Windows, aktifkan lingkungan virtual:

    .venv\Scripts\activate

    Pada macOS atau Linux, jalankan:

    source .venv/bin/activate

Instal OpenAI Python SDK atau DashScope Python SDK

Anda dapat memanggil model di Model Studio menggunakan OpenAI Python SDK atau DashScope Python SDK.

Instal OpenAI Python SDK

Instal atau perbarui OpenAI Python SDK:

# Jika gagal, ganti pip dengan pip3
pip install -U openai

image

Cari Successfully installed ... openai-x.x.x untuk mengonfirmasi instalasi.

Instal DashScope Python SDK

Instal atau perbarui DashScope Python SDK:

# Jika gagal, ganti pip dengan pip3
pip install -U dashscope

image

Cari Successfully installed ... dashscope-x.x.x untuk mengonfirmasi instalasi.

Langkah 2: Panggil API

OpenAI Python SDK

Dengan Python dan OpenAI Python SDK yang telah terinstal, kirim permintaan API pertama Anda.

  1. Buat file bernama hello_qwen.py.

  2. Salin kode ini ke hello_qwen.py dan simpan.

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # Jika variabel lingkungan belum dikonfigurasi, ganti dengan: 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. Jalankan python hello_qwen.py atau python3 hello_qwen.py dari command line.

    Jika Anda melihat No such file or directory, tentukan path lengkap ke file tersebut.

    Output-nya adalah:

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

DashScope Python SDK

Dengan Python dan DashScope Python SDK yang telah terinstal, kirim permintaan API pertama Anda.

  1. Buat file bernama hello_qwen.py.

  2. Salin kode ini ke hello_qwen.py dan simpan.

    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(
        # Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
        # Jika variabel lingkungan belum dikonfigurasi, ganti dengan: 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. Jalankan python hello_qwen.py atau python3 hello_qwen.py dari command line.

    Catatan

    Perintah dalam contoh ini harus dijalankan dari direktori yang berisi file Python. Untuk menjalankannya dari lokasi lain, tentukan path lengkapnya.

    Output-nya adalah:

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

Node.js

Langkah 1: Siapkan lingkungan Node.js Anda

Periksa instalasi Node.js Anda

Periksa apakah Node.js dan npm telah terinstal:

node -v
npm -v

Contohnya, pada Windows Command Prompt:

image

Ini akan mencetak versi Node.js Anda saat ini. Jika Node.js belum terinstal, unduh dari situs resmi Node.js.

Instal SDK pemanggilan model

Jalankan perintah ini di terminal Anda:

npm install --save openai
# Atau
yarn add openai
Catatan

Jika instalasi gagal, konfigurasikan mirror registri:

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

Setelah mengonfigurasi mirror, jalankan kembali perintah instalasi SDK.

image

Cari added xx package in xxs untuk mengonfirmasi instalasi. Periksa versi: npm list openai.

Langkah 2: Panggil API model

  1. Buat file bernama hello_qwen.mjs.

  2. Salin kode ini ke file tersebut.

    import OpenAI from "openai";
    
    try {
        const openai = new OpenAI(
            {
                // Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
                // Jika variabel lingkungan belum dikonfigurasi, ganti dengan: apiKey: "sk-xxx"
                apiKey: process.env.DASHSCOPE_API_KEY,
                // Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
                // - Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1
                // - AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1
                // - Tiongkok (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. Jalankan perintah ini untuk mengirim permintaan API.

    node hello_qwen.mjs
    Catatan
    • Jalankan perintah ini dari direktori yang berisi hello_qwen.mjs. Untuk menjalankannya dari lokasi mana pun, tentukan path lengkap ke file tersebut.

    • Pastikan SDK telah terinstal di direktori yang sama dengan hello_qwen.mjs. Jika berada di direktori berbeda, Anda akan melihat Cannot find package 'openai' imported from xxx.

    Setelah berhasil dijalankan, output-nya adalah:

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

Java

Langkah 1: Siapkan lingkungan Java Anda

Periksa versi Java Anda

Jalankan perintah ini di terminal Anda:

java -version
# (Opsional) Jika Anda menggunakan Maven untuk mengelola dan membangun proyek Java, pastikan Maven telah terinstal
mvn --version

Contohnya, pada Windows Command Prompt:

image

Diperlukan Java 8 atau versi lebih baru untuk DashScope Java SDK. Contohnya, openjdk version "16.0.1" 2021-04-20 berarti Java 16. Jika Java belum terinstal atau versinya di bawah Java 8, unduh dan instal dari Unduhan Java.

Instal SDK pemanggilan model

Instal DashScope Java SDK. Untuk versi terbaru, lihat DashScope Java SDK. Tambahkan dependensi ini, ganti the-latest-version dengan nomor versi terbaru.

XML

  1. Buka file pom.xml proyek Maven Anda.

  2. Tambahkan dependensi ini ke tag <dependencies>:

    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>dashscope-sdk-java</artifactId>
        <!-- Ganti 'the-latest-version' dengan nomor versi terbaru: https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java -->
        <version>the-latest-version</version>
    </dependency>
  3. Simpan file pom.xml.

  4. Jalankan perintah Maven seperti mvn compile atau mvn clean install untuk memperbarui dependensi. Maven akan secara otomatis mengunduh dan menambahkan DashScope Java SDK ke proyek Anda.

Contohnya, di IntelliJ IDEA pada Windows:

image

Gradle

  1. Buka file build.gradle proyek Gradle Anda.

  2. Tambahkan dependensi ini ke blok dependencies:

    dependencies {
        // Ganti 'the-latest-version' dengan nomor versi terbaru: https://mvnrepository.com/artifact/com.alibaba/dashscope-sdk-java
        implementation group: 'com.alibaba', name: 'dashscope-sdk-java', version: 'the-latest-version'
    }
  3. Simpan file build.gradle.

  4. Di terminal Anda, navigasi ke direktori root proyek Anda dan jalankan perintah Gradle ini untuk memperbarui dependensi. Ini akan secara otomatis mengunduh dan menambahkan DashScope Java SDK ke proyek Anda.

    ./gradlew build --refresh-dependencies

Contohnya, di IntelliJ IDEA pada Windows:

image

Langkah 2: Panggil API

Jalankan kode ini untuk memanggil API model.

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 {
        // Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
        // - Singapura: https://dashscope-intl.aliyuncs.com/api/v1
        // - AS (Virginia): https://dashscope-us.aliyuncs.com/api/v1
        // - Tiongkok (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()
                // Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
                // Jika variabel lingkungan belum dikonfigurasi, ganti dengan: .apiKey("sk-xxx")
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Daftar model: 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);
    }
}

Output-nya adalah:

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

curl

Panggil model di Model Studio menggunakan titik akhir HTTP yang kompatibel dengan OpenAI atau DashScope. Untuk daftar model yang didukung, lihat Daftar model.

Catatan

Jika DASHSCOPE_API_KEY belum diatur, ganti -H "Authorization: Bearer $DASHSCOPE_API_KEY" dengan -H "Authorization: Bearer sk-xxx".

HTTP kompatibel OpenAI

URL dalam contoh ini menggunakan wilayah Singapura. Jika Anda menggunakan wilayah Tiongkok (Beijing), ganti URL dengan https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions.

Kirim permintaan API:

Windows

Jalankan perintah ini di Command Prompt:

# ======= Pemberitahuan penting =======
# Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
# - Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
# - AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
# - Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === Hapus komentar ini sebelum menjalankan ===

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

Jalankan perintah ini di Terminal:

# ======= Pemberitahuan penting =======
# Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
# - Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
# - AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
# - Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === Hapus komentar ini sebelum menjalankan ===

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

Setelah mengirim permintaan API, Anda akan menerima respons berikut:

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

URL dalam contoh ini menggunakan wilayah Singapura.

  • Jika Anda menggunakan wilayah AS (Virginia), ganti URL dengan https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation.

  • Jika Anda menggunakan wilayah Tiongkok (Beijing), ganti URL dengan https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation.

Kirim permintaan API:

Windows

Jalankan perintah ini di Command Prompt:

# ======= Pemberitahuan penting =======
# Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
# - Singapura: https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - AS (Virginia): https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - Tiongkok (Beijing): https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === Hapus komentar ini sebelum menjalankan ===

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

Jalankan perintah ini di Terminal:

# ======= Pemberitahuan penting =======
# Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
# - Singapura: https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - AS (Virginia): https://dashscope-us.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# - Tiongkok (Beijing): https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === Hapus komentar ini sebelum menjalankan ===

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

Setelah mengirim permintaan API, Anda akan menerima respons berikut:

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

Bahasa lainnya

Panggil API model

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() {
	// Buat klien HTTP
	client := &http.Client{}
	// Bangun badan permintaan
	requestBody := RequestBody{
		// Daftar model: 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)
	}
	// Buat permintaan POST. Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
        // - Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
        // - AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
        // - Tiongkok (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)
	}
	// Atur header permintaan
	// Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
	// Jika variabel lingkungan belum dikonfigurasi, ganti dengan: apiKey := "sk-xxx"
	apiKey := os.Getenv("DASHSCOPE_API_KEY")
	req.Header.Set("Authorization", "Bearer "+apiKey)
	req.Header.Set("Content-Type", "application/json")
	// Kirim permintaan
	resp, err := client.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer resp.Body.Close()
	// Baca badan respons
	bodyText, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}
	// Cetak respons
	fmt.Printf("%s\n", bodyText)
}
<?php
// Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
// - Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
// - AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
// - Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
$url = 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions';
// Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
// Jika variabel lingkungan belum dikonfigurasi, ganti dengan: $apiKey = "sk-xxx"
$apiKey = getenv('DASHSCOPE_API_KEY');
// Atur header permintaan
$headers = [
    'Authorization: Bearer '.$apiKey,
    'Content-Type: application/json'
];
// Atur badan permintaan
$data = [
    "model" => "qwen-plus",
    "messages" => [
        [
            "role" => "system",
            "content" => "You are a helpful assistant."
        ],
        [
            "role" => "user",
            "content" => "Who are you?"
        ]
    ]
];
// Inisialisasi sesi cURL
$ch = curl_init();
// Atur opsi 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);
// Jalankan sesi cURL
$response = curl_exec($ch);
// Periksa error
if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
}
// Tutup resource cURL
curl_close($ch);
// Output respons
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)
    {
        // Kunci API Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak saling menggantikan. Dapatkan kunci API Anda: https://www.alibabacloud.com/help/model-studio/get-api-key
        // Jika variabel lingkungan belum dikonfigurasi, ganti dengan: 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;
        }
        // Catatan: URL dasar tidak saling menggantikan antar wilayah. Contoh ini menggunakan Singapura.
        // - Singapura: https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions
        // - AS (Virginia): https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions
        // - Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
        string url = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions";
        // Daftar model: 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?""
                }
            ]
        }";

        // Kirim permintaan dan dapatkan respons
        string result = await SendPostRequestAsync(url, jsonContent, apiKey);

        // Output hasil
        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"))
        {
            // Atur header permintaan
            httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
            httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));

            // Kirim permintaan dan dapatkan respons
            HttpResponseMessage response = await httpClient.PostAsync(url, content);

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

Referensi API

FAQ

Bagaimana cara memperbaiki error Model.AccessDenied setelah memanggil API model?

J: Error ini terjadi karena Anda menggunakan kunci API dari sub-ruang kerja. Sub-ruang kerja tidak dapat mengakses aplikasi atau model di ruang kerja default. Untuk menggunakan kunci API sub-ruang kerja, administrator akun root harus memberikan otorisasi model untuk sub-ruang kerja yang sesuai (misalnya, topik ini menggunakan model Qwen-Plus). Untuk langkah-langkah detailnya, lihat Atur izin untuk pemanggilan model.

Langkah selanjutnya

Jelajahi lebih banyak model

Kode contoh menggunakan qwen-plus. Model Studio juga mendukung model Qwen lainnya. Lihat Daftar model untuk model yang didukung dan referensi API-nya.

Pelajari fitur lanjutan

Kode contoh hanya mencakup tanya jawab dasar. Untuk mempelajari lebih lanjut tentang API Qwen, seperti keluaran streaming, output terstruktur, dan pemanggilan fungsi, lihat Ikhtisar model generasi teks.

Coba model di browser

Jika Anda ingin berinteraksi dengan model melalui dialog box, seperti di Qwen Chat, buka Playground (Singapura, AS (Virginia), Tiongkok (Beijing), Tiongkok (Hong Kong), atau Jerman (Frankfurt)).