全部产品
Search
文档中心

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

更新时间:Jan 22, 2026

Alibaba Cloud Model Studio menyediakan API untuk memanggil model. Anda dapat terhubung melalui antarmuka yang kompatibel dengan OpenAI atau SDK DashScope.

Topik ini menggunakan Qwen sebagai contoh untuk memandu Anda melalui proses pemanggilan API model. Anda akan mempelajari cara:

  • Mendapatkan kunci API

  • Menyiapkan lingkungan pengembangan lokal

  • Memanggil API Qwen

Pengaturan akun

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

    Jika Anda mengalami masalah apa pun, lihat Daftarkan Akun Alibaba Cloud.
  2. Aktifkan Model Studio: Gunakan Akun Alibaba Cloud Anda untuk membuka Konsol Model Studio. Setelah Anda membaca dan menyetujui Ketentuan Layanan, Model Studio akan diaktifkan secara otomatis. Jika Ketentuan Layanan tidak ditampilkan, layanan tersebut sudah diaktifkan.

  3. Buat kunci API: Buka halaman Key Management dan klik Create API Key. Anda kemudian dapat menggunakan API key tersebut untuk memanggil model.

Tetapkan kunci API sebagai variabel lingkungan

Tetapkan kunci API Anda sebagai variabel lingkungan untuk menghindari eksposur kunci dalam kode Anda dan mengurangi risiko kebocoran.

Prosedur

Linux

Tambahkan variabel lingkungan permanen

Tetapkan kunci API Anda sebagai variabel lingkungan permanen:

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

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

    Atau, Anda dapat memodifikasi file ~/.bashrc secara manual.

    Edit secara manual

    Jalankan perintah berikut untuk membuka file ~/.bashrc.

    nano ~/.bashrc

    Tambahkan konten berikut ke file konfigurasi.

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

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

  2. Jalankan perintah berikut agar perubahan diterapkan.

    source ~/.bashrc
  3. Buka jendela terminal lain dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah diterapkan.

    echo $DASHSCOPE_API_KEY

Tambahkan variabel lingkungan sementara

Tetapkan kunci API Anda sebagai variabel lingkungan sementara untuk sesi saat ini:

  1. Jalankan perintah berikut.

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah diterapkan.

    echo $DASHSCOPE_API_KEY

macOS

Tambahkan variabel lingkungan permanen

Tetapkan kunci API Anda sebagai variabel lingkungan permanen:

  1. Jalankan perintah berikut di terminal untuk melihat jenis shell default.

    echo $SHELL
  2. Ikuti langkah-langkah yang sesuai dengan jenis shell default Anda.

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

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

      Atau, Anda dapat memodifikasi file ~/.zshrc secara manual.

      Edit secara manual

      Jalankan perintah berikut untuk membuka file konfigurasi shell.

      nano ~/.zshrc

      Tambahkan konten berikut ke file konfigurasi.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

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

    2. Jalankan perintah berikut agar perubahan diterapkan.

      source ~/.zshrc
    3. Buka jendela terminal lain dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah diterapkan.

      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 Alibaba Cloud Model Studio Anda.
      echo "export DASHSCOPE_API_KEY='YOUR_DASHSCOPE_API_KEY'" >> ~/.bash_profile

      Atau, Anda dapat memodifikasi file ~/.bash_profile secara manual.

      Edit secara manual

      Jalankan perintah berikut untuk membuka file konfigurasi shell.

      nano ~/.bash_profile

      Tambahkan konten berikut ke file konfigurasi.

      # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
      export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"

      Untuk menyimpan dan menutup file pada editor nano, tekan Ctrl+X, lalu Y, dan tekan Enter.

    2. Jalankan perintah berikut agar perubahan diterapkan.

      source ~/.bash_profile
    3. Buka jendela terminal lain dan jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah diterapkan.

      echo $DASHSCOPE_API_KEY

Tambahkan variabel lingkungan sementara

Jika Anda hanya ingin menggunakan variabel lingkungan dalam sesi saat ini, tambahkan sebagai variabel lingkungan sementara.

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

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
    export DASHSCOPE_API_KEY="YOUR_DASHSCOPE_API_KEY"
  2. Jalankan perintah berikut untuk memeriksa apakah variabel lingkungan telah diterapkan.

    echo $DASHSCOPE_API_KEY

Windows

Di Windows, Anda dapat mengonfigurasi variabel lingkungan menggunakan System Properties, CMD, atau PowerShell.

System properties

Catatan
  • Variabel lingkungan yang dikonfigurasi dengan metode ini bersifat permanen.

  • Anda harus memiliki izin administrator untuk memodifikasi variabel lingkungan sistem.

  • Setelah Anda mengonfigurasi variabel lingkungan, perubahan tersebut tidak langsung berlaku pada jendela command yang sedang terbuka, Integrated Development Environments (IDE), atau aplikasi lain yang sedang berjalan. Anda harus me-restart program-program tersebut atau membuka jendela command line baru agar variabel lingkungan berlaku.

  1. Di desktop Windows, tekan Win+Q, cari Edit the system environment variables di kotak pencarian, lalu buka jendela System Properties.

  2. Di jendela System Properties, klik Environment Variables. Lalu, di area System variables, klik New. Atur Variable name menjadi DASHSCOPE_API_KEY dan Variable value menjadi kunci API DashScope Anda.

    image

  3. Klik OK di ketiga jendela yang terbuka untuk menyimpan perubahan dan menyelesaikan konfigurasi variabel lingkungan.

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

    • Perintah kueri CMD:

      echo %DASHSCOPE_API_KEY%

      image

    • Perintah kueri Windows PowerShell:

      echo $env:DASHSCOPE_API_KEY

      image

CMD

Tambahkan variabel lingkungan permanen

Jika Anda ingin variabel lingkungan kunci API tetap ada di semua sesi baru untuk pengguna saat ini, Anda dapat melakukan langkah-langkah berikut.

  1. Jalankan perintah berikut di Command Prompt.

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
    setx DASHSCOPE_API_KEY "YOUR_DASHSCOPE_API_KEY"
  2. Buka jendela Command Prompt baru.

  3. Jalankan perintah berikut di jendela Command Prompt baru untuk memeriksa apakah variabel lingkungan telah diterapkan.

    echo %DASHSCOPE_API_KEY%

    image

Tambahkan variabel lingkungan sementara

Jika Anda hanya ingin menggunakan variabel lingkungan dalam sesi saat ini, Anda dapat menjalankan perintah berikut di Command Prompt.

# Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
set DASHSCOPE_API_KEY=YOUR_DASHSCOPE_API_KEY

Anda dapat menjalankan perintah berikut dalam sesi saat ini untuk memeriksa apakah variabel lingkungan telah diterapkan.

echo %DASHSCOPE_API_KEY%

image

PowerShell

Tambahkan variabel lingkungan permanen

Jika Anda ingin variabel lingkungan kunci API tetap ada di semua sesi baru untuk pengguna saat ini, Anda dapat melakukan langkah-langkah berikut.

  1. Jalankan perintah berikut di PowerShell.

    # Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
    [Environment]::SetEnvironmentVariable("DASHSCOPE_API_KEY", "YOUR_DASHSCOPE_API_KEY", [EnvironmentVariableTarget]::User)
  2. Buka jendela PowerShell baru.

  3. Jalankan perintah berikut di jendela PowerShell baru untuk memeriksa apakah variabel lingkungan telah diterapkan.

    echo $env:DASHSCOPE_API_KEY

    image

Tambahkan variabel lingkungan sementara

Jika Anda hanya ingin menggunakan variabel lingkungan dalam sesi saat ini, Anda dapat menjalankan perintah berikut di PowerShell.

# Ganti YOUR_DASHSCOPE_API_KEY dengan kunci API Alibaba Cloud Model Studio Anda.
$env:DASHSCOPE_API_KEY = "YOUR_DASHSCOPE_API_KEY"

Anda dapat menjalankan perintah berikut dalam sesi saat ini untuk memeriksa apakah variabel lingkungan telah diterapkan.

echo $env:DASHSCOPE_API_KEY

image

Pilih bahasa pemrograman

Pilih bahasa atau alat yang familiar untuk memanggil API model.

Python

Langkah 1: Konfigurasikan lingkungan Python

Periksa versi Python Anda

Anda dapat memasukkan perintah berikut di terminal untuk memeriksa apakah Python dan pip telah terinstal di lingkungan pengembangan Anda saat ini:

Versi Python Anda harus 3.8 atau lebih baru, lihat Instal Python.

python -V
pip --version

Contoh berikut menggunakan CMD di Windows:

image

FAQ

Q: Saya mendapatkan error saat menjalankan python -V atau pip --version:

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

Solusi:

Windows
  1. Pastikan Anda telah menginstal Python di lingkungan pengembangan Anda dan menambahkan python.exe ke variabel lingkungan PATH. Untuk informasi lebih lanjut, lihat Instal Python.image

  2. Jika Anda telah menginstal Python dan menambahkannya ke variabel lingkungan tetapi error masih muncul, tutup terminal saat ini, buka yang baru, lalu coba lagi.

Linux dan macOS

  1. Pastikan Anda telah menginstal Python di lingkungan pengembangan Anda. Untuk informasi lebih lanjut, lihat Instal Python.

  2. Jika error masih muncul setelah Anda menginstal Python, jalankan perintah which python pip untuk memeriksa apakah python dan pip ada di sistem.

    • Jika hasil berikut dikembalikan, tutup terminal saat ini, buka yang baru, lalu coba lagi.

      /usr/bin/python
      /usr/bin/pip
    • Jika Anda melihat output berikut, jalankan which python3 pip3 sebagai gantinya.

      /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 Anda melihat output berikut, gunakan python3 -V dan pip3 --version untuk memeriksa versi.

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

Konfigurasikan lingkungan virtual (Opsional)

Jika Anda telah menginstal Python, Anda dapat membuat lingkungan virtual untuk menginstal OpenAI Python SDK atau DashScope Python SDK. Hal ini membantu mencegah konflik dependensi dengan proyek lain.

  1. Buat lingkungan virtual

    Anda dapat menjalankan perintah berikut untuk membuat lingkungan virtual bernama .venv:

    # Jika perintah gagal, Anda dapat mengganti python dengan python3 dan menjalankannya lagi
    python -m venv .venv
  2. Aktifkan lingkungan virtual

    Jika Anda menggunakan Windows, jalankan perintah berikut untuk mengaktifkan lingkungan virtual:

    .venv\Scripts\activate

    Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut untuk mengaktifkan lingkungan virtual:

    source .venv/bin/activate

Instal OpenAI Python SDK atau DashScope Python SDK

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

Instal OpenAI Python SDK

Jalankan perintah berikut untuk menginstal atau memperbarui OpenAI Python SDK:

# Jika perintah gagal, Anda dapat mengganti pip dengan pip3 dan menjalankannya lagi
pip install -U openai

image

Saat Anda melihat Successfully installed ... openai-x.x.x, OpenAI Python SDK telah terinstal.

Instal DashScope Python SDK

Jalankan perintah berikut untuk menginstal atau memperbarui DashScope Python SDK:

# Jika perintah gagal, Anda dapat mengganti pip dengan pip3 dan menjalankannya lagi
pip install -U dashscope

image

Saat Anda melihat Successfully installed ... dashscope-x.x.x, DashScope Python SDK telah terinstal.

Langkah 2: Panggil API model

OpenAI Python SDK

Jika Anda telah menginstal Python dan OpenAI Python SDK, ikuti langkah-langkah berikut untuk mengirim permintaan API Anda.

  1. Buat file baru bernama hello_qwen.py.

  2. Salin kode berikut ke hello_qwen.py dan simpan file tersebut.

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # Kunci API untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
            # Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: api_key="sk-xxx", menggunakan kunci API Model Studio Anda.
            api_key=os.getenv("DASHSCOPE_API_KEY"),
            # Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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
            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("Untuk informasi lebih lanjut, lihat dokumentasi: 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.

    Setelah menjalankan perintah, Anda akan melihat output berikut:

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

DashScope Python SDK

Jika Anda telah menginstal Python dan DashScope Python SDK, ikuti langkah-langkah berikut untuk mengirim permintaan API Anda.

  1. Buat file baru bernama hello_qwen.py.

  2. Salin kode berikut ke hello_qwen.py dan simpan file tersebut.

    import os
    from dashscope import Generation
    import dashscope
    # Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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
    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 untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
        # Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: api_key = "sk-xxx", menggunakan kunci API Model Studio Anda.
        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("Untuk informasi lebih lanjut, lihat dokumentasi: 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

    Jalankan perintah ini dari direktori yang berisi file Python Anda. Untuk menjalankannya dari lokasi mana pun, tentukan path file lengkap.

    Setelah menjalankan perintah, Anda akan melihat output berikut:

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

Node.js

Langkah 1: Konfigurasikan lingkungan Node.js

Periksa status instalasi Node.js

Anda dapat memasukkan perintah berikut di terminal untuk memeriksa apakah Node.js dan npm telah terinstal di lingkungan pengembangan Anda saat ini:

node -v
npm -v

Contoh berikut menggunakan CMD di Windows:

image

Ini mencetak versi Node.js Anda saat ini. Jika Node.js belum terinstal, kunjungi situs resmi Node.js untuk mengunduhnya.

Instal SDK pemanggilan model

Anda dapat menjalankan perintah berikut di terminal:

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

Jika instalasi gagal, Anda dapat mengonfigurasi mirror registry untuk menyelesaikan instalasi. Misalnya:

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

Setelah mengonfigurasi mirror registry, jalankan kembali perintah instalasi SDK.

image

Saat Anda melihat added xx package in xxs, SDK OpenAI telah terinstal. Anda dapat menggunakan npm list openai untuk menanyakan informasi versi spesifik.

Langkah 2: Panggil API model

  1. Buat file baru hello_qwen.mjs.

  2. Salin kode berikut ke dalam file tersebut.

    import OpenAI from "openai";
    
    try {
        const openai = new OpenAI(
            {
                // Kunci API untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) berbeda. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
                // Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: apiKey: "sk-xxx", menggunakan kunci API Model Studio Anda.
                apiKey: process.env.DASHSCOPE_API_KEY,
                // Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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("Untuk informasi lebih lanjut, lihat dokumentasi: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code");
    }
  3. Jalankan perintah berikut dari command line 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 file lengkap.

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

    Setelah perintah berhasil dijalankan, Anda akan melihat output berikut:

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

Java

Langkah 1: Konfigurasikan lingkungan Java

Periksa versi Java Anda

Anda dapat menjalankan perintah berikut di terminal:

java -version
# (Opsional) Jika Anda menggunakan Maven untuk mengelola dan membangun proyek Java, pastikan juga Maven telah terinstal dengan benar di lingkungan pengembangan Anda
mvn --version

Contoh berikut menggunakan CMD di Windows:

image

DashScope Java SDK memerlukan Java 8 atau lebih baru. Anda dapat memeriksa baris pertama output untuk mengonfirmasi versi Java. Misalnya, pesan openjdk version "16.0.1" 2021-04-20 menunjukkan bahwa versi Java saat ini adalah Java 16. Jika Java belum terinstal di lingkungan pengembangan Anda saat ini, atau jika versinya lebih lama dari Java 8, kunjungi Unduhan Java untuk mengunduh dan menginstalnya.

Instal SDK pemanggilan model

Jika Java telah terinstal di lingkungan Anda, instal DashScope Java SDK. Untuk versi SDK, lihat DashScope Java SDK. Jalankan perintah berikut untuk menambahkan dependensi Java SDK. Ganti the-latest-version dengan nomor versi terbaru.

XML

  1. Buka file pom.xml proyek Maven Anda.

  2. Tambahkan informasi dependensi berikut di dalam 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. Gunakan perintah Maven, seperti mvn compile atau mvn clean install, untuk memperbarui dependensi proyek. Maven akan secara otomatis mengunduh dan menambahkan DashScope Java SDK ke proyek Anda.

Contoh berikut menggunakan integrated development environment (IDE) IntelliJ IDEA di Windows:

image

Gradle

  1. Buka file build.gradle proyek Gradle Anda.

  2. Tambahkan informasi dependensi berikut di dalam 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 command line, pindah ke direktori root proyek Anda dan jalankan perintah Gradle berikut untuk memperbarui dependensi proyek. Ini akan secara otomatis mengunduh dan menambahkan DashScope Java SDK ke proyek Anda.

    ./gradlew build --refresh-dependencies

Contoh berikut menggunakan IDE IntelliJ IDEA di Windows:

image

Langkah 2: Panggil API model

Anda dapat menjalankan kode berikut 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: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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 untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
                // Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: .apiKey("sk-xxx"), menggunakan kunci API Model Studio Anda.
                .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("Untuk informasi lebih lanjut, lihat dokumentasi: https://www.alibabacloud.com/help/model-studio/developer-reference/error-code");
        }
        System.exit(0);
    }
}

Setelah menjalankan kode, Anda akan melihat output yang sesuai:

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

curl

Anda dapat memanggil model di platform Model Studio menggunakan metode HTTP yang kompatibel dengan OpenAI atau metode HTTP DashScope. Untuk daftar model, lihat Models.

Catatan

Jika variabel lingkungan belum dikonfigurasi, ganti -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ dengan -H "Authorization: Bearer sk-xxx" \ dan gunakan kunci API Model Studio Anda.

OpenAI compatible HTTP

URL dalam contoh kode ini untuk wilayah "Internasional (Singapura)". Jika Anda menggunakan model di wilayah "Daratan Tiongkok (Beijing)", Anda harus mengganti URL dengan https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions.

Anda dapat menjalankan perintah berikut untuk mengirim permintaan API:

Windows

Jalankan perintah berikut di Command Prompt (CMD):

# ======= Penting =======
# Kunci API untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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/macOS

Jalankan perintah berikut di Terminal:

# ======= Penting =======
# Kunci API untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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 kode ini untuk wilayah Singapura.

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

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

Anda dapat menjalankan perintah berikut untuk mengirim permintaan API:

Windows

Jalankan perintah berikut di Command Prompt (CMD):

# ======= Penting =======
# Kunci API untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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/macOS

Jalankan perintah berikut di Terminal:

# ======= Penting =======
# Kunci API untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
# Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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 isi 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: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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 untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
	// Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: apiKey := "sk-xxx", menggunakan kunci API Model Studio Anda.
	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 isi respons
	bodyText, err := io.ReadAll(resp.Body)
	if err != nil {
		log.Fatal(err)
	}
	// Cetak isi respons
	fmt.Printf("%s\n", bodyText)
}
<?php
// Catatan: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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 untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
// Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: $apiKey = "sk-xxx"; menggunakan kunci API Model Studio Anda.
$apiKey = getenv('DASHSCOPE_API_KEY');
// Atur header permintaan
$headers = [
    'Authorization: Bearer '.$apiKey,
    'Content-Type: application/json'
];
// Atur isi 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);
// Keluarkan 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 untuk wilayah Singapura, AS (Virginia), dan Tiongkok (Beijing) tidak dapat dipertukarkan. Dapatkan Kunci API: https://www.alibabacloud.com/help/model-studio/get-api-key
        // Jika variabel lingkungan belum dikonfigurasi, ganti baris berikut dengan: string? apiKey = "sk-xxx"; menggunakan kunci API Model Studio Anda.
        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: base_url berbeda untuk setiap wilayah. Contoh di bawah menggunakan base_url untuk wilayah 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);

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

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

Referensi API

  • Untuk parameter input dan output API Qwen, lihat Qwen.

  • Untuk model lainnya, lihat Models.

FAQ

Apa yang harus dilakukan jika muncul error Model.AccessDenied setelah saya memanggil API model?

J: Error ini terjadi karena Anda menggunakan kunci API dari sub-workspace. Sub-workspace tidak dapat mengakses aplikasi atau model di workspace default. Untuk menggunakan model seperti Qwen-Plus, administrator akun root harus memberikan otorisasi ke sub-workspace, lihat Setel izin pemanggilan model.

Langkah selanjutnya

Lihat model lainnya

Kode contoh menggunakan model qwen-plus. Model Studio juga mendukung model Qwen lainnya. Untuk daftar model yang didukung dan referensi API yang sesuai, lihat Models.

Pelajari penggunaan lanjutan

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

Coba model secara online

Jika Anda ingin berinteraksi dengan model melalui dialog box, mirip dengan pengalaman di Qwen Chat, Anda dapat mengunjungi Playground (Singapura, Virginia, atau Beijing).