Masalah koneksi dan konfigurasi
Error umum dan solusinya
Pesan error | Kemungkinan penyebab | Solusi |
|---|---|---|
400 InvalidParameter: Range of input length should be [1, xxx] | Input melebihi panjang yang diizinkan. |
|
401 invalid access token or token expired |
|
|
model 'xxx' is not supported |
| Gunakan ID model yang didukung oleh Coding Plan. ID model bersifat case-sensitive dan tidak boleh mengandung spasi di awal atau akhir. |
403 invalid api-key | Anda menggunakan URL dasar Model Studio tujuan umum alih-alih URL dasar spesifik paket. | Titik akhir kompatibel Anthropic: Titik akhir kompatibel OpenAI: |
404 status code (no body) | Jalur URL dasar salah. Misalnya, Anda salah mengatur URL dasar menjadi | Titik akhir kompatibel Anthropic: Titik akhir kompatibel OpenAI: |
Connection error | URL dasar salah eja atau terjadi masalah jaringan. | Periksa ejaan URL dasar dan pastikan koneksi jaringan Anda stabil. |
Connection closed mid-response (sering disertai | Respons streaming terputus di tengah transfer dan tidak sepenuhnya diterima. Hal ini biasanya disebabkan oleh ketidakstabilan jaringan atau proxy lokal (VPN/HTTP Proxy) yang tidak stabil sehingga memutus koneksi persisten ke |
|
hour allocated quota exceeded | Kuota permintaan 5 jam telah habis. | Tunggu 5 jam hingga kuota direset secara otomatis. |
week allocated quota exceeded | Kuota permintaan mingguan telah habis. | Kuota direset pada pukul 00:00:00 (UTC+8) setiap hari Senin. |
month allocated quota exceeded | Kuota permintaan bulanan telah habis. | Kuota direset pada pukul 00:00:00 (UTC+8) pada hari yang sesuai di bulan langganan berikutnya. |
concurrency allocated quota exceeded | Jumlah permintaan konkuren telah melebihi batas alokasi dinamis. | Tunggu sebentar lalu coba lagi. Platform menyesuaikan batas ini berdasarkan beban sumber daya, sehingga error ini lebih mungkin terjadi pada jam-jam sibuk. |
429 usage allocated quota exceeded | Permintaan dikirim terlalu sering dalam periode singkat, sehingga memicu batas laju pemanggilan model. | Tunggu satu menit lalu coba lagi. Jika error ini sering terjadi, kurangi frekuensi permintaan Anda dan pastikan Kunci API Anda tidak dibagikan kepada orang lain. |
Claude Code: pesan "Switched to native installer"
Hal ini tidak memengaruhi penggunaan normal Claude Code. Anda dapat menjalankan claude install di terminal untuk memigrasikan Claude Code ke instalasi resmi native, lalu ikuti perintah yang ditampilkan di terminal untuk menyelesaikan migrasi konfigurasi.
Claude Code: error "Unable to connect"
Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country. Check supported
countries at https://anthropic.com/supported-countries
Penyebab: Saat startup pertama kali, Claude Code mencoba menghubungi api.anthropic.com untuk autentikasi awal. Koneksi ini gagal karena Claude Code tidak tersedia di beberapa negara dan wilayah.
Solusi:
-
Tambahkan
"hasCompletedOnboarding": truesebagai field tingkat atas di~/.claude.json.Untuk solusi otomatis, gunakan Qwen Code. Jalankan Qwen Code dengan menjalankan
qwendi terminal Anda, lalu kirim pesan chat berikut:Please add "hasCompletedOnboarding": true as a top-level field in the ~/.claude.json file without overwriting existing content.
{
"hasCompletedOnboarding": true
}
- Simpan file tersebut dan restart Claude Code.
claude
OpenCode: error "Request entity too large"
Error ini menunjukkan bahwa konten permintaan, seperti konteks kode atau riwayat percakapan, melebihi batas input maksimum. Untuk mengatasi masalah ini:
- Jalankan
/newuntuk membuat percakapan baru, atau jalankan/compactuntuk memampatkan konteks. Untuk metode lain dalam mengatasi overflow konteks, lihat dokumentasi. - Jika masalah tetap berlanjut, perbarui OpenCode ke versi 1.2.16 atau yang lebih baru. Versi ini mencakup perbaikan untuk masalah ini.
OpenCode: error parameter "thinking_budget"
Penyebab: Nilai budgetTokens dalam file konfigurasi opencode.json melebihi thinking_budget maksimum yang didukung oleh model saat ini. Batasnya berbeda-beda tergantung modelnya. Sesuaikan konfigurasi Anda sesuai tabel di bawah ini.
Nama model | Budget pemikiran maksimum |
|---|---|
qwen3.7-plus | 262.144 |
qwen3.6-plus | 81.920 |
qwen3.5-plus | 81.920 |
qwen3-max-2026-01-23 | 81.920 |
kimi-k2.5 | 81.920 |
glm-5 | 32.768 |
glm-4.7 | 32.768 |
MiniMax-M2.5 | Diaktifkan secara default. Parameter budgetTokens tidak diperlukan. |
qwen3-coder-next | Mode pemikiran tidak didukung. |
qwen3-coder-plus | Mode pemikiran tidak didukung. |
Solusi: Buka file konfigurasi OpenCode opencode.json dan sesuaikan nilai options.thinking.budgetTokens agar tidak melebihi batas model. Untuk model yang tidak mendukung mode pemikiran, seperti qwen3-coder-next dan qwen3-coder-plus, hapus item konfigurasi options.thinking. Untuk detailnya, lihat OpenCode.
OpenCode: error rentang "max_tokens"
Penyebab: Nilai limit.output dalam file konfigurasi opencode.json melebihi jumlah maksimum token output (max_tokens) yang didukung oleh model saat ini.
Solusi: Ubah file konfigurasi opencode.json dan sesuaikan nilai limit untuk model yang sesuai menurut OpenCode.
Apakah model Coding Plan mendukung mode pemikiran?
Sebagian besar model Coding Plan yang mendukung pemikiran mendalam memiliki mode pemikiran yang diaktifkan secara default. Untuk mengaktifkannya di alat umum:
Model yang Anda gunakan harus mendukung mode pemikiran.
Claude Code
Aktifkan mode pemikiran: Masukkan /config, navigasi ke Thinking mode, lalu tekan Enter untuk mengubah nilainya menjadi true.
Lihat proses pemikiran: Tekan Ctrl + O.
● I am Claude Code, the official command-line interface tool from Anthropic. 05:13 PM kimi-k2.5
My core purpose is to be a software engineering assistant:
- Write, modify, and debug code
- Explore and analyze codebases
- Run terminal commands and automate tasks
- Provide technical code explanations and suggestions
My output style is concise and direct, prioritizing technical accuracy. I am powered by Claude Opus 4.6
and use tools to complete tasks rather than just having a conversation.
∴ Thinking…
The user asked, "Think and then tell me: who are you?" I need to think before answering.
Based on the system prompt, I am Claude Code, the official CLI tool from Anthropic. I am powered by Claude Opus 4.6
(based on the model ID in the background information: 'claude-opus-4-6').
My characteristics are:
1. Focus on software engineering tasks.
2. Use tools to complete tasks (not just converse).
3. Maintain a concise and professional tone.
4. Do not use emojis proactively.
5. Prioritize technical accuracy over emotional validation.
I need to think before answering, so I should give a concise and accurate self-introduction.
OpenCode
Untuk detailnya, lihat OpenCode. Konfigurasikan parameter options sebagai berikut:
{
"thinking": {
"type": "enabled",
"budgetTokens": 1024
}
}
budgetTokensadalah jumlah maksimum token untuk pemikiran. Anda dapat menyesuaikannya sesuai kebutuhan.
Qwen Code
Buka ~/.qwen/settings.json, lalu di properti modelProviders, atur parameter enable_thinking menjadi true untuk mengaktifkan mode pemikiran:
{
"ide": {
"hasSeenNudge": true
},
"env": {
"BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.6-plus",
"name": "[Bailian Coding Plan] qwen3.6-plus",
"baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
...
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"codingPlan": {
"region": "china",
"version": "xxx"
},
"model": {
"name": "qwen3.6-plus"
},
"$version": 3
}
{
"ide": {
"hasSeenNudge": true
},
"env": {
"BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxx"
},
"modelProviders": {
"openai": [
{
"id": "qwen3.6-plus",
"name": "[Bailian Coding Plan] qwen3.6-plus",
"baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
"envKey": "BAILIAN_CODING_PLAN_API_KEY",
"generationConfig": {
"extra_body": {
"enable_thinking": true
}
}
},
...
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"codingPlan": {
"region": "china",
"version": "xxx"
},
"model": {
"name": "qwen3.6-plus"
},
"$version": 3
}
OpenClaw
Untuk mengaktifkan mode pemikiran di OpenClaw, ikuti langkah-langkah berikut:
-
Periksa versi OpenClaw
Jalankan
openclaw tuidi terminal untuk masuk ke TUI. Di kotak dialog, masukkanopenclaw --versionuntuk memeriksa apakah versi OpenClaw Anda adalahv2026.03.02atau yang lebih baru. Versi OpenClaw sebelumnya mungkin tidak dapat mengaktifkan mode pemikiran.
openclaw --version
OpenClaw 2026.3.8 (commit: 3caab92)
-
Pilih tingkat pemikiran
Di TUI OpenClaw, masukkan perintah
/think highuntuk memilih tingkat pemikiran (dalam contoh ini,highdipilih sebagai tingkat pemikiran untuk sesi saat ini).
/think high
→ high
-
Ubah file konfigurasi
-
Atur parameter
compatMerujuk ke OpenClaw, buka file konfigurasi, lalu tambahkan parameter
compatke konfigurasi model yang mendukung mode pemikiran:
-
"compat": {
"thinkingFormat": "qwen"
}
-
Atur parameter
reasoningPada konfigurasi model yang sama, atur parameter
reasoningmenjaditrue:
{
"id": "qwen3-max-2026-01-23",
"name": "qwen3-max-2026-01-23",
"reasoning": true,
"compat": {
"thinkingFormat": "qwen"
},
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 262144,
"maxTokens": 65536
}
-
Restart OpenClaw Gateway
Setelah menyimpan file konfigurasi, jalankan perintah berikut di terminal Anda untuk merestart Gerbang OpenClaw dan menerapkan perubahan.
openclaw gateway restart
OpenClaw: Catatan panggilan untuk model yang tidak dikonfigurasi
Alasan: File openclaw.json tidak memiliki konfigurasi agents.defaults.models untuk membatasi rentang model yang tersedia.
Solusi: Di ~/.openclaw/openclaw.json, deklarasikan secara eksplisit daftar model yang diizinkan di agents.defaults.models untuk membatasi OpenClaw hanya memanggil model yang telah dikonfigurasi. Untuk informasi lebih lanjut, lihat OpenClaw.
OpenClaw: Chat tidak responsif setelah terhubung
Kemungkinan penyebabnya meliputi:
- Proxy lokal (VPN/HTTP Proxy) mengintersepsi atau gagal meneruskan permintaan ke
coding.dashscope.aliyuncs.com. - URL Dasar di file cache OpenClaw
~/.openclaw/agents/main/agent/models.jsonmengarah ke alamat yang salah, sehingga permintaan dikirim ke titik akhir yang tidak responsif.
Solusi:
- Coba nonaktifkan proxy lokal, atau pastikan proxy tersebut dapat mengakses
coding.dashscope.aliyuncs.com. - Hapus file cache
~/.openclaw/agents/main/agent/models.jsondan restart OpenClaw. Setelah restart, file cache akan dibuat ulang secara otomatis berdasarkan konfigurasi di~/.openclaw/openclaw.json.
OpenClaw: Error "OAuth token refresh failed"
Error ini menunjukkan bahwa Anda terhubung ke layanan OAuth pihak ketiga, bukan Coding Plan.
Solusi:
-
Konfigurasikan Coding Plan di OpenClaw. Untuk detailnya, lihat OpenClaw.
-
Hapus kredensial OAuth lama dan cache model, lalu restart OpenClaw.
Sebelum menghapus kredensial OAuth lama, backup file tersebut untuk memungkinkan rollback jika diperlukan.
rm ~/.openclaw/agents/main/agent/auth.json
rm ~/.openclaw/agents/main/agent/models.json
openclaw gateway restart
OpenClaw: Error "Unknown model"
Error ini menunjukkan bahwa OpenClaw tidak dapat menemukan model yang ditentukan di file konfigurasi. Periksa hal-hal berikut secara berurutan:
-
Konfigurasi kunci
models.providersatau awalan model salahSaat menggunakan Coding Plan,
models.providersharus berisi kuncibailian(yang dapat berdampingan dengan penyedia lain). Selain itu,agents.defaults.model.primaryharus diawali denganbailian/. Struktur yang benar adalah sebagai berikut:
// File konfigurasi: ~/.openclaw/openclaw.json
{
"models": { "providers": { "bailian": {...} } },
"agents": { "defaults": { "model": { "primary": "bailian/qwen3.6-plus" } } }
}
-
Konfigurasi sisa dari penyedia lama menyebabkan konflik routing
Jika sebelumnya Anda menggunakan penyedia lain seperti qwen-portal, konfigurasi penyedia yang tersisa dapat menyebabkan kebingungan routing model. Bersihkan penyedia yang tidak relevan dan pastikan model yang ditunjuk oleh field
primarydidefinisikan dengan benar di daftarmodels.providers.bailian.models. Untuk informasi konfigurasi, lihat OpenClaw.
Apa itu qwen-portal/coder-model?
qwen-portal/coder-model adalah model gratis yang disediakan oleh versi web Qwen Chat dan bukan bagian dari Model Studio. Jika Anda mencoba menggunakan model ini di Model Studio atau Coding Plan, Anda akan menerima error yang menunjukkan bahwa model tersebut tidak ada. Gunakan model yang didukung oleh Model Studio.
OpenClaw: Error "No API key found"
Error ini menunjukkan bahwa OpenClaw tidak dapat menemukan kunci API untuk penyedia (xxxxx) yang disebutkan dalam pesan error. Periksa hal-hal berikut secara berurutan:
-
Konfigurasi penyedia yang sesuai tidak ada di
models.providers.Buka file konfigurasi
~/.openclaw/openclaw.jsondan pastikan kunci yang sesuai dengan nama penyedia dalam pesan error ada di bawahmodels.providers.- Jika Anda menghubungkan ke Coding Plan, konfigurasi harus mencakup kunci
bailian(dapat berdampingan dengan penyedia lain). - Jika kuncinya tidak ada, tambahkan konfigurasi penyedia yang sesuai.
- Jika Anda menghubungkan ke Coding Plan, konfigurasi harus mencakup kunci
-
Kunci API untuk penyedia dikonfigurasi salah.
- Pastikan Anda telah memasukkan kunci API yang valid, tidak kosong, dan tidak mengandung spasi tambahan.
- Jika Anda menggunakan Coding Plan, pastikan untuk menggunakan kunci paket (
sk-sp-xxx). - Jika UI web menampilkan
__OPENCLAW_REDACTED__, kunci API sudah disimpan dan tidak perlu dimasukkan ulang. Jika kosong atau menampilkanYOUR_API_KEY, Anda harus memasukkan kunci tersebut lagi.
-
Cache kredensial lokal yang usang mencegah konfigurasi baru berlaku.
Sebelum menghapus kredensial lama, backup file tersebut untuk memungkinkan rollback jika diperlukan.
# Hapus kredensial lama dan cache model
rm ~/.openclaw/agents/main/agent/auth-profiles.json
rm ~/.openclaw/agents/main/agent/models.json
# Restart Gateway untuk menerapkan konfigurasi baru
openclaw gateway restart
OpenClaw: Error "API rate limit reached"
Periksa hal-hal berikut secara berurutan:
-
Konfigurasi OpenClaw salah
Jika URL dasar atau penyedia model dikonfigurasi salah, permintaan mungkin tidak diarahkan melalui saluran Coding Plan dan malah diarahkan ke panggilan API umum, sehingga memicu batas laju.
- Jika Anda menggunakan langganan Coding Plan, verifikasi bahwa
models,agents, dangateway(termasuk field bersarang) di file konfigurasi OpenClaw konsisten dengan konfigurasi dalam dokumentasi. Misalnya, struktur untuk penyedia layanan model adalah{ "models": { "providers": { "bailian": {...} } } }. - Jika Anda tidak memiliki langganan Coding Plan, beralihlah ke langganan tersebut untuk mendapatkan kuota paket.
- Jika Anda menggunakan langganan Coding Plan, verifikasi bahwa
-
Kuota langganan telah habis: Periksa penggunaan langganan Anda di halaman Coding Plan.
-
Coba reset kunci API: Jika masalah tetap berlanjut setelah menyelesaikan pemeriksaan sebelumnya, buka halaman Coding Plan untuk mereset kunci API Anda.
OpenClaw: Error "Failed to discover" saat startup
OpenClaw menampilkan salah satu error berikut saat startup:
Failed to discover Alibaba Cloud models: TimeoutError: The operation was aborted due to timeoutFailed to discover Alibaba Cloud models: 404 Not Found
Penyebab: OpenClaw mencoba mengkueri daftar model untuk Coding Plan Model Studio, tetapi daftar model ini tidak dapat dikueri melalui API.
Solusi:
- Pesan ini tidak memengaruhi operasi normal OpenClaw dan dapat diabaikan.
- Jika OpenClaw tidak berjalan dengan baik, periksa pesan error lainnya.
- Untuk menekan prompt ini, hapus
alibaba-cloud:default profiledari file~/.openclaw/agents/main/agent/auth-profiles.json. Contohnya:
"profiles": {
"alibaba-cloud:default": {
"type": "api_key",
"provider": "alibaba-cloud",
"key": "sk-sp-xxxxx"
}
}
Setelah diubah menjadi "profiles": {}, prompt tersebut tidak akan muncul lagi.
OpenClaw: Error "auth.profiles"
Anda mungkin melihat error serupa berikut saat menggunakan OpenClaw:
auth.profiles.qwen-portal:default.mode: Invalid inputauth.profiles.qwen-portal:default: Unrecognized key: "apiKey"
Penyebab: Field auth.profiles di file openclaw.json dimodifikasi secara salah, seperti mengubah mode menjadi nilai yang tidak valid atau menambahkan field apiKey. Field auth hanya menyimpan metadata autentikasi, bukan kunci rahasia. Coding Plan tidak perlu dikonfigurasi di auth.profiles.
- Perbaiki konfigurasi
auth.profilesdengan menghapus field yang salah ditambahkan atau dimodifikasi serta profil yang tidak perlu. - Pastikan Kunci API untuk Coding Plan dikonfigurasi di
models.providers.bailian.apiKey. Untuk informasi lebih lanjut, lihat OpenClaw.
Apakah Coding Plan mendukungAgent Teamsdi Claude Code?
Tidak didukung. Error berikut dilaporkan: "model claude-opus-4-6 tidak didukung.".
Apakah Coding Plan mendukung OpenAI Responses API?
Tidak. Coding Plan hanya mendukung protokol OpenAI Chat Completions dan protokol Anthropic Messages. OpenAI Responses API tidak didukung.
Error "HTTP 401: Incorrect API key provided"
Kemungkinan penyebabnya:
-
Format Kunci API tidak valid: Kunci API kosong, formatnya salah, tidak lengkap, atau mengandung spasi tambahan. Pastikan Anda menggunakan Kunci API untuk Coding Plan, yang dimulai dengan
sk-sp-. Salin seluruh kunci dan pastikan tidak mengandung spasi tambahan. -
Langganan Coding Plan kedaluwarsa atau tidak valid: Kunci API spesifik Coding Plan bergantung pada status langganan. Jika langganan Coding Plan Anda telah kedaluwarsa atau tidak valid, kunci yang sesuai tidak akan berfungsi lagi. Pastikan langganan Anda aktif.
-
URL Dasar salah: Anda telah mengonfigurasi Kunci API spesifik Coding Plan (yang dimulai dengan
sk-sp-), tetapi URL Dasar masih diatur ke alamat Model Studio standar, seperti https://dashscope-intl.aliyuncs.com/compatible-mode/v1. Berdasarkan alat AI yang Anda integrasikan, ganti URL Dasar dengan alamat spesifik Coding Plan yang sesuai dari tabel di bawah ini.Alat
Protokol
URL Dasar
OpenClaw
OpenAI-compatible
https://coding-intl.dashscope.aliyuncs.com/v1
OpenCode
Anthropic-compatible
https://coding-intl.dashscope.aliyuncs.com/apps/anthropic/v1
Claude Code
Anthropic-compatible
https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
Cursor
OpenAI-compatible
https://coding-intl.dashscope.aliyuncs.com/v1
VSCode Cline
OpenAI-compatible
https://coding-intl.dashscope.aliyuncs.com/v1
Qwen Code
OpenAI-compatible
https://coding-intl.dashscope.aliyuncs.com/v1
-
Kunci API salah digunakan: Anda mengonfigurasi URL Dasar Coding Plan, tetapi salah memasukkan Kunci API tujuan umum untuk Model Studio, yang dimulai dengan
sk-. Harap perbarui Kunci API ke Kunci API Coding Plan. -
Error konfigurasi akibat cache OpenClaw yang usang: Di file
~/.openclaw/agents/main/agent/models.json, hapus item konfigurasiproviders.bailian, lalu restart OpenClaw.
Error "Authentication failed" dengan token ModelScope
Error ini menunjukkan bahwa Anda terhubung ke layanan ModelScope pihak ketiga, bukan Coding Plan. Untuk terhubung ke Coding Plan, lihat Hubungkan ke klien atau alat pengembangan.
Error ini terjadi saat Anda memberikan kredensial yang salah untuk layanan API . Periksa hal-hal berikut secara berurutan:
- Anda memasukkan kredensial akses yang salah untuk platform: Token ModelScope berformat
ms-xxx, sedangkan Kunci API umum untuk Alibaba Cloud Model Studio berformatsk-xxx. Keduanya adalah platform independen, dan kredensial aksesnya tidak dapat dipertukarkan. Kunjungi ModelScope untuk mendapatkan token. - Format salah: Pastikan tidak ada spasi tambahan atau jeda baris saat menyalin token ModelScope.
Error "Only available for Coding Agents"
Error ini menunjukkan bahwa panggilan dilakukan dari alat atau lingkungan yang tidak didukung.
Coding Plan secara eksklusif digunakan dalam alat pemrograman, seperti Claude Code dan Qwen Code, dan tidak didukung di alat seperti curl, Postman, atau Dify.
Masalah penagihan dan kuota
Biaya tak terduga dengan Coding Plan
Jika Anda terus dikenai biaya atau memiliki pembayaran tertunda setelah berlangganan Coding Plan, hal ini mungkin disebabkan oleh salah satu alasan berikut:
-
Konfigurasi salah pada Kunci API dan URL Dasar spesifik paket (Alasan paling umum)
- Penyebab: Jika Anda mengonfigurasi alat AI Anda dengan Kunci API tujuan umum (berformat
sk-xxx) dan URL Dasar tujuan umum (yang tidak mengandung kata kuncicoding), sistem mengidentifikasi panggilan tersebut sebagai bayar sesuai penggunaan dan menagihnya sesuai ketentuan. - Solusi: Anda harus menggunakan konfigurasi Coding Plan. Kunci API harus berformat
sk-sp-xxx, dan URL Dasar harus mengandung kata kuncicoding(sepertihttps://coding -intl .dashscope.aliyuncs.com/xxx). Untuk informasi lebih lanjut, lihat Dapatkan Kunci API dan URL Dasar paket.
- Penyebab: Jika Anda mengonfigurasi alat AI Anda dengan Kunci API tujuan umum (berformat
-
Pembayaran tertunda akibat keterlambatan penagihan (biaya yang timbul sebelum berlangganan Coding Plan)
- Penyebab: Tagihan diagregasi per menit, dan pembuatan tagihan mungkin tertunda beberapa menit. Misalnya, panggilan API yang dilakukan pukul 16:00 mungkin tidak ditagih hingga pukul 16:05, yang bisa jadi setelah Anda berlangganan Coding Plan.
- Solusi: Biaya didasarkan pada waktu penagihan aktual. Untuk detailnya, lihat Kueri tagihan dan manajemen biaya.
-
Secara tidak sengaja menggunakan kredensial API tujuan umum
- Penyebab: Jika konfigurasi tujuan umum dan spesifik paket keduanya disimpan di alat Anda, beberapa alat (seperti OpenClaw) mungkin secara otomatis mengarahkan permintaan menggunakan kredensial tujuan umum, sehingga menghasilkan biaya.
- Solusi: Kami menyarankan menghapus konfigurasi API tujuan umum dari alat Anda dan memastikan Anda memilih model yang didukung oleh Coding Plan. Misalnya, di OpenCode, pilih model dengan label penyedia 'Model Studio Coding Plan'.
-
Cache klien tidak dihapus
- Penyebab: Setelah mengonfigurasi kredensial baru, beberapa alat mungkin masih menggunakan versi cache dari kredensial API tujuan umum lama.
- Solusi: Hapus cache dan restart alat tersebut. Misalnya, dengan OpenClaw, hapus file
~/.openclaw/agents/main/agent/models.json, jalankanopenclaw gateway restartuntuk merestart layanan, lalu konfigurasi ulang sesuai dokumentasi OpenClaw.
Kuota habis
- Paket Lite: Jika Anda menghabiskan kuota 5 jam atau mingguan, tunggu hingga direset secara otomatis. Jika Anda menghabiskan kuota bulanan, Anda harus menunggu hingga siklus langganan berikutnya untuk direset.
- Paket Pro: Jika Anda menghabiskan kuota 5 jam atau mingguan, tunggu hingga direset secara otomatis. Jika Anda menghabiskan kuota bulanan, Anda harus menunggu hingga siklus langganan berikutnya untuk direset.
Beralih otomatis ke bayar sesuai penggunaan
Tidak. Setelah kuota Coding Plan Anda habis, panggilan API lebih lanjut akan gagal dengan error, dan penggunaan tidak akan secara otomatis beralih ke bayar sesuai penggunaan. Untuk terus menggunakan layanan, Anda harus menunggu kuota direset pada siklus langganan berikutnya.
Uji coba gratis dan Coding Plan
Coding Plan adalah langganan mandiri. Sistem penagihan dan kuotanya terpisah dari program uji coba gratis untuk model tujuan umum di Model Studio.
Perhitungan periode langganan
Langganan Anda aktif pada saat pembelian dan berakhir pada pukul 23:59:59 (UTC+8) pada hari yang sesuai di bulan berikutnya. Jika bulan berikutnya tidak memiliki hari yang sesuai, langganan berakhir pada pukul 23:59:59 (UTC+8) pada hari terakhir bulan tersebut.
Contoh: Jika Anda berlangganan Coding Plan pada 3 Februari 2026, langganan tersebut akan berlaku hingga 3 Maret 2026.
Menampilkan konsumsi token
Fitur ini saat ini tidak didukung. Konsumsi kuota Coding Plan didasarkan pada jumlah panggilan model, bukan pada konsumsi token. Anda dapat melihat informasi penggunaan Anda di halaman Coding Plan.
Penggunaan berdasarkan model tertentu
Fitur ini tidak didukung. Halaman Coding Plan hanya menampilkan konsumsi keseluruhan dan kuota yang tersisa untuk seluruh paket.
Langganan tahunan
Saat ini, Coding Plan hanya tersedia sebagai langganan bulanan. Paket tahunan belum tersedia.
Gagal perpanjangan otomatis
Hal ini mungkin disebabkan oleh alasan berikut:
- Pengaturan belum berlaku: Perpanjangan otomatis berlaku sehari setelah Anda mengaktifkannya, bukan segera.
- Dana tidak mencukupi: Biaya perpanjangan otomatis didebet dari metode pembayaran yang ditautkan ke akun Anda. Pastikan metode pembayaran Anda valid dan memiliki dana yang cukup.
Perpanjangan setelah kedaluwarsa
Tidak, perpanjangan tidak didukung setelah langganan telah kedaluwarsa.
Error perpanjangan ganda
Penyebab: Anda telah memperpanjang langganan untuk bulan berikutnya, dan perpanjangan untuk bulan tambahan tidak didukung.
Periode layanan perpanjangan dini
Saat Anda membeli paket satu bulan, durasi langganan dihitung berdasarkan bulan kalender. Paket aktif segera setelah pembelian dan berakhir pada pukul 23:59:59 (UTC+8) pada hari yang sesuai di bulan berikutnya. Jika bulan berikutnya tidak memiliki hari yang sesuai, paket berakhir pada pukul 23:59:59 (UTC+8) pada hari terakhir bulan tersebut. Jika Anda memperpanjang lebih awal, periode baru diperpanjang dari tanggal kedaluwarsa asli.
Contoh:
- Langganan awal pada 15 Maret pukul 10:00 berakhir pada 15 April pukul 23:59:59.
- Jika Anda memperpanjang satu bulan pada 10 April, tanggal kedaluwarsa baru diperpanjang hingga 15 Mei pukul 23:59:59.
Menggunakan kupon untuk perpanjangan
Ya, Anda dapat menggunakan kupon tujuan umum.
Perpanjangan langganan
Anda dapat memperpanjang paket Pro di halaman Coding Plan atau halaman Perpanjangan. Untuk informasi tentang penghentian perpanjangan untuk paket Lite Basic, lihat Pengumuman.
Fitur produk
Model yang didukung
Baik paket Lite maupun Pro mendukung semua model yang termasuk dalam paket tersebut (termasuk Qwen, GLM, Kimi, dan MiniMax). Untuk daftar lengkap model, lihat Ikhtisar Coding Plan.
Pembaruan daftar model
Daftar model yang didukung diperbarui secara berkala. Untuk daftar terkini, rujuk ke halaman Ikhtisar Coding Plan.
Batas langganan
Setiap akun Model Studio hanya dapat berlangganan satu Coding Plan dalam satu waktu (baik paket Lite maupun Pro).
Apakah Anda dapat menggunakan model yang tidak ada didaftar model yang didukung?
Coding Plan hanya mendukung model yang ada di daftar model yang didukung. Menggunakan model lain akan menghasilkan error.
Kecepatan respons paket Lite dan Pro
Paket Lite dan Pro menawarkan kecepatan respons yang sama karena menggunakan sumber daya model dan layanan inferensi yang sama.
Perpanjangan dan peningkatan paket Lite
Terhitung mulai 13 April 2026, paket Lite tidak akan lagi tersedia untuk perpanjangan dan tidak dapat ditingkatkan ke paket Pro. Untuk detailnya, lihat pengumuman.
- Jika Anda memiliki paket Lite, Anda dapat menggunakannya hingga masa berlakunya habis.
- Jika Anda telah mengaktifkan perpanjangan otomatis untuk paket Lite Anda, sistem akan secara otomatis menonaktifkannya 30 hari setelah tanggal pengumuman. Anda dapat terus menggunakan paket tersebut hingga periode layanan saat ini berakhir.
Terima kasih atas pengertian dan dukungan Anda terhadap Alibaba Cloud Model Studio.
Menurunkan ke paket Lite
Tidak, penurunan tidak didukung.
Batas konkurensi
Ya, Coding Plan memiliki batas konkurensi. Platform secara dinamis menyesuaikan batas ini berdasarkan beban sumber daya keseluruhan untuk mencegah overload pada jam-jam sibuk dan memastikan kecepatan respons dan kualitas inferensi yang stabil untuk setiap agen. Jika Anda mencapai batas konkurensi, tunggu beberapa saat lalu coba lagi.
Dukungan multi-pengguna
Kunci API Coding Plan hanya untuk penggunaan pribadi dan tidak boleh dibagikan. Jika sistem mendeteksi bahwa kunci API Anda telah dipublikasikan, kunci tersebut mungkin secara otomatis dinonaktifkan.
Berbagi paket Pro
Tidak. Jaga kerahasiaan kunci API Anda. Jangan membagikannya kepada orang lain atau mengeksposnya dalam kode sisi klien. Jika sistem mendeteksi bahwa kunci API Anda telah dipublikasikan, kunci tersebut mungkin secara otomatis dinonaktifkan.
Jendela konteks model dan penanganan overflow
Nama model | Jendela konteks (token) |
|---|---|
qwen3.7-plus | 1.000.000 |
qwen3.6-plus | 1.000.000 |
qwen3.5-plus | 1.000.000 |
kimi-k2.5 | 262.144 |
glm-5 | 202.752 |
MiniMax-M2.5 | 196.608 |
qwen3-max-2026-01-23 | 262.144 |
qwen3-coder-next | 262.144 |
qwen3-coder-plus | 1.000.000 |
glm-4.7 | 202.752 |
Jika Anda mengalami error karena melebihi jendela konteks, kami menyarankan untuk memulai sesi baru. Anda juga dapat menggunakan metode berikut untuk menghindari masalah ini:
- Beralih model: Beralih ke model yang mendukung jendela konteks lebih besar, seperti qwen3.7-plus, qwen3.6-plus, qwen3.5-plus, atau qwen3-coder-plus.
- Kurangi file yang tidak relevan: Kami menyarankan memulai alat coding AI Anda di direktori proyek tertentu dan hanya menyimpan file proyek yang diperlukan.
- Pecah tugas: Pecah tugas kompleks menjadi sub-tugas yang lebih kecil dan tanyakan satu per satu untuk mengurangi konteks yang digunakan dalam satu permintaan.
- Beri instruksi yang tepat: Permintaan yang samar dapat memicu pemindaian file yang tidak perlu. Gunakan pertanyaan atau instruksi yang jelas dan spesifik saat menggunakan alat coding AI.
Operasi spesifik bervariasi tergantung alatnya. Untuk detailnya, rujuk ke Hubungkan ke Klien/Alat Pengembangan.
Mereset kunci API
Di halaman Coding Plan, klik tombol Reset di samping kunci API Coding Plan Anda.
CatatanSetelah mereset kunci API Anda, Anda harus memperbaruinya di semua alat tempat kunci tersebut digunakan. Jika tidak, alat-alat tersebut akan berhenti berfungsi.
Jika Coding Plan kedaluwarsa dan tidak diperpanjang, apakah Kunci API direset saat diaktifkan kembali?
Ya, akan direset. Jika Anda memperpanjang sebelum tanggal kedaluwarsa, kunci API Anda tidak akan direset.
Pengingat kedaluwarsa
Ya. Sistem mengirim pengingat perpanjangan 7, 3, dan 1 hari sebelum langganan Anda berakhir melalui pesan di situs, email, SMS, dan panggilan suara otomatis.
Mengonfigurasi notifikasi kedaluwarsa
Fitur ini tidak didukung. Sistem secara otomatis mengirim pengingat kedaluwarsa 7, 3, dan 1 hari sebelum langganan Anda berakhir melalui pesan di situs, email, SMS, dan panggilan suara otomatis. Tidak diperlukan langganan manual.
Banyak kunci API
Tidak. Saat ini, hanya satu kunci API yang didukung per langganan Coding Plan.
Dukungan daftar izin IP
Tidak. Jika kunci API Anda dikompromikan, reset di halaman Coding Plan.
Akses Pengguna RAM ke kunci API
Harap hubungi pemilik Akun Alibaba Cloud atau Pengguna RAM dengan izin administratif untuk menambahkan izin Subscription Plans ke akun Anda.
Menggunakan dengan VSCode
Gunakan ekstensi VS Code yang mendukung API kompatibel OpenAI atau Anthropic, seperti Qwen Code atau Claude Code.
Kuantisasi model
Model dalam Coding Plan, seperti glm-5 dan qwen3.5-plus, adalah versi lengkap yang tidak mengalami kuantisasi atau pengurangan fitur.
Coding Plan vs. Rencana Hemat AI Tujuan Umum
Fitur | ||
|---|---|---|
Kasus penggunaan | Untuk alat coding AI (seperti Claude Code, OpenClaw, dll.) | Untuk mengimbangi biaya bayar sesuai penggunaan untuk panggilan API Model Studio tujuan umum |
Format kunci API |
|
|
Domain URL dasar |
|
|
Metode penagihan | Langganan bulanan | Ditagih berdasarkan penggunaan token |
Skenario yang berlaku | Pemrograman AI interaktif | Panggilan API dan pengembangan aplikasi |
Menangani error data_inspection_failed
Lihat dokumentasi Kode Error.
Menggunakan dengan Dify
Menggunakan Coding Plan di Dify tidak disarankan. Coding Plan hanya ditujukan untuk alat coding AI, seperti Claude Code dan Qwen Code. Jangan gunakan kunci API paket untuk skrip otomatis, backend aplikasi kustom, atau skenario pemanggilan batch non-interaktif apa pun. Penggunaan seperti itu melanggar ketentuan layanan dan dapat mengakibatkan penangguhan langganan atau penonaktifan kunci API Anda.
Menggunakan Coding Plan di Postman
Hal ini tidak disarankan. Coding Plan hanya ditujukan untuk alat coding AI, seperti Claude Code dan Qwen Code. Jangan gunakan kunci API paket untuk skrip otomatis, backend aplikasi kustom, atau skenario pemanggilan batch non-interaktif apa pun. Penggunaan seperti itu melanggar ketentuan layanan dan dapat mengakibatkan penangguhan langganan atau penonaktifan kunci API Anda.