All Products
Search
Document Center

Alibaba Cloud Model Studio:Percakapan multi-putaran

Last Updated:Aug 26, 2026

API Qwen bersifat tanpa status (stateless). Untuk mengimplementasikan percakapan multi-putaran, sertakan riwayat percakapan dalam setiap permintaan. Gunakan pemotongan (truncation), ringkasan (summarization), atau pengambilan (retrieval) untuk mengelola konteks dan mengurangi konsumsi token.

Topik ini mencakup antarmuka Chat Completion yang kompatibel dengan OpenAI dan DashScope. Untuk alternatif yang lebih sederhana, lihat Kompatibel dengan OpenAI - Respons.

Cara kerja

Untuk mengimplementasikan percakapan multi-putaran, pertahankan array messages. Setelah setiap putaran, tambahkan pertanyaan pengguna dan respons model, lalu gunakan array yang telah diperbarui tersebut untuk permintaan berikutnya.

Contoh berikut menunjukkan bagaimana keadaan array messages berubah selama percakapan multi-putaran:

  1. Putaran pertama

    Tambahkan pertanyaan pengguna ke array messages.

// Gunakan model teks
[
    {"role": "user", "content": "Rekomendasikan film fiksi ilmiah tentang eksplorasi luar angkasa."}
]

// Gunakan model multimodal, misalnya Qwen-VL
// {"role": "user",
//       "content": [{"type": "image_url","image_url": {"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"}},
//                   {"type": "text", "text": "Produk apa saja yang ditampilkan dalam gambar ini?"}]
// }
  1. Putaran kedua

    Tambahkan respons model dan pertanyaan terbaru pengguna ke array messages.

// Gunakan model teks
[
    {"role": "user", "content": "Rekomendasikan film fiksi ilmiah tentang eksplorasi luar angkasa."},
    {"role": "assistant", "content": "Saya merekomendasikan 'XXX'. Ini adalah karya fiksi ilmiah klasik."},
    {"role": "user", "content": "Siapa sutradara film ini?"}
]

// Gunakan model multimodal, misalnya Qwen-VL
//[
//    {"role": "user", "content": [
//                    {"type": "image_url","image_url": {"url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"}},
//                   {"type": "text", "text": "Produk apa saja yang ditampilkan dalam gambar ini?"}]},
//    {"role": "assistant", "content": "Gambar tersebut menampilkan tiga item: sepasang overall biru muda, kaus lengan pendek bergaris biru-putih, dan sepasang sepatu kets putih."},
//    {"role": "user", "content": "Gaya apa itu?"}
//]

Mulai

Kompatibel dengan OpenAI

import os
from openai import OpenAI

def get_response(messages):
    client = OpenAI(
        # Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
        # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx",
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

        base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
    )
    # Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
    completion = client.chat.completions.create(model="qwen-plus", messages=messages)
    return completion

# Inisialisasi array messages
messages = [
    {
        "role": "system",
        "content": """Anda adalah tenaga penjual di toko ponsel Bailian. Tugas Anda adalah merekomendasikan ponsel kepada pengguna. Ponsel memiliki dua parameter: ukuran layar (termasuk 6,1 inci, 6,5 inci, dan 6,7 inci) dan resolusi (termasuk 2K dan 4K).
        Anda hanya boleh menanyakan satu parameter kepada pengguna dalam satu waktu. Jika pengguna tidak memberikan informasi lengkap, Anda perlu mengajukan pertanyaan lanjutan untuk mendapatkan parameter yang hilang. Ketika semua parameter telah dikumpulkan, Anda harus mengatakan: Saya telah memahami maksud pembelian Anda. Mohon tunggu.""",
    }
]
assistant_output = "Selamat datang di toko ponsel Bailian. Ukuran layar seperti apa yang Anda cari?"
print(f"Output model: {assistant_output}\n")
while "Saya telah memahami maksud pembelian Anda" not in assistant_output:
    user_input = input("Silakan masukkan: ")
    # Tambahkan pertanyaan pengguna ke daftar messages
    messages.append({"role": "user", "content": user_input})
    assistant_output = get_response(messages).choices[0].message.content
    # Tambahkan respons model ke daftar messages
    messages.append({"role": "assistant", "content": assistant_output})
    print(f"Output model: {assistant_output}")
    print("\n")
import OpenAI from "openai";
import { createInterface } from 'readline/promises';

// URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

const BASE_URL = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1";
// Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
const openai = new OpenAI({
    apiKey: process.env.DASHSCOPE_API_KEY,
    baseURL: BASE_URL
});

async function getResponse(messages) {
    try {
        const completion = await openai.chat.completions.create({
            // Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
            model: "qwen-plus",
            messages: messages,
        });
        return completion.choices[0].message.content;
    } catch (error) {
        console.error("Error fetching response:", error);
        throw error;  // Melempar kembali exception untuk ditangani oleh lapisan atas
    }
}

// Inisialisasi array messages
const messages = [
    {
        "role": "system",
        "content": `Anda adalah tenaga penjual di toko ponsel Bailian. Tugas Anda adalah merekomendasikan ponsel kepada pengguna. Ponsel memiliki dua parameter: ukuran layar (termasuk 6,1 inci, 6,5 inci, dan 6,7 inci) dan resolusi (termasuk 2K dan 4K).
        Anda hanya boleh menanyakan satu parameter kepada pengguna dalam satu waktu. Jika pengguna tidak memberikan informasi lengkap, Anda perlu mengajukan pertanyaan lanjutan untuk mendapatkan parameter yang hilang. Ketika semua parameter telah dikumpulkan, Anda harus mengatakan: Saya telah memahami maksud pembelian Anda. Mohon tunggu.`,
    }
];

let assistant_output = "Selamat datang di toko ponsel Bailian. Ukuran layar seperti apa yang Anda cari?";
console.log(assistant_output);

const readline = createInterface({
    input: process.stdin,
    output: process.stdout
});

(async () => {
    while (!assistant_output.includes("Saya telah memahami maksud pembelian Anda")) {
        const user_input = await readline.question("Silakan masukkan: ");
        messages.push({ role: "user", content: user_input});
        try {
            const response = await getResponse(messages);
            assistant_output = response;
            messages.push({ role: "assistant", content: assistant_output });
            console.log(assistant_output);
            console.log("\n");
        } catch (error) {
            console.error("Terjadi kesalahan saat mengambil respons:", error);
        }
    }
    readline.close();
})();
# ======= Penting =======
# Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key

# === Hapus komentar ini sebelum eksekusi ===

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.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": "Anda adalah asisten yang membantu."
        },
        {
            "role": "user",
            "content": "Halo"
        },
        {
            "role": "assistant",
            "content": "Halo, saya Qwen."
        },
        {
            "role": "user",
            "content": "Apa yang bisa Anda lakukan?"
        }
    ]
}'

DashScope

Python

Kode contoh menyediakan contoh tenaga penjual toko ponsel yang melakukan percakapan multi-putaran dengan pelanggan untuk menentukan maksud pembelian mereka lalu mengakhiri sesi.

import os
from dashscope import Generation
import dashscope
# URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

def get_response(messages):
    response = Generation.call(
        # Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
        # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx",
        api_key=os.getenv("DASHSCOPE_API_KEY"),
        # Untuk daftar model, lihat https://www.alibabacloud.com/help/en/model-studio/getting-started/models
        model="qwen-plus",
        messages=messages,
        result_format="message",
    )
    return response

messages = [
    {
        "role": "system",
        "content": """Anda adalah tenaga penjual di toko ponsel Bailian. Tugas Anda adalah merekomendasikan ponsel kepada pengguna. Ponsel memiliki dua parameter: ukuran layar (termasuk 6,1 inci, 6,5 inci, dan 6,7 inci) dan resolusi (termasuk 2K dan 4K).
        Anda hanya boleh menanyakan satu parameter kepada pengguna dalam satu waktu. Jika pengguna tidak memberikan informasi lengkap, Anda perlu mengajukan pertanyaan lanjutan untuk mendapatkan parameter yang hilang. Ketika semua parameter telah dikumpulkan, Anda harus mengatakan: Saya telah memahami maksud pembelian Anda. Mohon tunggu.""",
    }
]

assistant_output = "Selamat datang di toko ponsel Bailian. Ukuran layar seperti apa yang Anda cari?"
print(f"Output model: {assistant_output}\n")
while "Saya telah memahami maksud pembelian Anda" not in assistant_output:
    user_input = input("Silakan masukkan: ")
    # Tambahkan pertanyaan pengguna ke daftar messages
    messages.append({"role": "user", "content": user_input})
    assistant_output = get_response(messages).output.choices[0].message.content
    # Tambahkan respons model ke daftar messages
    messages.append({"role": "assistant", "content": assistant_output})
    print(f"Output model: {assistant_output}")
    print("\n")

Java

import java.util.ArrayList;
import java.util.List;
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 java.util.Scanner;
import com.alibaba.dashscope.protocol.Protocol;

public class Main {
    public static GenerationParam createGenerationParam(List<Message> messages) {
        return GenerationParam.builder()
                // Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
                // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model 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(messages)
                .resultFormat(GenerationParam.ResultFormat.MESSAGE)
                .build();
    }
    public static GenerationResult callGenerationWithMessages(GenerationParam param) throws ApiException, NoApiKeyException, InputRequiredException {
        // URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

        Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1");
        return gen.call(param);
    }
    public static void main(String[] args) {
        try {
            List<Message> messages = new ArrayList<>();
            messages.add(createMessage(Role.SYSTEM, "Anda adalah asisten yang membantu."));
            for (int i = 0; i < 3;i++) {
                Scanner scanner = new Scanner(System.in);
                System.out.print("Silakan masukkan: ");
                String userInput = scanner.nextLine();
                if ("exit".equalsIgnoreCase(userInput)) {
                    break;
                }
                messages.add(createMessage(Role.USER, userInput));
                GenerationParam param = createGenerationParam(messages);
                GenerationResult result = callGenerationWithMessages(param);
                System.out.println("Output model: "+result.getOutput().getChoices().get(0).getMessage().getContent());
                messages.add(result.getOutput().getChoices().get(0).getMessage());
            }
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            e.printStackTrace();
        }
        System.exit(0);
    }
    private static Message createMessage(Role role, String content) {
        return Message.builder().role(role.getValue()).content(content).build();
    }
}

curl

# ======= Penting =======
# Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key

# === Hapus komentar ini sebelum eksekusi ===

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.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": "Anda adalah asisten yang membantu."
            },
            {
                "role": "user",
                "content": "Halo"
            },
            {
                "role": "assistant",
                "content": "Halo, saya Qwen."
            },
            {
                "role": "user",
                "content": "Apa yang bisa Anda lakukan?"
            }
        ]
    }
}'

Untuk model multimodal

Model multimodal mendukung gambar dan audio dalam percakapan. Implementasinya berbeda dari model teks sebagai berikut:

  • Konstruksi pesan pengguna: Pesan pengguna untuk model multimodal dapat berisi informasi multimodal, seperti gambar dan audio, selain teks.
  • Antarmuka SDK DashScope: Saat menggunakan SDK Python DashScope, panggil antarmuka MultiModalConversation. Saat menggunakan SDK Java DashScope, panggil kelas MultiModalConversation.

Untuk model multimodal, lihat: Pemahaman gambar dan video, dan Kimi. Untuk Qwen-Omni, lihat Non-real-time (Qwen-Omni). Qwen-VL-OCR dan Qwen3-Omni-Captioner dirancang untuk tugas single-turn spesifik dan tidak mendukung percakapan multi-putaran.

Kompatibel dengan OpenAI

from openai import OpenAI
import os

client = OpenAI(
    # Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx"
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)
messages = [
        {"role": "user",
         "content": [
            {
                "type": "image_url",
                "image_url": {
                    "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"
                },
            },
            {"type": "text", "text": "Produk apa saja yang ditampilkan dalam gambar ini?"},
        ],
    }
]
completion = client.chat.completions.create(
    model="qwen3-vl-plus",  #  Anda dapat mengganti ini dengan model multimodal lain dan menyesuaikan messages sesuai kebutuhan
    messages=messages,
    )
print(f"Output putaran pertama: {completion.choices[0].message.content}")

assistant_message = completion.choices[0].message
messages.append(assistant_message.model_dump())
messages.append({
        "role": "user",
        "content": [
        {
            "type": "text",
            "text": "Gaya apa itu?"
        }
        ]
    })
completion = client.chat.completions.create(
    model="qwen3-vl-plus",
    messages=messages,
    )

print(f"Output putaran kedua: {completion.choices[0].message.content}")
import OpenAI from "openai";

const openai = new OpenAI(
    {
        // Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
        // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: apiKey: "sk-xxx",
        apiKey: process.env.DASHSCOPE_API_KEY,
        // URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

        baseURL: "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
    }
);

let messages = [
    {
    role: "user", content: [
        { type: "image_url", image_url: { "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png" } },
        { type: "text", text: "Produk apa saja yang ditampilkan dalam gambar ini?" },
    ]
}]
async function main() {
    let response = await openai.chat.completions.create({
        model: "qwen3-vl-plus",   // Anda dapat mengganti ini dengan model multimodal lain dan menyesuaikan messages sesuai kebutuhan
        messages: messages
    });
    console.log(`Output putaran pertama: ${response.choices[0].message.content}`);
    messages.push(response.choices[0].message);
    messages.push({"role": "user", "content": "Tulis puisi yang menggambarkan adegan ini"});
    response = await openai.chat.completions.create({
        model: "qwen3-vl-plus",
        messages: messages
    });
    console.log(`Output putaran kedua: ${response.choices[0].message.content}`);
}

main()
# ======= Penting =======

# Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# === Hapus komentar ini sebelum eksekusi ===

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "model": "qwen3-vl-plus",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"
          }
        },
        {
          "type": "text",
          "text": "Produk apa saja yang ditampilkan dalam gambar ini?"
        }
      ]
    },
    {
      "role": "assistant",
      "content": [
        {
          "type": "text",
          "text": "Gambar tersebut menampilkan tiga item: sepasang overall biru muda, kaus lengan pendek bergaris biru-putih, dan sepasang sepatu kets putih."
        }
      ]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Gaya apa itu?"
        }
      ]
    }
  ]
}'

DashScope

import os
from dashscope import MultiModalConversation
import dashscope
# URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

dashscope.base_http_api_url = 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1'

messages = [
    {
        "role": "user",
        "content": [
            {
                "image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"
            },
            {"text": "Produk apa saja yang ditampilkan dalam gambar ini?"},
        ],
    }
]
response = MultiModalConversation.call(
    # Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    model='qwen3-vl-plus',  #  Anda dapat mengganti ini dengan model multimodal lain dan menyesuaikan messages sesuai kebutuhan
    messages=messages
    )

print(f"Output model putaran pertama {response.output.choices[0].message.content[0]['text']}")
messages.append(response['output']['choices'][0]['message'])
user_msg = {"role": "user", "content": [{"text": "Gaya apa itu?"}]}
messages.append(user_msg)
response = MultiModalConversation.call(
    # Jika variabel lingkungan tidak dikonfigurasi, harap ganti baris berikut dengan: api_key="sk-xxx",
    api_key=os.getenv('DASHSCOPE_API_KEY'),
    model='qwen3-vl-plus',
    messages=messages
    )

print(f"Output model putaran kedua {response.output.choices[0].message.content[0]['text']}")
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collections;
import java.util.List;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversation;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationParam;
import com.alibaba.dashscope.aigc.multimodalconversation.MultiModalConversationResult;
import com.alibaba.dashscope.common.MultiModalMessage;
import com.alibaba.dashscope.common.Role;
import com.alibaba.dashscope.exception.ApiException;
import com.alibaba.dashscope.exception.NoApiKeyException;
import com.alibaba.dashscope.exception.UploadFileException;
import com.alibaba.dashscope.utils.Constants;

public class Main {
    static {
        // URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

        Constants.baseHttpApiUrl="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1";
    }
    private static final String modelName = "qwen3-vl-plus";  //  Anda dapat mengganti ini dengan model multimodal lain dan menyesuaikan messages sesuai kebutuhan
    public static void MultiRoundConversationCall() throws ApiException, NoApiKeyException, UploadFileException {
        MultiModalConversation conv = new MultiModalConversation();
        MultiModalMessage userMessage = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(Collections.singletonMap("image", "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"),
                        Collections.singletonMap("text", "Produk apa saja yang ditampilkan dalam gambar ini?"))).build();
        List<MultiModalMessage> messages = new ArrayList<>();
        messages.add(userMessage);
        MultiModalConversationParam param = MultiModalConversationParam.builder()
                // Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
                // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: .apiKey("sk-xxx")
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                .model(modelName)
                .messages(messages)
                .build();
        MultiModalConversationResult result = conv.call(param);
        System.out.println("Output putaran pertama: "+result.getOutput().getChoices().get(0).getMessage().getContent().get(0).get("text"));        // tambahkan hasil ke percakapan
        messages.add(result.getOutput().getChoices().get(0).getMessage());
        MultiModalMessage msg = MultiModalMessage.builder().role(Role.USER.getValue())
                .content(Arrays.asList(Collections.singletonMap("text", "Gaya apa itu?"))).build();
        messages.add(msg);
        param.setMessages((List)messages);
        result = conv.call(param);
        System.out.println("Output putaran kedua: "+result.getOutput().getChoices().get(0).getMessage().getContent().get(0).get("text"));    }

    public static void main(String[] args) {
        try {
            MultiRoundConversationCall();
        } catch (ApiException | NoApiKeyException | UploadFileException e) {
            System.out.println(e.getMessage());
        }
        System.exit(0);
    }
}
# ======= Penting =======
# Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key

# === Hapus komentar ini sebelum eksekusi ===

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
    "model": "qwen3-vl-plus",
    "input":{
        "messages":[
            {
                "role": "user",
                "content": [
                    {"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251031/ownrof/f26d201b1e3f4e62ab4a1fc82dd5c9bb.png"},
                    {"text": "Produk apa saja yang ditampilkan dalam gambar ini?"}
                ]
            },
            {
                "role": "assistant",
                "content": [
                    {"text": "Gambar tersebut menampilkan tiga item: sepasang overall biru muda, kaus lengan pendek bergaris biru-putih, dan sepasang sepatu kets putih."}
                ]
            },
            {
                "role": "user",
                "content": [
                    {"text": "Gaya apa itu?"}
                ]
            }
        ]
    }
}'

Untuk model berpikir

Model berpikir mengembalikan reasoning_content (proses berpikir) dan content (respons). Saat memperbarui messages, simpan hanya content dan abaikan reasoning_content.

[
    {"role": "user", "content": "Rekomendasikan film fiksi ilmiah tentang eksplorasi luar angkasa."},
    {"role": "assistant", "content": "Saya merekomendasikan 'XXX'. Ini adalah karya fiksi ilmiah klasik."}, # Jangan tambahkan field reasoning_content saat menambahkan ke konteks
    {"role": "user", "content": "Siapa sutradara film ini?"}
]

Untuk informasi lebih lanjut tentang model berpikir, lihat Pemikiran mendalam, Pemahaman gambar dan video, dan Penalaran visual.

Untuk informasi lebih lanjut tentang mengimplementasikan percakapan multi-putaran dengan Qwen3-Omni-Flash (mode berpikir), lihat omni-modal.

Kompatibel dengan OpenAI

Python

Kode contoh

from openai import OpenAI
import os

# Inisialisasi klien OpenAI
client = OpenAI(
    # Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx"
    api_key = os.getenv("DASHSCOPE_API_KEY"),
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

messages = []
conversation_idx = 1
while True:
    reasoning_content = ""  # Definisikan proses berpikir lengkap
    answer_content = ""     # Definisikan respons lengkap
    is_answering = False   # Tentukan apakah akan mengakhiri proses berpikir dan mulai merespons
    print("="*20+f"Putaran Percakapan {conversation_idx}"+"="*20)
    conversation_idx += 1
    user_input = input("Masukkan pesan Anda (ketik 'exit' untuk mengakhiri): ")
    # Masukkan 'exit' untuk mengakhiri percakapan multi-putaran dan menghindari loop tak berujung
    if user_input.strip().lower() == "exit":
        print("Percakapan diakhiri.")
        break
    user_msg = {"role": "user", "content": user_input}
    messages.append(user_msg)
    # Buat permintaan chat completion
    completion = client.chat.completions.create(
        # Anda dapat mengganti ini dengan model pemikiran mendalam lain sesuai kebutuhan
        model="qwen-plus",
        messages=messages,
        extra_body={"enable_thinking": True},
        stream=True,
        # stream_options={
        #     "include_usage": True
        # }
    )
    print("\n" + "=" * 20 + "Proses Berpikir" + "=" * 20 + "\n")
    for chunk in completion:
        # Jika chunk.choices kosong, cetak penggunaan
        if not chunk.choices:
            print("\nPenggunaan:")
            print(chunk.usage)
        else:
            delta = chunk.choices[0].delta
            # Cetak proses berpikir
            if hasattr(delta, 'reasoning_content') and delta.reasoning_content != None:
                print(delta.reasoning_content, end='', flush=True)
                reasoning_content += delta.reasoning_content
            else:
                # Mulai merespons
                if delta.content != "" and is_answering is False:
                    print("\n" + "=" * 20 + "Respons Lengkap" + "=" * 20 + "\n")
                    is_answering = True
                # Cetak proses respons
                print(delta.content, end='', flush=True)
                answer_content += delta.content
    # Tambahkan konten respons model ke konteks
    messages.append({"role": "assistant", "content": answer_content})
    print("\n")

Node.js

Kode contoh

import OpenAI from "openai";
import process from 'process';
import readline from 'readline/promises';

// Inisialisasi antarmuka readline
const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout
});

// Inisialisasi klien openai
const openai = new OpenAI({
    // Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
    apiKey: process.env.DASHSCOPE_API_KEY, // Baca dari variabel lingkungan
    baseURL: 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1'
});

let reasoningContent = '';
let answerContent = '';
let isAnswering = false;
let messages = [];
let conversationIdx = 1;

async function main() {
    while (true) {
        console.log("=".repeat(20) + `Putaran Percakapan ${conversationIdx}` + "=".repeat(20));
        conversationIdx++;

        // Baca input pengguna
        const userInput = await rl.question("Masukkan pesan Anda (ketik 'exit' untuk mengakhiri): ");
        // Masukkan 'exit' untuk mengakhiri percakapan multi-putaran dan menghindari loop tak berujung
        if (userInput.trim().toLowerCase() === "exit") {
            console.log("Percakapan diakhiri.");
            rl.close();
            break;
        }
        messages.push({ role: 'user', content: userInput });

        // Reset state
        reasoningContent = '';
        answerContent = '';
        isAnswering = false;

        try {
            const stream = await openai.chat.completions.create({
                // Anda dapat mengganti ini dengan model pemikiran mendalam lain sesuai kebutuhan
                model: 'qwen-plus',
                messages: messages,
                enable_thinking: true,
                stream: true,
                // stream_options:{
                //     include_usage: true
                // }
            });

            console.log("\n" + "=".repeat(20) + "Proses Berpikir" + "=".repeat(20) + "\n");

            for await (const chunk of stream) {
                if (!chunk.choices?.length) {
                    console.log('\nPenggunaan:');
                    console.log(chunk.usage);
                    continue;
                }

                const delta = chunk.choices[0].delta

                // Proses proses berpikir
                if (delta.reasoning_content) {
                    process.stdout.write(delta.reasoning_content);
                    reasoningContent += delta.reasoning_content;
                }

                // Proses respons formal
                if (delta.content) {
                    if (!isAnswering) {
                        console.log('\n' + "=".repeat(20) + "Respons Lengkap" + "=".repeat(20) + "\n");
                        isAnswering = true;
                    }
                    process.stdout.write(delta.content);
                    answerContent += delta.content;
                }
            }

            // Tambahkan respons lengkap ke riwayat pesan
            messages.push({ role: 'assistant', content: answerContent });
            console.log("\n");

        } catch (error) {
            console.error('Kesalahan:', error);
        }
    }
}

// Jalankan program
main().catch(console.error);

HTTP

Kode contoh

curl

# ======= Penting =======

# Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key
# === Hapus komentar ini sebelum eksekusi ===

curl -X POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/chat/completions \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen-plus",
    "messages": [
        {
            "role": "user",
            "content": "Halo"
        },
        {
            "role": "assistant",
            "content": "Halo! Senang bertemu Anda. Ada yang bisa saya bantu?"
        },
        {
            "role": "user",
            "content": "Siapa Anda?"
        }
    ],
    "stream": true,
    "stream_options": {
        "include_usage": true
    },
    "enable_thinking": true
}'

DashScope

Python

Kode contoh

import os
import dashscope
# URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

dashscope.base_http_api_url = "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/"

messages = []
conversation_idx = 1
while True:
    print("=" * 20 + f"Putaran Percakapan {conversation_idx}" + "=" * 20)
    conversation_idx += 1
    user_input = input("Masukkan pesan Anda (ketik 'exit' untuk mengakhiri): ")
    # Masukkan 'exit' untuk mengakhiri percakapan multi-putaran dan menghindari loop tak berujung
    if user_input.strip().lower() == "exit":
        print("Percakapan diakhiri.")
        break
    user_msg = {"role": "user", "content": user_input}
    messages.append(user_msg)
    response = dashscope.Generation.call(
        # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: api_key="sk-xxx",
        api_key=os.getenv('DASHSCOPE_API_KEY'),
         # Contoh ini menggunakan qwen-plus. Anda dapat menggantinya dengan model pemikiran mendalam lain sesuai kebutuhan
        model="qwen-plus",
        messages=messages,
        enable_thinking=True,
        result_format="message",
        stream=True,
        incremental_output=True
    )
    # Definisikan proses berpikir lengkap
    reasoning_content = ""
    # Definisikan respons lengkap
    answer_content = ""
    # Tentukan apakah akan mengakhiri proses berpikir dan mulai merespons
    is_answering = False
    print("=" * 20 + "Proses Berpikir" + "=" * 20)
    for chunk in response:
        # Jika proses berpikir dan respons keduanya kosong, abaikan
        if (chunk.output.choices[0].message.content == "" and
            chunk.output.choices[0].message.reasoning_content == ""):
            pass
        else:
            # Jika saat ini sedang dalam proses berpikir
            if (chunk.output.choices[0].message.reasoning_content != "" and
                chunk.output.choices[0].message.content == ""):
                print(chunk.output.choices[0].message.reasoning_content, end="",flush=True)
                reasoning_content += chunk.output.choices[0].message.reasoning_content
            # Jika saat ini sedang dalam respons
            elif chunk.output.choices[0].message.content != "":
                if not is_answering:
                    print("\n" + "=" * 20 + "Respons Lengkap" + "=" * 20)
                    is_answering = True
                print(chunk.output.choices[0].message.content, end="",flush=True)
                answer_content += chunk.output.choices[0].message.content
    # Tambahkan konten respons model ke konteks
    messages.append({"role": "assistant", "content": answer_content})
    print("\n")
    # Untuk mencetak proses berpikir lengkap dan respons lengkap, hapus komentar dan jalankan kode berikut
    # print("=" * 20 + "Proses Berpikir Lengkap" + "=" * 20 + "\n")
    # print(f"{reasoning_content}")
    # print("=" * 20 + "Respons Lengkap" + "=" * 20 + "\n")
    # print(f"{answer_content}")

Java

Kode contoh

// Versi SDK DashScope >= 2.19.4
import java.util.Arrays;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
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 io.reactivex.Flowable;
import java.lang.System;
import java.util.List;
import com.alibaba.dashscope.protocol.Protocol;

public class Main {
    private static final Logger logger = LoggerFactory.getLogger(Main.class);
    private static StringBuilder reasoningContent = new StringBuilder();
    private static StringBuilder finalContent = new StringBuilder();
    private static boolean isFirstPrint = true;

    private static void handleGenerationResult(GenerationResult message) {
        if (message != null && message.getOutput() != null
            && message.getOutput().getChoices() != null
            && !message.getOutput().getChoices().isEmpty()
            && message.getOutput().getChoices().get(0) != null
            && message.getOutput().getChoices().get(0).getMessage() != null) {

            String reasoning = message.getOutput().getChoices().get(0).getMessage().getReasoningContent();
            String content = message.getOutput().getChoices().get(0).getMessage().getContent();

            if (reasoning != null && !reasoning.isEmpty()) {
                reasoningContent.append(reasoning);
                if (isFirstPrint) {
                    System.out.println("====================Proses Berpikir====================");
                    isFirstPrint = false;
                }
                System.out.print(reasoning);
            }

            if (content != null && !content.isEmpty()) {
                finalContent.append(content);
                if (!isFirstPrint) {
                    System.out.println("\n====================Respons Lengkap====================");
                    isFirstPrint = true;
                }
                System.out.print(content);
            }
        }
    }

    private static GenerationParam buildGenerationParam(List<Message> messages) {
        return GenerationParam.builder()
                // Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan Kunci API Studio Model Anda: .apiKey("sk-xxx")
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Contoh ini menggunakan qwen-plus. Anda dapat menggantinya dengan nama model lain sesuai kebutuhan.
                .model("qwen-plus")
                .enableThinking(true)
                .messages(messages)
                .incrementalOutput(true)
                .resultFormat("message")
                .build();
    }

    public static void streamCallWithMessage(Generation gen, List<Message> messages)
            throws NoApiKeyException, ApiException, InputRequiredException {
        GenerationParam param = buildGenerationParam(messages);
        Flowable<GenerationResult> result = gen.streamCall(param);
        result.doOnError(throwable -> logger.error("Terjadi kesalahan dalam pemrosesan aliran: {}", throwable.getMessage(), throwable))
              .blockingForEach(Main::handleGenerationResult);
    }

    public static void main(String[] args) {
        try {
            // URL wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.

            Generation gen = new Generation(Protocol.HTTP.getValue(), "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1");
            Message userMsg1 = Message.builder()
                    .role(Role.USER.getValue())
                    .content("Halo")
                    .build();
            Message assistantMsg = Message.builder()
                    .role(Role.ASSISTANT.getValue())
                    .content("Halo! Senang bertemu Anda. Ada yang bisa saya bantu?")
                    .build();
            Message userMsg2 = Message.builder()
                    .role(Role.USER.getValue())
                    .content("Siapa Anda")
                    .build();
            List<Message> messages = Arrays.asList(userMsg1, assistantMsg, userMsg2);
            streamCallWithMessage(gen, messages);
        } catch (ApiException | NoApiKeyException | InputRequiredException e) {
            logger.error("Terjadi exception: {}", e.getMessage(), e);
        } catch (Exception e) {
            logger.error("Terjadi kesalahan tak terduga: {}", e.getMessage(), e);
        } finally {
            // Pastikan program keluar secara normal
            System.exit(0);
        }
    }
}

HTTP

Kode contoh

curl

# ======= Penting =======
# Kunci API bervariasi berdasarkan wilayah. Untuk mendapatkan kunci API, lihat https://www.alibabacloud.com/help/en/model-studio/get-api-key

# === Hapus komentar ini sebelum eksekusi ===
curl -X POST "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation" \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-H "X-DashScope-SSE: enable" \
-d '{
    "model": "qwen-plus",
    "input":{
        "messages":[
            {
                "role": "user",
                "content": "Halo"
            },
            {
                "role": "assistant",
                "content": "Halo! Senang bertemu Anda. Ada yang bisa saya bantu?"
            },
            {
                "role": "user",
                "content": "Siapa Anda?"
            }
        ]
    },
    "parameters":{
        "enable_thinking": true,
        "incremental_output": true,
        "result_format": "message"
    }
}'

Menerapkan ke produksi

Percakapan multi-putaran dapat mengonsumsi banyak token dan melebihi panjang konteks model, menyebabkan kesalahan. Gunakan strategi berikut untuk mengelola konteks dan mengendalikan biaya.

1. Manajemen konteks

Array messages bertambah panjang setiap putaran dan dapat melebihi batas token model. Gunakan metode berikut untuk mengelola panjang konteks:

1.1. Pemotongan konteks

Pertahankan hanya N putaran terbaru ketika riwayat menjadi terlalu panjang. Metode ini mudah diimplementasikan tetapi kehilangan informasi percakapan sebelumnya.

1.2. Ringkasan bergulir

Buat ringkasan konteks seiring berjalannya percakapan untuk memadatkan riwayat dan mengontrol panjang tanpa kehilangan informasi inti:

a. Ketika riwayat mencapai 70% dari panjang konteks maksimum, ekstrak bagian awal (misalnya separuh pertama) dan buat panggilan API terpisah untuk menghasilkan "ringkasan memori".

b. Pada permintaan berikutnya, ganti riwayat panjang dengan "ringkasan memori" dan tambahkan putaran terbaru.

1.3. Pengambilan berbasis vektor

Ringkasan bergulir dapat kehilangan beberapa informasi. Untuk memungkinkan model mengingat kembali informasi relevan dari riwayat percakapan yang panjang, gunakan pengambilan berdasarkan permintaan alih-alih meneruskan konteks secara linear:

a. Setelah setiap putaran percakapan, simpan percakapan dalam database vektor.

b. Ketika pengguna mengajukan pertanyaan, ambil catatan percakapan yang relevan berdasarkan kemiripan.

c. Gabungkan catatan percakapan yang diambil dengan input pengguna terbaru dan kirim konten gabungan tersebut ke model.

2. Pengendalian biaya

Token input meningkat setiap putaran, sehingga secara signifikan menaikkan biaya. Gunakan strategi manajemen biaya berikut:

2.1. Kurangi token input

Gunakan strategi manajemen konteks yang dijelaskan sebelumnya untuk mengurangi token input dan menurunkan biaya.

2.2. Gunakan model yang mendukung cache konteks

Pada permintaan multi-putaran, array messages diproses dan ditagih berulang kali. Model Studio menyediakan cache konteks untuk model seperti qwen-max dan qwen-plus, yang mengurangi biaya dan meningkatkan kecepatan respons. Utamakan model yang mendukung cache konteks.

Cache konteks diaktifkan secara otomatis—tidak diperlukan perubahan kode.

Kode kesalahan

Jika pemanggilan model gagal dan mengembalikan pesan kesalahan, lihat Kode kesalahan untuk penyelesaian.