Jika Anda masih memelihara instalasi Roo Code, jalur Roo Code OpenAI compatible API pada dasarnya adalah permukaan konfigurasi: tipe provider, Base URL, API key, dan Model ID. Risiko produksi ada pada bagian yang mudah terlewat. Dokumentasi provider Roo Code mensyaratkan native OpenAI-style tool calling untuk jalur ini, jadi respons chat biasa tidak cukup sebagai bukti untuk workflow coding-agent.
Panduan ini menunjukkan cara merutekan konfigurasi Roo Code yang sudah ada melalui Flatkey untuk developer, tim produk AI, pembuat otomasi, engineer platform, operator keuangan, dan reviewer pengadaan. Panduan ini mencakup caveat Roo Code saat ini, validasi base URL Flatkey, alias model yang tepat, preflight native tool-call, pengaturan Roo Code, tinjauan penggunaan, dan rollback.
Catatan sumber: ini dicek pada 29 Juni 2026 terhadap beranda dokumentasi resmi Roo Code, dokumentasi provider Roo Code OpenAI Compatible resmi, halaman publik Flatkey yang aktif, dan satu smoke test gateway Flatkey yang terautentikasi. Beranda dokumentasi Roo Code menyatakan ekstensi Roo Code dihentikan pada 15 Mei 2026, jadi perlakukan ini sebagai panduan setup untuk instalasi yang sudah ada, konfigurasi arsip, atau tinjauan migrasi, bukan sebagai rekomendasi untuk menstandarkan rollout baru tanpa memeriksa ketersediaan ekstensi.
Jawaban singkat: setup Roo Code OpenAI compatible API
Untuk setup Roo Code OpenAI compatible API dengan Flatkey, pilih OpenAI Compatible sebagai API provider, tempelkan base URL Flatkey yang saat ini berlaku, gunakan Flatkey API key, dan masukkan alias model Flatkey yang tepat yang mendukung chat kompatibel OpenAI dan native tool calling. Lalu buktikan rute tersebut dengan permintaan curl kecil sebelum mempercayainya di dalam workspace kode.
| Field Roo Code | Nilai Flatkey | Check review |
|---|---|---|
| API Provider | OpenAI Compatible | Gunakan provider ini untuk Flatkey, bukan provider OpenAI resmi. |
| Base URL | Base URL provider Flatkey saat ini untuk akun Anda, seperti https://router.flatkey.ai/v1 jika itu adalah nilai yang terverifikasi |
Tempelkan hanya base URL. Jangan tempelkan endpoint lengkap /chat/completions ke Roo Code. |
| API Key | Flatkey key yang dimiliki oleh user, tim, atau environment yang tepat | Jangan mencampur kunci upstream provider dengan base URL Flatkey. |
| Model ID | Alias model Flatkey yang tepat dan diaktifkan untuk kunci tersebut | Konfirmasikan alias mendukung endpoint chat OpenAI dan native tool calls sebelum menggunakannya untuk tugas coding. |
| Validation | Chat kecil plus smoke test tool-call, lalu satu prompt Roo Code yang aman | Periksa penggunaan Flatkey setelah tes agar finance dan owner platform dapat merekonsiliasi rute tersebut. |
Jalur aman tercepat adalah: buktikan transport Flatkey, buktikan alias model, buktikan native tool calling, lalu simpan pengaturan Roo Code. Sisa panduan Roo Code OpenAI compatible API ini mengubahnya menjadi checklist yang dapat diulang.
Apa yang dikonfirmasi oleh dokumentasi Roo Code saat ini
Beranda dokumentasi Roo Code saat ini memuat peringatan penghentian ekstensi. Itu penting untuk perencanaan. Jika tim Anda menggunakan instalasi Roo Code yang sudah ada, detail konfigurasi di bawah ini masih berguna untuk maintenance dan tinjauan migrasi. Jika tim Anda memilih standar coding assistant baru, verifikasi dulu status ekstensi, marketplace, dan fork sebelum menetapkan Roo Code untuk kelompok yang lebih luas.
Halaman provider Roo Code OpenAI Compatible mendokumentasikan tiga nilai utama untuk kelas provider ini: Base URL, API Key, dan Model ID. Halaman itu juga menyatakan untuk memilih OpenAI Compatible sebagai API provider. Base URL adalah endpoint provider dan secara eksplisit bukan URL API OpenAI resmi ketika Anda menggunakan provider yang tidak kompatibel dengan OpenAI.
Konstraint penting khusus Roo adalah tool calling. Halaman provider yang sama menyatakan Roo Code menggunakan native tool calling secara eksklusif dan tidak memiliki fallback berbasis XML. Halaman itu juga menyatakan model yang dipilih harus mendukung OpenAI-compatible tool calling. Untuk jalur Roo Code OpenAI compatible API melalui Flatkey, itu berarti alias model tidak dapat divalidasi hanya dengan generasi teks biasa.
Nilai Flatkey yang perlu dikonfirmasi sebelum membuka Roo Code
1. Konfirmasikan base URL untuk akun Anda
Beranda Flatkey yang dicek pada 29 Juni 2026 memiliki judul One API gateway for production AI teams dan deskripsi meta yang menyatakan Flatkey menyatukan akses model, routing, billing, usage analytics, dan kontrol operasional. Contoh beranda publik mencakup chat completions bergaya OpenAI. Pemeriksaan runtime terautentikasi untuk artikel ini menggunakan https://router.flatkey.ai/v1 dan menghasilkan daftar model yang valid.
Karena contoh publik dan rute spesifik akun dapat berbeda seiring waktu, salin base URL Flatkey saat ini dari konsol, dokumentasi, atau environment kerja Anda sebelum production. Di Roo Code, Base URL harus berupa base provider, bukan /v1/chat/completions.
2. Konfirmasikan alias model dan dukungan tool
Halaman harga Flatkey yang diperiksa pada 29 Juni 2026 menyebutkan bahwa mereka mempublikasikan harga yang dirender di server untuk 635 model AI dari 23 penyedia. Peta endpoint-nya mencakup /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations, dan /v1/video/generations. Itu adalah bukti katalog dan endpoint, bukan janji bahwa setiap kunci Flatkey dapat memanggil setiap model.
Untuk setup Roo Code OpenAI compatible API, pilih satu alias model yang terlihat di akun dan mendukung chat serta panggilan tool yang kompatibel dengan OpenAI. Pemeriksaan terautentikasi untuk artikel ini mengembalikan 56 model yang terlihat di akun, dan permintaan panggilan tool kecil dengan gpt-5.4-mini mengembalikan HTTP 200 dengan finish_reason: tool_calls serta metadata penggunaan. Perlakukan itu sebagai bukti rute bertanggal untuk akun yang diuji, bukan sebagai rekomendasi permanen untuk setiap workspace Flatkey.
3. Konfirmasi kepemilikan kunci dan tinjauan penggunaan
Roo Code dapat bertindak pada workspace kode, jadi kepemilikan kunci itu penting. Gunakan kunci Flatkey yang dibatasi untuk developer, tim, atau lingkungan yang menanggung risikonya. Catat siapa yang dapat memutar kunci, alias model mana yang diizinkan, keluarga endpoint mana yang diharapkan, dan di mana log penggunaan akan ditinjau setelah prompt pertama.
Langkah demi langkah: konfigurasi Roo Code dengan Flatkey
- Periksa apakah ini instalasi Roo Code yang sudah ada. Karena dokumen resmi saat ini menyebutkan penghentian ekstensi, jangan mulai dengan mengasumsikan instalasi marketplace baru tersedia.
- Buka pengaturan provider Roo Code. Di konfigurasi ekstensi yang sudah ada, buka area model provider atau konfigurasi API.
- Pilih OpenAI Compatible. Gunakan tipe provider yang didokumentasikan Roo Code untuk endpoint yang kompatibel non-OpenAI.
- Atur Base URL. Masukkan URL dasar Flatkey yang telah diverifikasi, misalnya
https://router.flatkey.ai/v1ketika itu adalah nilai kerja saat ini untuk akun Anda. - Tempel kunci API Flatkey. Jauhkan dari file repositori, komentar issue, tangkapan layar, dan prompt.
- Atur Model ID. Masukkan alias model Flatkey yang tepat. Jangan gunakan nama keluarga vendor generik kecuali Flatkey mengekspos alias tersebut secara tepat ke kunci Anda.
- Jalankan preflight curl di bawah. Chat biasa berguna, tetapi Roo Code memerlukan native tool calling, jadi sertakan skema tool dalam pengujian.
- Jalankan satu prompt Roo Code yang aman. Gunakan workspace sekali pakai atau tugas yang tidak merusak sebelum mengarahkan Roo Code ke repositori produksi.
- Periksa penggunaan Flatkey. Konfirmasikan timestamp, pemilik kunci, alias model, penggunaan token, status, dan visibilitas biaya.
- Dokumentasikan rollback. Simpan pengaturan provider sebelumnya, alias model, dan pemilik sebelum meminta lebih banyak developer untuk beralih.
Template preflight native tool-calling
Cara paling aman untuk men-debug setup Roo Code OpenAI compatible API adalah menguji rute Flatkey di luar Roo Code terlebih dahulu. Template ini memverifikasi endpoint chat dan meminta model untuk mengembalikan tool call bergaya OpenAI.
export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
export FLATKEY_ROO_MODEL="replace-with-tool-capable-flatkey-model"
curl "$FLATKEY_BASE_URL/chat/completions" \
-H "Authorization: Bearer $FLATKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "'"$FLATKEY_ROO_MODEL"'",
"messages": [
{
"role": "user",
"content": "Panggil route_check dengan status ok dan jangan sertakan prosa."
}
],
"tools": [
{
"type": "function",
"function": {
"name": "route_check",
"description": "Kembalikan status smoke-test routing.",
"parameters": {
"type": "object",
"properties": {
"status": { "type": "string" }
},
"required": ["status"]
}
}
}
],
"tool_choice": {
"type": "function",
"function": { "name": "route_check" }
},
"max_tokens": 64
}'Respons yang sehat harus menyertakan pesan assistant dengan tool_calls. Jika permintaan ini gagal, perbaiki kunci Flatkey, base URL, alias model, atau kemampuan model sebelum mengubah pengaturan Roo Code. Jika berhasil tetapi Roo Code gagal, fokus pada field Roo Code yang disimpan, akses jaringan lokal, status ekstensi, atau Model ID persis yang dimasukkan di pengaturan provider.
Mode kegagalan yang harus didebug terlebih dahulu
| Gejala | Kemungkinan penyebab | Perbaikan |
|---|---|---|
| API key tidak valid | Key disalin secara tidak benar, dirotasi, dicakup ke environment lain, atau berasal dari upstream provider alih-alih Flatkey. | Gunakan Flatkey key yang baru, uji dengan curl, lalu tempel key yang sama ke Roo Code. |
| Error koneksi | Base URL salah, path endpoint lengkap ditempel ke field Base URL, path jaringan diblokir, atau ada masalah proxy lokal. | Verifikasi base URL provider dari mesin yang sama dan uji ulang /chat/completions. |
| Model tidak ditemukan | Model ID Roo Code tidak cocok dengan alias Flatkey yang diaktifkan untuk key tersebut. | Salin alias yang tepat dari pricing Flatkey, katalog, atau daftar model yang terlihat di akun. |
| Error tool-calling | Model yang dipilih bisa menjawab chat tetapi tidak mendukung native tool calls yang kompatibel dengan OpenAI. | Berpindah ke alias model yang mendukung tool lalu jalankan ulang preflight sebelum menggunakan Roo Code. |
| Extension tidak tersedia | Status distribusi Roo Code saat ini tidak mendukung jalur instalasi atau update yang direncanakan. | Anggap setup ini sebagai pemeliharaan legacy dan pilih workflow coding-agent yang aktif untuk rollout baru. |
| Penggunaan tidak dapat direkonsiliasi | Tim tidak mencatat pemilik key, alias model, pengguna Roo Code, environment, atau timestamp. | Tambahkan baris runbook sebelum memperluas rute ke lebih banyak developer. |
Install yang sudah ada atau standar baru?
Rute Roo Code OpenAI compatible API bisa berguna, tetapi pemberitahuan penghentian extension mengubah keputusan. Gunakan tabel ini sebelum meminta tim bergantung padanya.
| Situasi | Tindakan yang disarankan | Mengapa ini penting |
|---|---|---|
| Install Roo Code yang sudah ada masih digunakan oleh developer | Dokumentasikan rute Flatkey, uji tool calls, dan simpan rollback. | Pemeliharaan dapat berlanjut sementara tim merencanakan migrasi atau penggantian. |
| Rollout coding-agent baru untuk seluruh tim | Verifikasi ketersediaan extension saat ini terlebih dahulu, lalu bandingkan alternatif yang aktif. | Extension yang dihentikan dapat menimbulkan risiko dukungan, keamanan, dan onboarding. |
| Standardisasi cluster integrasi tool | Gunakan key Flatkey, base URL, model-alias, dan pola usage-log yang sama di seluruh tool. | Konsistensi memudahkan penagihan, debugging, dan review procurement. |
Runbook produksi untuk Roo Code plus Flatkey
Sebelum lebih banyak developer menggunakan rute Roo Code OpenAI compatible API, tuliskan fakta operasional yang memungkinkan dukungan dan review biaya.
| Field runbook | Catat ini |
|---|---|
| Ruang lingkup Roo Code | Install lokal yang sudah ada, image tim, profil yang diarsipkan, atau pengujian hanya untuk migrasi. |
| Flatkey key | Pemilik, environment, tanggal rotasi, dan pemilik pencabutan. |
| Base URL | Base URL provider yang tepat yang disimpan di Roo Code dan tanggal verifikasinya. |
| Alias model | Model ID Roo Code, alias model Flatkey, family endpoint, dan hasil native tool-call. |
| Smoke test | Status HTTP, alasan selesai, total usage, dan apakah tool_calls muncul. |
| Tinjauan usage | Tempat pemilik platform dan finance memeriksa volume request, biaya, dan perubahan model yang tidak terduga. |
| Rollback | Konfigurasi provider sebelumnya, alias model sebelumnya, dan siapa yang dapat memulihkannya. |
Jalur migrasi internal
Jika tim Anda menstandarkan konfigurasi tool yang kompatibel dengan OpenAI di Flatkey, jaga agar setup ini selaras dengan sisa cluster integrasi. Gunakan panduan migrasi API yang kompatibel dengan OpenAI sebagai base URL dan hub rollback. Untuk pola desktop-client lain, bandingkan panduan setup API Cherry Studio. Untuk routing coding-agent di mesin developer, tinjau panduan cc-switch Claude Code.
Setelah prompt Roo Code yang pertama dan aman berhasil, tinjau halaman pricing model Flatkey saat ini, lalu Dapatkan key untuk setiap user, tim, atau boundary environment yang terpisah.
Pertanyaan yang sering diajukan
Apakah Roo Code masih mendukung provider yang kompatibel dengan OpenAI?
Dokumentasi provider Roo Code OpenAI Compatible masih menjelaskan field provider: API Provider, Base URL, API Key, dan Model ID. Halaman home dokumentasi juga menyebut bahwa extension Roo Code dihentikan pada 15 Mei 2026, jadi verifikasi jalur instalasi Anda sebelum rollout baru.
Base URL apa yang harus saya gunakan untuk provider Roo Code OpenAI compatible API?
Gunakan base URL provider Flatkey yang berlaku saat ini untuk akun Anda. Pemeriksaan Flatkey terautentikasi pada artikel ini menggunakan https://router.flatkey.ai/v1, sementara contoh publik dapat berubah. Di Roo Code, tempel hanya base URL, bukan endpoint chat-completions lengkap.
Mengapa native tool calling diperlukan?
Dokumentasi provider Roo Code mengatakan native tool calling adalah satu-satunya protokol tool yang didukung untuk provider yang kompatibel dengan OpenAI. Model yang bisa menjawab chat biasa tetapi tidak bisa menghasilkan tool call bergaya OpenAI tidak cukup untuk setup Roo Code yang andal.
Haruskah Model ID cocok persis dengan alias model Flatkey?
Ya. Gunakan alias Flatkey yang persis dapat dipanggil oleh key Anda, dan verifikasi dengan smoke test tool-call. Nama family model, nama pemasaran provider, dan alias gateway bisa berbeda.
Bisakah saya menggunakan panduan ini untuk deployment Roo Code baru?
Gunakan hanya setelah memeriksa ketersediaan Roo Code saat ini. Pemeriksaan routing Flatkey tetap berguna, tetapi pemberitahuan penghentian Roo Code berarti deployment baru untuk seluruh tim memerlukan keputusan dukungan produk yang eksplisit.
Kesimpulan
Setup Roo Code OpenAI compatible API yang aman melalui Flatkey harus membuktikan lebih dari sekadar respons chat yang berhasil. Konfirmasi base URL saat ini, gunakan key milik Flatkey, pilih alias model yang persis, uji native tool calls, dan periksa visibilitas penggunaan sebelum memberi Roo Code akses ke pekerjaan kode yang sebenarnya. Saat rute siap untuk pengguna atau lingkungan lain, Dapatkan key dan simpan baris rollback di dekat instruksi setup.
