全部产品
Search
文档中心

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

更新时间:Oct 21, 2025

Alibaba Cloud Model Studio memungkinkan Anda memanggil model bahasa besar (LLM) melalui antarmuka yang kompatibel dengan OpenAI atau SDK DashScope.

Topik ini menggunakan Qwen sebagai contoh untuk membimbing Anda melalui panggilan API pertama Anda. Anda akan belajar cara:

  • Mendapatkan Kunci API

  • Mengonfigurasi lingkungan pengembangan lokal Anda

  • Memanggil API Qwen

Pengaturan akun

  1. Daftarkan Akun: Jika Anda belum memiliki Akun Alibaba Cloud, daftar terlebih dahulu di sini.

  2. Pilih Wilayah: Model Studio menyediakan Edisi Internasional (Singapura) dan Edisi Tiongkok Daratan (Beijing). Kedua edisi berbeda dalam hal konsol, titik akhir, model, dan harga. Untuk detail lebih lanjut, lihat Model dan Harga.

    • Edisi Internasional: Titik akhir dan layanan model berada di wilayah internasional, tidak termasuk Tiongkok Daratan. Titik akhir default adalah Singapura.

    • Edisi Tiongkok Daratan: Titik akhir dan layanan model berada di Tiongkok Daratan. Saat ini, hanya titik akhir Beijing yang didukung.

  3. Lengkapi Verifikasi Akun: Untuk mengaktifkan Edisi Tiongkok Daratan, langkah ini diperlukan. Untuk Edisi Internasional, Anda dapat melewati langkah ini.

    Gunakan Akun Alibaba Cloud Anda untuk menyelesaikan verifikasi akun:

    • Pilih Individual Verification atau Upgrade to Enterprise, lalu klik Verify now.

    • Di bagian Additional Information pada halaman yang muncul, pilih Yes untuk Purchase cloud resources or enable acceleration inside the Chinese mainland.

    • Untuk informasi tambahan, lihat Gambaran Umum Verifikasi Akun.

  4. Aktifkan Model Studio: Gunakan Akun Alibaba Cloud Anda untuk mengakses Konsol Model Studio (Singapura atau Beijing). Setelah membaca dan menyetujui Ketentuan Layanan, Model Studio akan diaktifkan secara otomatis. Jika Ketentuan Layanan tidak muncul, ini menunjukkan bahwa Anda telah mengaktifkan Model Studio.

  5. Dapatkan Kunci API: Buka halaman Key Management (Singapura atau Beijing), lalu klik Create API Key. Nantinya, Anda akan menggunakan API Key untuk memanggil model.

    Saat membuat kunci API baru, atur Workspace ke Ruang Kerja Default. Untuk menggunakan kunci API dari sub-ruang kerja, pemilik Akun Alibaba Cloud harus mengotorisasi sub-ruang kerja tersebut untuk menggunakan model tertentu. Untuk informasi lebih lanjut, lihat Otorisasi Sub-Ruang Kerja untuk Memanggil Model.

Atur kunci API Anda sebagai variabel lingkungan

Atur kunci API sebagai variabel lingkungan untuk menghindari pengkodean langsung di dalam kode Anda. Hal ini mengurangi risiko kebocoran data.

Prosedur

Linux

Tambahkan variabel lingkungan permanen

Atur 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

    Sebagai alternatif, 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"

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

  2. Jalankan perintah berikut untuk menerapkan perubahan.

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

    echo $DASHSCOPE_API_KEY

Tambahkan variabel lingkungan sementara

Atur 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

Atur kunci API Anda sebagai variabel lingkungan permanen:

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

    echo $SHELL
  2. Ikuti langkah-langkah yang sesuai dengan tipe 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

      Sebagai alternatif, 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"

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

    2. Jalankan perintah berikut untuk menerapkan perubahan.

      source ~/.zshrc
    3. Buka jendela terminal baru 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

      Sebagai alternatif, 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 di editor nano, tekan Ctrl+X, lalu Y, dan kemudian Enter.

    2. Jalankan perintah berikut untuk menerapkan perubahan.

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

      echo $DASHSCOPE_API_KEY

Tambahkan variabel lingkungan sementara

Jika Anda ingin menggunakan variabel lingkungan hanya di 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 Properti Sistem, CMD, atau PowerShell.

Properti sistem

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

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

  • Setelah mengonfigurasi variabel lingkungan, perubahan tidak akan langsung berlaku di jendela perintah terbuka, IDE, atau aplikasi lain yang sedang berjalan. Anda harus me-restart program-program tersebut atau membuka jendela baris perintah baru agar variabel lingkungan diterapkan.

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

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

    image

  3. Klik OK di semua tiga jendela 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 query CMD:

      echo %DASHSCOPE_API_KEY%

      image

    • Perintah query Windows PowerShell:

      echo $env:DASHSCOPE_API_KEY

      image

CMD

Tambahkan variabel lingkungan permanen

Jika Anda ingin variabel lingkungan kunci API bertahan di semua sesi baru untuk pengguna saat ini, ikuti 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 ingin menggunakan variabel lingkungan hanya di sesi saat ini, jalankan 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 di 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 bertahan di semua sesi baru untuk pengguna saat ini, ikuti 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 ingin menggunakan variabel lingkungan hanya di sesi saat ini, jalankan 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 di sesi saat ini untuk memeriksa apakah variabel lingkungan telah diterapkan.

echo $env:DASHSCOPE_API_KEY

image

Pilih bahasa pemrograman

Pilih bahasa pemrograman atau alat yang Anda kuasai.

Python

Langkah 1: Siapkan lingkungan Python

Periksa versi Python Anda

Jalankan perintah berikut di terminal untuk memeriksa apakah Python dan pip telah terinstal di lingkungan Anda:

Versi Python harus 3.8 atau lebih baru. Untuk informasi lebih lanjut, lihat Instal Python.

python -V
pip --version

Gambar berikut menunjukkan contoh di Windows Command Prompt:

image

FAQ

Q: Pesan kesalahan muncul saat menjalankan perintah 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

A: Untuk menyelesaikan masalah ini, ikuti langkah-langkah berikut:

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

  2. Jika Python telah terinstal dan variabel lingkungan telah ditambahkan tetapi kesalahan masih berlanjut, tutup terminal saat ini, buka yang baru, dan coba lagi.

Linux dan macOS

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

  2. Jika kesalahan masih berlanjut setelah menginstal Python, jalankan perintah which python pip untuk memeriksa apakah python dan pip tersedia di sistem.

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

      /usr/bin/python
      /usr/bin/pip
    • Jika hasil berikut dikembalikan, jalankan perintah which python3 pip3 untuk memeriksa kembali.

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

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

Konfigurasikan lingkungan virtual (Opsional)

Setelah menginstal Python, Anda dapat membuat lingkungan virtual untuk menginstal OpenAI Python SDK atau DashScope Python SDK. Ini membantu menghindari konflik dependensi dengan proyek lain.

  1. Buat Lingkungan Virtual

    Jalankan perintah berikut untuk membuat lingkungan virtual bernama .venv:

    # Jika perintah gagal dijalankan, Anda bisa mengganti python dengan python3 dan menjalankannya lagi.
    python -m venv .venv
  2. Aktifkan Lingkungan Virtual

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

    source .venv/bin/activate

Instal OpenAI Python SDK atau DashScope Python SDK

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

Instal OpenAI Python SDK

Jalankan perintah berikut untuk menginstal OpenAI Python SDK:

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

image

Saat pesan Successfully installed ... openai-x.x.x muncul di terminal, OpenAI Python SDK telah terinstal.

Instal DashScope Python SDK

Jalankan perintah berikut untuk menginstal DashScope Python SDK:

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

image

Saat pesan Successfully installed ... dashscope-x.x.x muncul di terminal, DashScope Python SDK telah terinstal.

Catatan

Jika pesan WARNING: You are using pip version xxx; however, version xxx is available. muncul selama instalasi SDK, ini adalah notifikasi untuk memperbarui alat pip Anda dan tidak memengaruhi instalasi SDK. Anda bisa mengabaikan pesan ini.

Langkah 2: Panggil API LLM

OpenAI Python SDK

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

  1. Buat file bernama hello_qwen.py.

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

    import os
    from openai import OpenAI
    
    try:
        client = OpenAI(
            # Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Untuk mendapatkan kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
            # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: api_key="sk-xxx",
            api_key=os.getenv("DASHSCOPE_API_KEY"),
            # URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: 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"Pesan kesalahan: {e}")
        print("Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/developer-reference/error-code")
  3. Jalankan python hello_qwen.py atau python3 hello_qwen.py di baris perintah.

    Jika pesan No such file or directory muncul, tentukan jalur file lengkap dari file tersebut.

    Setelah perintah dijalankan, keluaran berikut akan dikembalikan:

    Saya adalah model bahasa skala besar yang dikembangkan oleh Alibaba Cloud. Nama saya adalah Qwen.

DashScope Python SDK

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

  1. Buat file bernama hello_qwen.py.

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

    import os
    from dashscope import Generation
    import dashscope
    # URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: 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 dan Tiongkok (Beijing) berbeda. Untuk mendapatkan kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
        # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: 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"Kode pengembalian HTTP: {response.status_code}")
        print(f"Kode kesalahan: {response.code}")
        print(f"Pesan kesalahan: {response.message}")
        print("Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/developer-reference/error-code")
  3. Jalankan python hello_qwen.py atau python3 hello_qwen.py di baris perintah.

    Catatan

    Perintah dalam contoh ini harus dijalankan dari direktori tempat file Python berada. Jika ingin menjalankannya dari lokasi lain, tentukan jalur file lengkap.

    Setelah perintah dijalankan, keluaran berikut akan dikembalikan:

    Saya adalah model bahasa besar dari Alibaba Cloud. Nama saya adalah Qwen.

Node.js

Langkah 1: Siapkan lingkungan Node.js

Periksa status instalasi Node.js

Jalankan perintah berikut di terminal untuk memeriksa apakah Node.js dan npm telah terinstal di lingkungan Anda:

node -v
npm -v

Gambar berikut menunjukkan contoh di Windows Command Prompt:

image

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

Instal SDK

Jalankan perintah berikut di terminal:

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

Jika instalasi gagal, Anda dapat mengonfigurasi sumber cermin lalu lintas untuk menyelesaikan instalasi. Sebagai contoh:

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

Setelah mengonfigurasi sumber cermin lalu lintas, jalankan perintah instalasi SDK lagi.

image

Saat pesan added xx package in xxs muncul di terminal, OpenAI SDK telah terinstal. Anda dapat menggunakan npm list openai untuk memeriksa informasi versi spesifik.

Langkah 2: Panggil API LLM

  1. Buat file 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 dan Tiongkok (Beijing) berbeda. Untuk mendapatkan kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
                // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: apiKey: "sk-xxx",
                apiKey: process.env.DASHSCOPE_API_KEY,
                // URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: 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(`Pesan kesalahan: ${error}`);
        console.log("Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/developer-reference/error-code");
    }
  3. Jalankan perintah berikut di baris perintah untuk mengirim permintaan API:

    node hello_qwen.mjs
    Catatan
    • Perintah dalam contoh ini harus dijalankan dari direktori tempat file hello_qwen.mjs berada. Jika ingin menjalankannya dari lokasi lain, tentukan jalur file lengkap.

    • Pastikan SDK diinstal di direktori yang sama dengan file hello_qwen.mjs. Jika tidak, kesalahan Cannot find package 'openai' imported from xxx akan dilaporkan.

    Setelah perintah berhasil dijalankan, keluaran berikut akan dikembalikan:

    Saya adalah model bahasa dari Alibaba Cloud. Nama saya adalah Qwen.

Java

Langkah 1: Siapkan lingkungan Java

Periksa versi Java Anda

Jalankan perintah berikut di terminal:

java -version
# (Opsional) Jika Anda menggunakan Maven untuk mengelola dan membangun proyek Java, Anda juga harus memastikan bahwa Maven diinstal dengan benar di lingkungan pengembangan Anda.
mvn --version

Gambar berikut menunjukkan contoh di Windows Command Prompt:

image

Untuk menggunakan DashScope Java SDK, diperlukan Java 8 atau versi lebih baru. Periksa baris pertama keluaran untuk memastikan versi Java. Misalnya, keluaran openjdk version "16.0.1" 2021-04-20 menunjukkan bahwa versi Java saat ini adalah Java 16. Jika Java belum terinstal atau versinya lebih lama dari Java 8, kunjungi Java Downloads untuk mengunduh dan menginstalnya.

Instal SDK

Jika Java telah terinstal di lingkungan Anda, instal DashScope Java SDK. Untuk informasi lebih lanjut tentang versi SDK, lihat DashScope Java SDK. Tambahkan dependensi Java SDK dan ganti the-latest-version dengan nomor versi terbaru.

XML

  1. Buka file pom.xml proyek Maven Anda.

  2. Tambahkan informasi dependensi berikut 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 secara otomatis mengunduh dan menambahkan DashScope Java SDK ke proyek Anda.

Gambar berikut menunjukkan contoh di IDE IntelliJ IDEA di Windows:

image

Gradle

  1. Buka file build.gradle proyek Gradle Anda.

  2. Tambahkan informasi dependensi berikut di 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 baris perintah, beralihlah ke direktori root proyek Anda dan jalankan perintah Gradle berikut untuk memperbarui dependensi proyek. Perintah ini secara otomatis mengunduh dan menambahkan DashScope Java SDK ke proyek Anda.

    ./gradlew build --refresh-dependencies

Gambar berikut menunjukkan contoh di IDE IntelliJ IDEA di Windows:

image

Langkah 2: Panggil API LLM

Jalankan kode berikut untuk memanggil API LLM.

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 {
        // URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: 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 dan Tiongkok (Beijing) berbeda. Untuk mendapatkan kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
                // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: .apiKey("sk-xxx")
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Untuk daftar model, lihat https://www.alibabacloud.com/help/en/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("Pesan kesalahan: "+e.getMessage());
            System.out.println("Untuk informasi lebih lanjut, lihat https://www.alibabacloud.com/help/en/model-studio/developer-reference/error-code");
        }
        System.exit(0);
    }
}

Setelah kode dijalankan, keluaran berikut akan dikembalikan:

Saya adalah model bahasa skala besar yang dikembangkan oleh Alibaba Cloud. Nama saya adalah Qwen.

curl

Anda dapat memanggil model menggunakan HTTP yang kompatibel dengan OpenAI atau DashScope HTTP. Untuk daftar model, lihat Model dan harga.

Catatan

Jika Anda belum mengonfigurasi variabel lingkungan, ganti -H "Authorization: Bearer $DASHSCOPE_API_KEY" \ dengan -H "Authorization: Bearer sk-xxx" \.

HTTP yang kompatibel dengan OpenAI

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

Jalankan perintah berikut untuk mengirim permintaan API:

Windows

Jalankan perintah berikut di Command Prompt:

# ======= Penting =======
# Kunci API untuk Wilayah Singapura dan China (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === Hapus komentar ini saat menjalankan perintah. ===

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 dan Tiongkok (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
# === Hapus komentar ini saat menjalankan perintah. ===

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, tanggapan berikut akan dikembalikan:

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "Saya adalah model bahasa besar dari Alibaba Cloud. Nama saya adalah 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 adalah untuk Wilayah Singapura. Jika Anda menggunakan model di Wilayah Tiongkok (Beijing), ganti URL dengan https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation.

Jalankan perintah berikut untuk mengirim permintaan API:

Windows

Jalankan perintah berikut di Command Prompt:

# ======= Penting =======
# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === Hapus komentar ini saat menjalankan perintah. ===

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 dan Tiongkok (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# URL berikut adalah untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
# === Hapus komentar ini saat menjalankan perintah. ===

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, tanggapan berikut akan dikembalikan:

{
    "output": {
        "choices": [
            {
                "finish_reason": "stop",
                "message": {
                    "role": "assistant",
                    "content": "I am a large 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 LLM

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{}
	// Konstruksi badan permintaan.
	requestBody := RequestBody{
		// Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
		Model: "qwen-plus",
		Messages: []Message{
			{
				Role:    "system",
				Content: "Anda adalah asisten yang membantu.",
			},
			{
				Role:    "user",
				Content: "Siapa Anda?",
			},
		},
	}
	jsonData, err := json.Marshal(requestBody)
	if err != nil {
		log.Fatal(err)
	}
	// Buat permintaan POST. URL berikut ini untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti URL dengan: 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 dan China (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
	// Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: 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 isi respons.
	fmt.Printf("%s\n", bodyText)
}
<?php
// URL berikut ini untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti URL dengan: 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 dan China (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
// Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: $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" => "Anda adalah asisten yang membantu."
        ],
        [
            "role" => "user",
            "content" => "Siapa Anda?"
        ]
    ]
];
// 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);
// Eksekusi sesi cURL.
$response = curl_exec($ch);
// Periksa kesalahan.
if (curl_errno($ch)) {
    echo 'Curl error: ' . curl_error($ch);
}
// Tutup sumber daya 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 dan China (Beijing) berbeda. Untuk mendapatkan Kunci API, lihat https://modelstudio.console.alibabacloud.com/?tab=model#/api-key
        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Model Studio Anda: string? apiKey = "sk-xxx";
        string? apiKey = Environment.GetEnvironmentVariable("DASHSCOPE_API_KEY");

        if (string.IsNullOrEmpty(apiKey))
        {
            Console.WriteLine("Kunci API tidak diatur. Pastikan bahwa variabel lingkungan 'DASHSCOPE_API_KEY' telah diatur.");
            return;
        }
        // URL berikut ini untuk wilayah Singapura. Jika Anda menggunakan model di wilayah China (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
        string url = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions";
        // Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
        string jsonContent = @"{
            ""model"": ""qwen-plus"",
            ""messages"": [
                {
                    ""role"": ""system"",
                    ""content"": ""Anda adalah asisten yang membantu.""
                },
                {
                    ""role"": ""user"", 
                    ""content"": ""Siapa Anda?""
                }
            ]
        }";

        // 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 $"Permintaan gagal: {response.StatusCode}";
            }
        }
    }
}

Referensi API

  • Untuk detail parameter permintaan dan respons API Qwen, lihat Qwen.

  • Informasi lebih lanjut mengenai model lain tersedia di Model dan harga.

FAQ

Apa yang harus dilakukan jika kesalahan Model.AccessDenied dilaporkan setelah saya memanggil API LLM?

A: Kesalahan ini terjadi karena Anda menggunakan Kunci API dari sub-ruang kerja, dan sub-ruang kerja tersebut tidak memiliki izin untuk mengakses aplikasi atau model dalam ruang kerja default. Untuk menggunakan Kunci API dari sub-ruang kerja, administrator Akun Alibaba Cloud harus memberikan otorisasi model kepada sub-ruang kerja. Sebagai contoh, topik ini menggunakan model Qwen-Plus. Untuk informasi lebih lanjut, lihat Otorisasi sub-ruang kerja untuk memanggil model.

Apa yang harus dilakukan selanjutnya

Lihat lebih banyak model

Kode contoh menggunakan model qwen-plus. Alibaba Cloud Model Studio juga mendukung model Qwen lainnya dan model pihak ketiga seperti DeepSeek dan Kimi. Untuk informasi lebih lanjut tentang model yang didukung dan referensi API mereka, lihat Model dan harga.

Pelajari tentang penggunaan tingkat lanjut

Kode contoh mengimplementasikan interaksi tanya jawab sederhana. Untuk mempelajari lebih lanjut tentang penggunaan tingkat lanjut dari API Qwen, seperti keluaran streaming, keluaran terstruktur, dan pemanggilan fungsi, lihat topik dalam bagian Ikhtisar model generasi teks.

Coba model secara online

Untuk berinteraksi dengan model besar dalam kotak dialog, mirip dengan pengalaman di Qwen Chat, kunjungi Playground (Singapura atau Beijing).