Cara Menggunakan Qwen 3.7 Plus API

Qwen 3.7 Plus adalah model agen multimodal Alibaba: teks, gambar, dan video sebagai input, konteks 1M-token, dan harga yang terjangkau. Karena hanya tersedia sebagai API, pertanyaan praktis muncul seketika. Bagaimana cara mendapatkan kunci, bagaimana cara mengirim gambar, dan berapa biayanya? Panduan ini menjawab ketiganya.

Kami akan membahas akses, mendapatkan kunci, permintaan pertama Anda dalam Python, curl, dan JavaScript, format payload multimodal, rincian harga lengkap dengan contoh biaya, dan batas laju. Sepanjang jalan Anda akan menggunakan Apidog untuk mengirim permintaan pengujian, memeriksa respons mentah, dan memalsukan endpoint sehingga aplikasi Anda terus berjalan. Jika Anda ingin kemampuan dan benchmark terlebih dahulu, mulailah dengan gambaran umum Qwen 3.7 Plus kami; untuk flagship khusus teks, lihat panduan API dasar Qwen 3.7.

Intinya

Qwen 3.7 Plus berjalan melalui Alibaba Cloud Model Studio pada endpoint yang kompatibel dengan OpenAI. Anda menetapkan URL dasar wilayah, meneruskan kunci Anda sebagai token Bearer, dan memanggil /chat/completions dengan ID model qwen3.7-plus. Permintaan multimodal menambahkan bagian gambar atau video ke konten pesan. Harganya $0,40 per juta token input dan $1,60 per juta token output, dengan input cache seharga $0,08, kira-kira enam kali lebih murah dari Qwen3.7-Max. Tidak ada tingkat gratis abadi, meskipun akun baru mendapatkan kuota gratis sekali pakai. Token visi berbagi anggaran konteks, sehingga gambar dan video memengaruhi tagihan Anda. Konfirmasikan ID model yang tepat di dokumen Model Studio sebelum Anda meluncurkan.

Cara mengakses Qwen 3.7 Plus

Tidak seperti flagship teks, yang menghabiskan hari-hari awalnya di belakang pratinjau khusus obrolan, Plus adalah API komersial sejak hari pertama. Dua hal penting.

Qwen Chat (chat.qwen.ai). Cara tercepat untuk mencoba Plus dengan gambar. Masuk, pilih model Plus, masukkan tangkapan layar, dan lihat bagaimana ia berfungsi. Ini untuk evaluasi, bukan integrasi.

Alibaba Cloud Model Studio (DashScope). Ini adalah API yang sebenarnya. Model Studio mengekspos Plus melalui endpoint yang kompatibel dengan OpenAI, sehingga kode apa pun yang sudah berbicara dengan OpenAI SDK dapat memanggilnya dengan pertukaran URL dasar dan kunci.

Satu batasan keras untuk direncanakan: Plus adalah kepemilikan. Tidak ada bobot terbuka untuk diunduh, sehingga Anda tidak dapat melakukan self-hosting atau menjalankannya secara terisolasi. Jika itu adalah persyaratan, gambaran umum Qwen 3.7 Plus kami membahas perdagangan secara rinci.

Mendapatkan kunci API Qwen 3.7 Plus

Akses melalui akun Alibaba Cloud.

1. Buat akun Alibaba Cloud dan buka konsol Model Studio (modelstudio.console.alibabacloud.com).
2. Aktifkan Model Studio untuk akun dan wilayah Anda. Kunci memiliki cakupan wilayah, jadi kunci Singapura tidak akan mengautentikasi terhadap Beijing.
3. Buka bagian kunci API dan buat kunci. Bentuknya seperti sk- diikuti oleh string.
4. Salin sekali dan simpan seperti kata sandi.

Wilayah Anda mengatur URL dasar Anda:

Jauhkan kunci dari kontrol sumber. Gunakan variabel lingkungan:

# macOS / Linux
export DASHSCOPE_API_KEY="sk-kunci-anda-di-sini"

# Windows PowerShell
setx DASHSCOPE_API_KEY "sk-kunci-anda-di-sini"

Permintaan pertama Anda: Python, curl, dan JavaScript

Endpoint ini kompatibel dengan OpenAI, jadi Anda dapat menggunakan OpenAI SDK resmi yang diarahkan ke URL dasar DashScope, atau panggilan HTTP mentah. ID model adalah qwen3.7-plus, tetapi konfirmasikan string saat ini di daftar model Model Studio sebelum meluncurkan, karena pengidentifikasi dapat berubah.

Python dengan OpenAI SDK

Instal dengan pip install openai, lalu:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["DASHSCOPE_API_KEY"],
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[{"role": "user", "content": "Ringkas model harga Qwen 3.7 Plus dalam dua kalimat."}],
)
print(resp.choices[0].message.content)

curl

curl "https://dashscope-intl.aliyuncs.com/compatible-mode/v1/chat/completions" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "messages": [{"role": "user", "content": "Halo dari API Qwen 3.7 Plus."}]
  }'

JavaScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.DASHSCOPE_API_KEY,
  baseURL: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
});

const resp = await client.chat.completions.create({
  model: "qwen3.7-plus",
  messages: [{ role: "user", content: "Halo dari API Qwen 3.7 Plus." }],
});
console.log(resp.choices[0].message.content);

Mengirim gambar dan video

Alasan menggunakan Plus daripada Max adalah input multimodal. Anda meneruskan konten visual sebagai bagian tambahan dalam array content pesan, bentuk yang sama yang digunakan oleh API visi OpenAI.

resp = client.chat.completions.create(
    model="qwen3.7-plus",
    messages=[{
        "role": "user",
        "content": [
            {"type": "text", "text": "Tombol mana yang mengirim formulir ini? Berikan koordinat piksel."},
            {"type": "image_url", "image_url": {"url": "https://example.com/screenshot.png"}},
        ],
    }],
)

Anda dapat meneruskan gambar sebagai URL publik atau URI data base64. Video mengikuti pola yang sama dengan bagian video. Ini adalah yang menggerakkan perilaku GUI-grounding: berikan tangkapan layar ke Plus, dan ia mengembalikan tindakan terstruktur seperti click at (x=487, y=232). Nama bagian yang tepat untuk video dapat berbeda menurut wilayah, jadi periksa dokumen kompatibilitas OpenAI untuk skema saat ini.

Harga

Plus dihargai sebagai tingkat multimodal yang terjangkau. Berikut perbandingannya dengan flagship teks.

Itu kira-kira enam kali lebih murah dari Max untuk input. Tidak ada tingkat gratis abadi, tetapi akun Model Studio yang baru mendapatkan kuota token gratis sekali pakai (biasanya di wilayah Singapura) untuk mengevaluasi model sebelum penagihan beralih ke bayar sesuai penggunaan. Perhatikan bahwa jalur gratis Qwen OAuth lama telah dihentikan pada 15 April 2026, jadi jangan gunakan itu. Angka resmi ada di halaman harga Model Studio dan panduan kuota gratis; untuk cara tanpa biaya untuk mencoba keluarga yang lebih luas, lihat panduan Qwen 3.7 gratis kami.

Berapa biaya sebenarnya dari permintaan

Teks murah. Visi adalah tempat tagihan membengkak, karena gambar dan video dikonversi menjadi token yang berbagi tarif per-token yang sama dan anggaran konteks 1M yang sama. Tangkapan layar resolusi tinggi dapat mencapai beberapa ribu token, dan bingkai video bertumpuk dengan cepat.

Angka token bingkai bersifat perkiraan dan bergantung pada resolusi dan laju pengambilan sampel, tetapi pelajarannya tetap berlaku: agen teks di Plus hampir tidak berharga, sementara beban kerja yang berat dengan video dapat berharga 30 kali lebih banyak per panggilan. Kurangi skala tangkapan layar dan sampel video secara hemat. Untuk strategi biaya yang lebih luas, lihat catatan kami tentang mengurangi biaya token agen dan perang harga LLM Tiongkok 2026 yang menempatkan Plus pada harga ini.

Batas laju dan kesalahan

Model Studio memberlakukan batas laju per-akun dalam permintaan per menit dan token per menit, dan batas atas bergantung pada tingkat dan wilayah akun Anda daripada satu angka yang dipublikasikan. Periksa halaman kuota di konsol untuk batas Anda saat ini, dan minta peningkatan di sana jika Anda mencapainya.

Tangani kegagalan umum:

• 401 Tidak Sah: kunci salah, atau kunci dari wilayah yang salah untuk URL dasar Anda.
• 429 Terlalu Banyak Permintaan: Anda telah mencapai batas laju. Tunggu sebentar dan coba lagi dengan penundaan eksponensial.
• 400 Permintaan Buruk: biasanya payload multimodal yang salah bentuk, gambar yang terlalu besar, atau luapan konteks setelah token visi dihitung.

Sertakan panggilan dalam percobaan ulang dengan backoff pada 429 dan 5xx, dan validasi ukuran gambar sebelum mengirim.

Uji dan mock API dengan Apidog

Permintaan multimodal mudah salah. Anda melakukan base64-encoding gambar, menumpuk array konten, dan membaca kembali rencana tindakan terstruktur, seringkali di dalam loop pemanggilan alat. Mengamati hal itu di terminal akan cepat membosankan.

Apidog memberi Anda ruang kerja nyata untuk itu. Kirim permintaan Qwen 3.7 Plus dengan bagian gambar dan video, periksa respons JSON mentah, simpan kunci Model Studio Anda per lingkungan agar Anda tidak pernah menempelkannya ke kode, dan mock endpoint agar frontend Anda dapat dibuat saat Anda menyetel perintah. Ketika Plus merangkai panggilan alat di seluruh agen GUI-dan-CLI, debugger agen AI Apidog menunjukkan urutan lengkap sehingga Anda dapat menemukan di mana eksekusi terhenti.

Unduh Apidog untuk menguji, men-debug, dan me-mock API Qwen 3.7 Plus sebelum mencapai produksi.

FAQ

Apakah ada tingkat gratis untuk API Qwen 3.7 Plus? Tidak ada tingkat gratis abadi. Akun Alibaba Cloud Model Studio yang baru mendapatkan kuota token gratis sekali pakai untuk evaluasi, biasanya di wilayah Singapura, kemudian penagihan beralih ke bayar sesuai penggunaan.

Apa ID modelnya? qwen3.7-plus di Model Studio. Karena pengidentifikasi dapat berubah, konfirmasikan string saat ini di daftar model Model Studio sebelum Anda meluncurkan.

Bagaimana biaya gambar dan video dihitung? Konten visual diubah menjadi token yang ditagih dengan tarif input standar. Tangkapan layar 1080p dapat berharga beberapa ribu token, dan video menambahkan token per bingkai yang disampel, sehingga payload media besar mendominasi tagihan.

Bagaimana API ini berbeda dari Qwen 3.7 Max? Bentuk yang sama yang kompatibel dengan OpenAI dan URL dasar yang sama. Plus menerima bagian gambar dan video dalam konten pesan dan biayanya sekitar enam kali lebih murah; Max hanya teks dan memiliki sedikit keunggulan pada benchmark khusus teks.

Bisakah saya melakukan self-host Qwen 3.7 Plus? Tidak. Bobotnya tertutup, jadi hanya berjalan melalui Alibaba Cloud Model Studio.

URL dasar mana yang harus saya gunakan? Yang sesuai dengan wilayah tempat Anda membuat kunci Anda: Singapura, AS (Virginia), atau Beijing. Kunci tidak akan mengautentikasi terhadap endpoint wilayah yang berbeda.

Intinya

Memanggil Qwen 3.7 Plus adalah pertukaran URL dasar dan kunci pada OpenAI SDK, ditambah bagian gambar atau video saat Anda membutuhkan visi. Harganya sangat murah untuk teks dan berskala dengan payload visual Anda, jadi disiplinnya adalah berapa banyak piksel yang Anda kirim, bukan API itu sendiri. Dapatkan kunci, kirim permintaan multimodal pertama Anda, dan uji seluruh alur di Apidog sebelum Anda mengintegrasikannya ke dalam produksi.