Akses API Qwen memiliki dua jalur praktis bagi tim yang sudah menggunakan klien bergaya OpenAI. Anda bisa memanggil Qwen secara langsung melalui interface OpenAI-compatible DashScope milik Alibaba Cloud Model Studio, atau Anda bisa tetap menggunakan satu base URL router Flatkey dan memakai Qwen di samping model lain yang sudah dirutekan oleh produk Anda.
Jalur langsung Alibaba Cloud bersifat spesifik wilayah. Jalur Flatkey menggunakan https://router.flatkey.ai/v1, kunci Flatkey, dan ID model Qwen yang dipilih dari katalog Flatkey saat ini sebelum Anda menguji log, unit harga, dukungan fitur, dan rollback.
Panduan ini menjelaskan cara menggunakan akses API Qwen melalui satu base URL yang kompatibel dengan OpenAI. Ini mencakup apa yang dikonfirmasi oleh dokumen resmi Alibaba Cloud, di mana Flatkey mengubah model operasional, dan apa yang perlu diverifikasi sebelum Anda memindahkan traffic produksi.
Jawaban Singkat: Akses API Qwen Melalui Satu Base URL Router
Jika aplikasi Anda sudah menggunakan OpenAI Python atau JavaScript SDK, akses API Qwen dapat dimulai sebagai perubahan konfigurasi, bukan penulisan ulang SDK penyedia.
| Keputusan | Qwen Langsung di Model Studio | Qwen Melalui Flatkey |
|---|---|---|
| API key | DashScope API key dari Alibaba Cloud Model Studio | Flatkey API key |
| Base URL | URL OpenAI-compatible yang spesifik wilayah untuk DashScope | https://router.flatkey.ai/v1 |
| Tujuan utama | Memanggil Qwen secara langsung dengan sintaks yang kompatibel dengan OpenAI | Merutekan Qwen di samping penyedia lain di balik satu kunci |
| Pilihan model | Model Qwen dari dokumen Alibaba Cloud dan wilayah akun | Model Qwen dari harga atau dashboard Flatkey |
| Validasi | Respons, dukungan fitur, penagihan Alibaba Cloud | Respons, log penggunaan Flatkey, unit harga, kuota, rollback |
Gunakan endpoint Model Studio langsung ketika Anda hanya membutuhkan kontrol akun Alibaba Cloud untuk Qwen. Gunakan Flatkey ketika Qwen harus berada dalam alur kerja akses, routing, kuota, log penggunaan, dan penagihan yang sama seperti GPT, Claude, Gemini, DeepSeek, Seedance, model gambar, dan keluarga model lainnya.
Apa yang Dikonfirmasi oleh Dokumen Qwen Alibaba Cloud
Alibaba Cloud mendokumentasikan bahwa model Qwen di Model Studio mendukung interface yang kompatibel dengan OpenAI. Instruksi migrasi resmi sangat langsung: sesuaikan API key, BASE_URL, dan nama model. Itu adalah pola migrasi tiga bagian yang sama seperti yang diharapkan sebagian besar pengguna SDK yang kompatibel dengan OpenAI.
Dokumen resmi mencantumkan base URL spesifik wilayah untuk panggilan SDK:
| Wilayah | Base URL yang Kompatibel dengan OpenAI |
|---|---|
| Singapura | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 |
| AS (Virginia) | https://dashscope-us.aliyuncs.com/compatible-mode/v1 |
| Tiongkok (Beijing) | https://dashscope.aliyuncs.com/compatible-mode/v1 |
| Hong Kong (Tiongkok) | https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1 |
Referensi OpenAI Chat juga mendokumentasikan format endpoint chat lengkap, seperti POST https://dashscope-us.aliyuncs.com/compatible-mode/v1/chat/completions untuk panggilan AS. Dokumen yang sama mencakup contoh untuk chat non-streaming, streaming, usage pada chunk stream final, tool calling, output JSON, input gambar untuk model yang mendukung visi, dan opsi terkait pencarian.
Itu tidak berarti setiap model Qwen mendukung setiap fitur. Artinya akses API Qwen harus diuji fitur demi fitur: mulai dari chat dasar, lalu streaming, tools, JSON, visi, pencarian, atau endpoint apa pun yang benar-benar digunakan aplikasi Anda.
Cara Flatkey Mengubah Setup Qwen
Flatkey mengubah permukaan operasional di sekitar akses API Qwen. Alih-alih memilih base URL region DashScope secara langsung di setiap aplikasi, Anda mengarahkan klien yang kompatibel dengan OpenAI ke satu base URL router:
https://router.flatkey.ai/v1Jalur ini penting ketika Qwen bukan satu-satunya model dalam stack Anda. Copy produk publik Flatkey memposisikan platform ini di sekitar satu API key, harga yang jelas, visibilitas penggunaan, dan satu dashboard untuk key, usage, serta routing. Dukungan Qwen untuk artikel ini diverifikasi melalui snapshot katalog harga Flatkey yang aktif, bukan melalui klaim homepage yang bersifat evergreen.
Snapshot harga Flatkey pada hari publikasi yang diperiksa untuk artikel ini menghasilkan 638 total baris model dan 63 baris bernama Qwen. Dari baris Qwen tersebut, 28 ditandai tersedia dalam snapshot, dan baris Qwen menampilkan openai sebagai jenis endpoint yang didukung. Perlakukan itu sebagai bukti bertanggal dari 16 Juni 2026, bukan jaminan ketersediaan permanen: konfirmasikan ID model Qwen saat ini di harga atau dashboard sebelum traffic produksi.
Pola Migrasi Base URL
Letakkan akses API Qwen di konfigurasi, bukan meng-hardcode URL penyedia di seluruh codebase Anda.
FLATKEY_API_KEY="sk-fk-your-key"
OPENAI_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_QWEN_MODEL="replace-with-flatkey-qwen-model-id"
# Nilai Model Studio langsung opsional untuk perbandingan atau rollback.
DASHSCOPE_API_KEY="sk-your-dashscope-key"
DASHSCOPE_BASE_URL="https://dashscope-us.aliyuncs.com/compatible-mode/v1"Perbedaan pentingnya adalah kepemilikan rute. Pengujian Qwen langsung menggunakan kunci DashScope dan base URL regional DashScope. Pengujian Flatkey menggunakan kunci Flatkey dan base URL router Flatkey. Jangan mencampur kunci, base URL, dan model ID antara dua jalur tersebut.
Python Template Untuk Qwen Melalui Flatkey
Hanya template: jalankan ini dengan kunci Flatkey yang valid dan model ID Qwen Flatkey yang sudah dikonfirmasi sebelum menggunakannya di produksi.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)
response = client.chat.completions.create(
model=os.environ["FLATKEY_QWEN_MODEL"],
messages=[
{
"role": "user",
"content": "Balas dengan satu kalimat yang mengonfirmasi bahwa rute Qwen telah dikonfigurasi.",
}
],
)
print(response.choices[0].message.content)
print(response.usage)Bentuk kodenya sengaja dibuat seperti penggunaan SDK OpenAI yang biasa. Pekerjaan produksinya adalah memilih model ID yang tepat, menguji set fitur Anda, dan memastikan permintaan muncul di log penggunaan Flatkey dengan model, status, penggunaan token, dan biaya yang diharapkan.
JavaScript Template Untuk Qwen Melalui Flatkey
Hanya template: jalankan ini dengan kunci Flatkey yang valid dan model ID yang sudah dikonfirmasi dari katalog Flatkey saat ini.
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: process.env.OPENAI_BASE_URL || "https://router.flatkey.ai/v1",
});
const response = await client.chat.completions.create({
model: process.env.FLATKEY_QWEN_MODEL,
messages: [
{
role: "user",
content: "Balas dengan satu kalimat yang mengonfirmasi bahwa rute Qwen telah dikonfigurasi.",
},
],
});
console.log(response.choices[0].message.content);
console.log(response.usage);Bagi tim yang sudah menggunakan klien JavaScript yang kompatibel dengan OpenAI, ini membuat akses API Qwen cukup kecil untuk ditinjau dalam satu perubahan konfigurasi. Rute ini tetap perlu smoke test sebelum traffic nyata.
Qwen Langsung Versus Flatkey: Apa yang Perlu Diuji
Kekurangan artikel dalam hasil pencarian saat ini bukan daftar model Qwen lainnya. Dokumen resmi sudah mencakup itu. Bagian yang hilang adalah checklist router praktis untuk menentukan kapan Qwen langsung sudah cukup dan kapan satu base URL adalah jalur operasional yang lebih bersih.
| Kebutuhan Alur Kerja | Pemeriksaan Qwen Langsung | Pemeriksaan Router Flatkey |
|---|---|---|
| Chat dasar | Gunakan base URL regional DashScope dan model yang benar. | Gunakan https://router.flatkey.ai/v1 dan model ID Qwen Flatkey. |
| Streaming | Uji stream: true dan penanganan usage akhir di DashScope. |
Uji potongan stream, perilaku timeout, dan logging usage akhir melalui Flatkey. |
| Tools/function calling | Konfirmasi model Qwen yang dipilih mendukung skema tool yang Anda kirim. | Konfirmasi skema yang sama lolos melalui rute Qwen Flatkey yang dipilih. |
| Output JSON | Uji pola response_format Anda yang persis. |
Verifikasi kompatibilitas parser dan perilaku error melalui router. |
| Input visi | Pilih model visi Qwen dan uji format payload gambar. | Konfirmasi model Flatkey menerima bentuk input gambar yang sama. |
| Review biaya | Periksa billing dan dokumentasi harga Alibaba Cloud Model Studio. | Periksa harga Flatkey dan log penggunaan aktual. |
| Routing multi-provider | Memerlukan setup provider terpisah untuk model non-Qwen. | Pertahankan Qwen berdampingan dengan provider lain di balik satu kunci dan dashboard. |
Runbook Smoke Test
Smoke test akses API Qwen harus membuktikan perilaku API dan visibilitas router.
- Pilih satu model ID Qwen dari harga Flatkey saat ini atau dashboard.
- Buat atau pilih kunci Flatkey berisiko rendah untuk pengujian.
- Set
OPENAI_BASE_URLkehttps://router.flatkey.ai/v1. - Jalankan prompt chat sederhana tanpa streaming.
- Konfirmasi bentuk respons bekerja dengan parser aplikasi Anda.
- Periksa log penggunaan Flatkey untuk model, status, penggunaan token, dan biaya.
- Jalankan tes model yang salah dan catat bentuk error.
- Jalankan streaming, tools, JSON, search, atau vision hanya jika aplikasi Anda menggunakannya.
- Setel kuota kecil sebelum traffic nyata dikirim.
- Pertahankan pengaturan DashScope langsung atau provider sebelumnya sebagai konfigurasi rollback sampai rute stabil.
Tujuannya bukan hanya membuat respons Qwen muncul. Tujuannya adalah mengetahui ke mana permintaan pergi, berapa biayanya, seperti apa kegagalannya, dan seberapa cepat Anda bisa mengembalikan rute sebelumnya.
Kesalahan Umum
- Menggunakan kunci API DashScope dengan base URL Flatkey, atau kunci Flatkey dengan base URL DashScope.
- Menyalin nama model Qwen dari dokumentasi Alibaba Cloud tanpa mengonfirmasi string katalog Flatkey.
- Beranggapan setiap parameter yang kompatibel dengan OpenAI berperilaku sama di jalur langsung dan jalur yang dirutekan.
- Hanya menguji chat tanpa streaming saat produksi menggunakan streaming, tools, JSON, search, atau vision.
- Melompati pemeriksaan log penggunaan dan harga Flatkey setelah respons berhasil.
- Mempublikasikan cuplikan kode dengan kunci yang terlihat seperti asli atau model ID produksi yang belum diuji.
Ini adalah detail kecil, tetapi di situlah sebagian besar migrasi akses API Qwen gagal. Router memang memudahkan akses; tetapi tidak menghilangkan kebutuhan untuk menguji bentuk permintaan yang persis sama.
Bagaimana Ini Sesuai dengan Panduan Migrasi Flatkey yang Ada
Jika ini adalah migrasi router pertama Anda, mulailah dengan panduan migrasi API yang lebih luas yang kompatibel dengan OpenAI. Panduan ini mencakup pola base URL, variabel lingkungan, smoke test, rollback, dan pemeriksaan dashboard yang berlaku untuk penyedia mana pun.
Lalu gunakan panduan khusus Qwen ini untuk detail penyedia: endpoint regional DashScope, pemilihan model Qwen, pengujian streaming dan fitur, serta pemeriksaan katalog Flatkey. Untuk jalur router penyedia yang serupa, bandingkan dengan panduan router OpenAI-compatible API Gemini.
FAQ
Bagaimana cara mendapatkan akses API Qwen?
Anda bisa mendapatkan akses API Qwen langsung melalui Alibaba Cloud Model Studio dengan kunci API DashScope, atau merutekan Qwen melalui Flatkey dengan kunci Flatkey dan https://router.flatkey.ai/v1. Jalur langsung menggunakan base URL regional DashScope; jalur Flatkey menempatkan Qwen dalam satu gateway multi-model.
Apakah API Qwen kompatibel dengan OpenAI?
Alibaba Cloud mendokumentasikan antarmuka yang kompatibel dengan OpenAI untuk model Qwen di Model Studio. Migrasinya mengubah kunci API, base URL, dan nama model. Pengujian di tingkat fitur tetap diperlukan untuk streaming, tools, output JSON, vision, search, dan parameter lanjutan apa pun.
Apa base URL OpenAI-compatible Qwen langsung?
Tergantung pada wilayah. Alibaba Cloud mencantumkan base URL regional termasuk https://dashscope-us.aliyuncs.com/compatible-mode/v1 untuk AS (Virginia), https://dashscope-intl.aliyuncs.com/compatible-mode/v1 untuk Singapura, dan https://dashscope.aliyuncs.com/compatible-mode/v1 untuk China (Beijing).
Base URL apa yang harus saya gunakan untuk Qwen melalui Flatkey?
Gunakan https://router.flatkey.ai/v1 untuk Qwen melalui Flatkey. Lalu pilih ID model Qwen yang terbaru dari harga Flatkey atau dashboard dan uji permintaan sebelum traffic produksi.
Bisakah saya menggunakan ID model Qwen yang sama dari dokumen Alibaba Cloud di Flatkey?
Tidak otomatis. String model, alias, ketersediaan, dan dukungan endpoint dapat bervariasi حسب katalog dan rute. Pilih ID model dari Flatkey pada hari Anda menguji dan simpan di konfigurasi.
Apakah OpenAI-compatible berarti kesetaraan fitur penuh?
Tidak. OpenAI-compatible biasanya berarti bentuk request dan response yang umum berfungsi untuk endpoint yang didukung. Itu tidak menjamin perilaku yang identik untuk setiap model, parameter, endpoint, wilayah, mode streaming, tool call, atau payload multimodal.
Bagaimana saya harus menganggarkan Qwen melalui router?
Gunakan dokumen harga Alibaba Cloud untuk konteks Model Studio langsung dan harga Flatkey untuk penggunaan yang dirutekan. Lalu verifikasi biaya permintaan aktual di log Flatkey karena model, cache, endpoint, dan unit moda dapat berbeda.
Lihat Harga Sebelum Anda Merutekan Traffic Produksi
akses API Qwen melalui router yang kompatibel dengan OpenAI adalah jalur migrasi yang praktis ketika aplikasi Anda sudah menggunakan panggilan SDK bergaya OpenAI. Jaga perubahannya tetap kecil: perbarui base URL, gunakan kunci Flatkey, pilih model Qwen terbaru, jalankan smoke test, dan verifikasi penggunaan serta harga sebelum peluncuran.
Lihat Harga untuk mengonfirmasi opsi model Qwen Flatkey saat ini dan unit biaya sebelum Anda mengirim traffic produksi.
