Skip to main content
Generasi teks

Mode parsial

Untuk skenario seperti penyelesaian kode dan kelanjutan teks, Anda dapat menghasilkan konten baru yang dimulai dari fragmen teks yang sudah ada (awalan). Mode Parsial memastikan output model terhubung secara mulus dengan awalan tersebut guna meningkatkan akurasi dan kontrol.

Cara kerja

Untuk menggunakan Mode Parsial, konfigurasikan larik messages. Pada pesan terakhir dalam larik tersebut, atur role ke assistant dan masukkan awalan di bidang content. Anda juga harus menetapkan parameter "partial": true pada pesan tersebut. Format messages adalah sebagai berikut: 
[
    {
        "role": "user",
        "content": "Lengkapi fungsi Fibonacci ini. Jangan tambahkan apa pun selain itu."
    },
    {
        "role": "assistant",
        "content": "def calculate_fibonacci(n):\n    if n <= 1:\n        return n\n    else:\n",
        "partial": true
    }
]
Model kemudian akan menghasilkan teks mulai dari awalan yang telah ditentukan.

Model yang didukung

  • Model generasi teks
    • Qwen-Max (mode non-thinking): seri Qwen3.7-Max, seri Qwen3.6-Max, seri Qwen3-Max, seri Qwen-Max
    • Qwen-Plus (mode non-thinking): seri Qwen3.7-Plus, seri Qwen3.6-Plus, seri Qwen3.5-Plus, seri Qwen-Plus
    • Qwen-Flash (mode non-thinking): seri Qwen3.7-Flash, seri Qwen3.6-Flash, seri Qwen3.5-Flash, seri Qwen-Flash
    • Qwen-Coder: seri Qwen3-Coder, seri Qwen2.5-Coder
    • Qwen-Turbo (mode non-thinking): seri Qwen-Turbo
    • Seri open source Qwen3.6 (mode non-thinking)
    • Seri open source Qwen3.5 (mode non-thinking)
    • Seri open-source Qwen3 (mode tanpa pemikiran)
    • Seri open source Qwen2.5
  • Model multimodal
    • Qwen-VL: seri Qwen3-VL-Plus, seri Qwen3-VL-Flash, seri Qwen-VL-Max, seri Qwen-VL-Plus
    • Seri open source Qwen3-VL (mode non-thinking)

Mulai

Prasyarat

Sebelum memulai, dapatkan Kunci API dan tetapkan Kunci API sebagai Variabel lingkungan. Jika Anda memanggil layanan menggunakan SDK OpenAI atau SDK DashScope, Anda harus menginstal SDK. Jika Anda anggota sub-ruang kerja, pastikan super administrator telah memberikan akses model ke ruang kerja Anda.
SDK DashScope Java tidak didukung.

Kode contoh

Penyelesaian kode merupakan kasus penggunaan utama Mode Parsial. Contoh berikut menunjukkan cara melengkapi fungsi Python.
  • Kompatibel dengan OpenAI
  • DashScope
  • Python
  • Node.js
  • curl
import os
from openai import OpenAI

# 1. Inisialisasi client
client = OpenAI(
    # Kunci API berbeda berdasarkan Wilayah. Dapatkan Kunci API Anda: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    # Jika tidak diatur di lingkungan, ganti di sini dengan Kunci API Anda
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.
    # Untuk wilayah Beijing gunakan: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
# 2. Tentukan awalan kode yang akan dilengkapi
prefix = """def calculate_fibonacci(n):
    if n <= 1:
        return n
    else:
"""

# 3. Buat permintaan Mode Parsial
# Catatan: Pesan terakhir dalam larik messages harus memiliki role "assistant" dan menyertakan "partial": True
completion = client.chat.completions.create(
    model="qwen3.8-max",
    messages=[
        {"role": "user", "content": "Lengkapi fungsi Fibonacci ini. Jangan tambahkan apa pun selain itu."},
        {"role": "assistant", "content": prefix, "partial": True},
    ],
)

# 4. Gabungkan secara manual awalan dan konten yang dihasilkan model
generated_code = completion.choices[0].message.content
complete_code = prefix + generated_code

print(complete_code)

Respons 

def calculate_fibonacci(n):
    if n <= 1:
        return n
    else:
        return calculate_fibonacci(n-1) + calculate_fibonacci(n-2)

Kasus penggunaan

Kirim gambar atau video

Model Qwen-VL mendukung Mode Parsial dengan data gambar atau video, yang berguna untuk skenario seperti deskripsi produk, unggahan media sosial, artikel berita, dan penulisan kreatif.
  • Kompatibel dengan OpenAI
  • DashScope
  • Python
  • Node.js
  • curl
import os
from openai import OpenAI

client = OpenAI(
    # Jika tidak diatur di lingkungan, ganti baris berikut dengan: api_key="sk-xxx",
    # Kunci API berbeda berdasarkan Wilayah. Dapatkan Kunci API Anda: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.
    # Untuk wilayah Beijing gunakan: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1"
)

completion = client.chat.completions.create(
    model="qwen3-vl-plus",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://img.alicdn.com/imgextra/i3/O1CN01zFX2Bs1Q0f9pESgPC_!!6000000001914-2-tps-450-450.png"
                    },
                },
                {"type": "text", "text": "Saya ingin memposting ini di media sosial. Bantu saya menulis keterangan."},
            ],
        },
        {
            "role": "assistant",
            "content": "Hari ini saya menemukan sebuah kafe tersembunyi",
            "partial": True,
        },
    ],
)
print(completion.choices[0].message.content)

Respons 

— tiramisu di sini benar-benar nikmat! Setiap gigitan memberikan harmoni sempurna antara kopi dan krim. Kebahagiaan murni! #FoodShare #Tiramisu #CoffeeTime

Semoga Anda menyukai keterangan ini! Beri tahu saya jika perlu perubahan.

Lanjutkan dari output yang belum lengkap

Jika nilai max_tokens terlalu kecil, LLM mungkin mengembalikan konten yang belum lengkap. Gunakan Mode Parsial untuk melanjutkan dari titik tersebut dan memastikan output semantik lengkap.
  • Kompatibel dengan OpenAI
  • DashScope
  • Python
  • Node.js
import os
from openai import OpenAI

client = OpenAI(
    # Kunci API berbeda berdasarkan Wilayah. Dapatkan Kunci API Anda: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    # Jika tidak diatur di lingkungan, ganti di sini dengan Kunci API Anda
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # URL berikut untuk wilayah Singapura. Ganti {WorkspaceId} dengan ID ruang kerja aktual Anda. URL bervariasi berdasarkan wilayah.
    # Untuk wilayah Beijing gunakan: https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)

def chat_completion(messages,max_tokens=None):
    response = client.chat.completions.create(
        model="qwen-plus",
        messages=messages,
        max_tokens=max_tokens
    )
    print(f"### Alasan penghentian generasi: {response.choices[0].finish_reason}")

    return response.choices[0].message.content

# Contoh penggunaan
messages = [{"role": "user", "content": "Tulis cerita fiksi ilmiah pendek"}]

# Panggilan pertama dengan max_tokens diatur ke 40
first_content = chat_completion(messages, max_tokens=40)
print(first_content)
# Tambahkan respons pertama sebagai pesan assistant dan atur partial=True
messages.append({"role": "assistant", "content": first_content, "partial": True})

# Panggilan kedua
second_content = chat_completion(messages)
print("### Konten lengkap:")
print(first_content+second_content)

Respons

length: Batas max_tokens tercapai. stop: Model selesai secara alami atau mencapai kata henti dari parameter stop.
### Alasan penghentian generasi: length
**"Akhir Kenangan"**

Di masa depan yang jauh, Bumi tidak lagi layak huni bagi manusia. Atmosfer tercemar, lautan mengering, dan kota-kota menjadi reruntuhan. Manusia bermigrasi ke planet layak huni bernama "Eden," dengan langit biru, udara segar, dan sumber daya tak terbatas.

Namun, Eden bukanlah surga sejati. Tempat ini tidak menyimpan sejarah manusia, tidak ada masa lalu, dan tidak ada kenangan.

...
**"Jika kita lupa siapa diri kita, apakah kita masih manusia?"**

— Akhir —

Penagihan

Penagihan mencakup token input dan output. Awalan dihitung sebagai bagian dari token input.

Kode error

Jika pemanggilan model gagal dan mengembalikan pesan error, lihat Kode error untuk resolusi.
Memulai
Billing
Rencana Token (Team Edition)
Model playground
Klien dan Alat Pengembang
Inferensi Model
Fine-tuning Model
Deployment
Evaluasi
Statistik dan Pemantauan
Asset Center
Keamanan dan Kepatuhan
Praktik terbaik
Dukungan layanan
Log Perubahan