Cara menggunakan API LLM di QwenPaw - Alibaba Cloud Model Studio

QwenPaw (sebelumnya CoPaw) adalah asisten AI pribadi open-source dari tim AgentScope yang mendukung penerapan lokal dan cloud serta terintegrasi dengan Alibaba Cloud Model Studio melalui Token Plan Team Edition, Coding Plan, atau Pay-as-you-go.

Instal QwenPaw

Gunakan paket pip atau skrip instalasi satu klik. Untuk Docker, aplikasi desktop, atau runtime online ModelScope, lihat dokumentasi resmi QwenPaw.

pip install

Memerlukan Python 3.10–3.13:

pip install qwenpaw
qwenpaw init --defaults
qwenpaw app

Skrip satu klik

Skrip ini menginstal uv, membuat lingkungan virtual, dan mengunduh dependensi secara otomatis tanpa memerlukan pengaturan Python manual. Pilih perintah sesuai sistem operasi Anda:

macOS / Linux:

curl -fsSL https://qwenpaw.agentscope.io/install.sh | bash

Windows (CMD):

curl -fsSL https://qwenpaw.agentscope.io/install.bat -o install.bat && install.bat

Windows (PowerShell):

irm https://qwenpaw.agentscope.io/install.ps1 | iex

Setelah instalasi selesai, jalankan perintah berikut di terminal baru:

qwenpaw init --defaults
qwenpaw app

Setelah dijalankan, kunjungi http://127.0.0.1:8088/ untuk membuka Konsol QwenPaw.

Konfigurasikan kredensial

Di Konsol, klik Settings > Models dan konfigurasikan penyedia sesuai rencana penagihan Anda.

Token Plan Team Edition

QwenPaw tidak menyertakan penyedia bawaan untuk Token Plan Team Edition. Di halaman Providers, klik Add Provider. Atur Protocol ke OpenAI-compatible (Chat Completions) (ID Penyedia dan Nama dapat dikustomisasi, misalnya bailian-token-plan). Setelah disimpan, buka halaman Settings dan isi tabel berikut.

Konfigurasi	Deskripsi
Base URL	`https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1`
API Key	Masukkan API Key khusus Token Plan Team Edition.
Models	Di halaman Models penyedia, klik Add Model dan atur Model ID ke model Token Plan Team Edition yang didukung.

Coding Plan

Buka halaman Settings penyedia bawaan Aliyun Coding Plan (International) dan isi Kunci API.

Konfigurasi	Deskripsi
API Key	Masukkan API Key khusus Coding Plan.
Models	Model umum telah dikonfigurasi sebelumnya. Verifikasi melalui Test Connection di halaman Models. Untuk menambahkan model, klik Add Model dan atur Model ID ke model Coding Plan yang didukung.

Pay-as-you-go

Buka halaman Settings penyedia DashScope dan isi Kunci API. Base URL secara default menggunakan China (Beijing); ganti wilayah melalui dropdown.

Konfigurasi	Deskripsi
API Key	Masukkan Kunci API Alibaba Cloud Model Studio yang sesuai dengan wilayah yang dipilih.
Base URL	Pilih URL yang sesuai dengan wilayah penerapan model dari dropdown: China (Beijing): `https://dashscope.aliyuncs.com/compatible-mode/v1` Internasional (Singapura): `https://dashscope-intl.aliyuncs.com/compatible-mode/v1` AS (Virginia): `https://dashscope-us.aliyuncs.com/compatible-mode/v1`
Models	Model umum telah dikonfigurasi sebelumnya. Untuk menambahkan model, klik Add Model dan atur Model ID ke model yang didukung.

Tetapkan model default

Buka Settings > Models > Default LLM, pilih model, lalu klik Save. Dropdown di pojok kanan atas halaman chat memungkinkan Anda mengganti penyedia dan model untuk sesi saat ini.

FAQ

Kode error

Lakukan troubleshooting berdasarkan rencana penagihan:

Pay-as-you-go: Troubleshooting kode error
Coding Plan: FAQ Coding Plan
Token Plan Team Edition: FAQ Token Plan Team Edition

Error 401 Incorrect API key provided

Kemungkinan penyebab:

Kunci API tidak dapat saling ditukar antar ketiga rencana penagihan. Pastikan Kunci API dan Base URL berasal dari rencana yang sama.
Kunci API Pay-as-you-go dan Base URL berada di wilayah yang berbeda.

Panjang konteks terlampaui selama percakapan panjang atau pemanggilan tool

Di halaman Settings penyedia untuk model tersebut, buka Advanced Configuration dan sesuaikan parameter generasi seperti max_tokens dalam format JSON, lalu simpan:

{
  "temperature": 0.7,
  "top_p": 0.9,
  "max_tokens": 4096
}