Cara menggunakan API LLM di QwenPaw - Alibaba Cloud Model Studio

QwenPaw (sebelumnya bernama CoPaw) adalah asisten AI pribadi open-source dari tim AgentScope yang mendukung penyebaran lokal dan cloud serta terintegrasi dengan Alibaba Cloud Model Studio melalui Token Plan Personal Edition, 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 diluncurkan, 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 Personal Edition

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

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

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 di bawah ini.

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

Coding Plan

Buka halaman Pengaturan penyedia Aliyun Coding Plan (International) bawaan, lalu masukkan API Key.

Configuration	Description
API Key	Masukkan khusus Coding Plan.API Key
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, lalu isi API Key. Base URL secara default mengarah ke Tiongkok (Beijing); ubah wilayah melalui dropdown.

Configuration	Description
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, lalu ganti `{WorkspaceId}` dalam URL tersebut dengan Workspace ID Anda: China (Beijing): `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1` Internasional (Singapura): `https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1` AS (Virginia): `https://{WorkspaceId}.us-east-1.maas.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.

Configuration

Description

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, lalu ganti {WorkspaceId} dalam URL tersebut dengan Workspace ID Anda:

China (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
Internasional (Singapura): https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
AS (Virginia): https://{WorkspaceId}.us-east-1.maas.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 dapat 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 Personal Edition: FAQ Token Plan Personal Edition
Token Plan Team Edition: FAQ Token Plan Team Edition

Error 401 Incorrect API key provided

Penyebab yang mungkin terjadi:

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
}