Tool IntegrationsJuly 15, 2026Flatkey

Panduan Pengaturan Flatkey untuk Penyedia OpenAI-Compatible di Continue.dev

Atur Continue.dev dengan Flatkey sebagai penyedia yang kompatibel dengan OpenAI: config.yaml, apiBase, alias model, peran, pengecekan tool-use, fallback endpoint, dan tinjauan penggunaan.

Panduan Pengaturan Flatkey untuk Penyedia OpenAI-Compatible di Continue.dev

Penyedia yang kompatibel dengan OpenAI di Continue.dev bukan sekadar pergantian model-provider. Untuk asisten pemrograman, rute ini harus membuktikan empat hal: Continue membaca config.yaml yang dimaksud, Flatkey adalah base URL di belakang penyedia OpenAI, alias model diaktifkan untuk kunci Anda, dan model yang dipilih dapat mendukung peran Continue yang Anda tetapkan.

Panduan ini ditulis untuk pengembang, tim produk AI, pembangun otomasi, engineer platform, operator keuangan, dan reviewer pengadaan yang menginginkan satu rute yang dapat ditinjau dan kompatibel dengan OpenAI untuk Continue dan alat AI mereka yang lain. Panduan ini mencakup dokumentasi Continue terkini, pengecekan base URL Flatkey, peran model, kemampuan penggunaan alat, fallback endpoint, visibilitas penggunaan, dan rollback.

Catatan sumber: ini telah diperiksa pada 29 Juni 2026 terhadap homepage Continue resmi, dokumen penyedia OpenAI Continue resmi, referensi config.yaml Continue resmi, panduan kemampuan model Continue resmi, dan halaman publik Flatkey yang aktif. Homepage Continue saat ini menyatakan bahwa Continue telah diakuisisi oleh Cursor, jadi verifikasi ekstensi Continue, CLI, dan jalur dukungan yang Anda inginkan sebelum membuat keputusan rollout baru untuk seluruh tim.

Jawaban cepat: pengaturan penyedia yang kompatibel dengan OpenAI di Continue.dev

Untuk pengaturan penyedia yang kompatibel dengan OpenAI di Continue.dev dengan Flatkey, konfigurasikan model di config.yaml Continue dengan provider: openai, atur apiBase ke base URL penyedia Flatkey Anda saat ini, gunakan API key Flatkey, dan atur model ke alias model Flatkey yang tepat. Lalu uji base URL dan alias model yang sama di luar Continue sebelum mengandalkannya di workspace kode.

Field Continue Nilai Flatkey Pengecekan review
provider openai Dokumen penyedia OpenAI Continue menunjukkan provider ini untuk endpoint yang kompatibel dengan OpenAI ketika apiBase diganti.
apiBase Base URL Flatkey saat ini dari konsol atau dokumen Anda, seperti https://console.flatkey.ai/v1 jika telah diverifikasi untuk akun Anda Gunakan hanya base URL. Jangan tempelkan endpoint penuh /chat/completions ke dalam apiBase.
apiKey Kunci Flatkey yang dimiliki oleh pengguna, tim, atau lingkungan yang tepat Gunakan secret atau alur environment-variable yang didukung versi Continue Anda. Jangan commit kunci literal.
model Alias model Flatkey yang tepat dan diaktifkan untuk kunci tersebut Jangan gunakan nama keluarga vendor kecuali Flatkey mengekspos alias yang tepat itu.
roles dan capabilities Tetapkan hanya role yang harus dilayani model, dan tambahkan tool_use hanya setelah mengonfirmasi dukungan tools/fungsi Dokumen kemampuan Continue menghubungkan tool_use dengan tools dan fungsi, yang penting untuk workflow Agent.

Urutan yang aman adalah: salin base URL Flatkey saat ini, pilih alias model yang terlihat oleh akun, uji endpoint yang kompatibel dengan OpenAI, tambahkan model ke Continue, jalankan satu prompt berisiko rendah, dan verifikasi penggunaan di Flatkey. Sisa panduan penyedia yang kompatibel dengan OpenAI di Continue.dev ini mengubahnya menjadi runbook yang dapat diulang.

Apa yang dikonfirmasi oleh dokumen Continue saat ini

Continue sekarang mendokumentasikan konfigurasi melalui config.yaml. Panduan konfigurasinya menyatakan bahwa konfigurasi lokal berada di ~/.continue/config.yaml pada macOS/Linux dan %USERPROFILE%\.continue\config.yaml pada Windows. Panduan itu juga menyatakan bahwa Continue memuat ulang konfigurasi saat file disimpan, yang membuat perubahan kecil pada provider mudah diuji dan di-rollback.

Halaman penyedia OpenAI menunjukkan pola yang penting untuk Flatkey: entri model dapat menggunakan provider: openai, nama model yang kompatibel dengan OpenAI, override apiBase, dan API key. Ini membuat jalur penyedia yang kompatibel dengan OpenAI di Continue.dev menjadi tugas konfigurasi base URL dan alias model, bukan tugas implementasi provider kustom.

Referensi config.yaml menambahkan detail operasional. Model Continue dapat menentukan role seperti chat, edit, dan autocomplete. Continue juga dapat menimpa kemampuan model, termasuk tool_use dan image_input, ketika deteksi otomatis tidak cukup. Gunakan field-field itu secara sengaja. Model yang cocok untuk autocomplete mungkin bukan pilihan yang tepat untuk penggunaan alat bergaya agent.

Satu detail endpoint lagi penting: dokumentasi penyedia OpenAI Continue menjelaskan kontrol endpoint, termasuk perilaku completions lawas dan menonaktifkan Responses API ketika route model memerlukan /chat/completions. Halaman harga publik Flatkey yang diperiksa untuk artikel ini mencantumkan keluarga endpoint termasuk /v1/chat/completions dan /v1/responses, tetapi alias model yang Anda pilih dan izin akun tetap perlu diverifikasi.

Nilai Flatkey yang harus dikonfirmasi sebelum mengedit Continue

Beranda Flatkey yang diperiksa pada 29 Juni 2026 memiliki judul One API gateway for production AI teams dan menjelaskan akses model terpadu, routing, penagihan, analitik penggunaan, dan kontrol operasional. Contoh kode publiknya saat ini menggunakan https://console.flatkey.ai/v1/chat/completions, jadi base URL yang cocok untuk konfigurasi Continue adalah https://console.flatkey.ai/v1 ketika itulah nilai yang dikonfirmasi akun Anda.

Halaman harga Flatkey yang diperiksa pada hari yang sama menyatakan bahwa situs saat ini memiliki 635 model yang diaktifkan di 23 penyedia. Halaman itu juga mencantumkan keluarga endpoint untuk chat completions, responses, messages, images, dan video. Itu adalah fakta katalog dan rute publik, bukan janji bahwa setiap key dapat memanggil setiap model. Sebelum menyimpan route Continue.dev OpenAI compatible provider, pastikan alias model terlihat oleh key Flatkey yang akan digunakan Continue.

Jika tim Anda memiliki dokumen, skrip, atau posting blog Flatkey lama yang menyebut base URL berbeda, jangan menyalinnya mentah-mentah. Perlakukan Flatkey Console atau dokumentasi akun saat ini sebagai sumber kebenaran, lalu jalankan preflight di bawah dari mesin yang sama tempat Continue akan berjalan.

Langkah demi langkah: konfigurasikan Continue dengan Flatkey

  1. Konfirmasi surface Continue. Tentukan apakah Anda mengonfigurasi ekstensi IDE, CLI, atau setup lokal yang sudah ada. Karena beranda Continue kini menyatakan bahwa produk tersebut telah diakuisisi oleh Cursor, verifikasi dukungan dan jalur instalasi sebelum rollout baru.
  2. Buka config.yaml yang aktif. Gunakan pemilih config dan ikon roda gigi Continue, atau buka ~/.continue/config.yaml di macOS/Linux atau %USERPROFILE%\.continue\config.yaml di Windows.
  3. Catat entri model sebelumnya. Simpan provider, model, roles, dan flag endpoint lama sehingga rollback menjadi operasi salin-tempel.
  4. Salin base URL Flatkey. Gunakan base URL provider, misalnya https://console.flatkey.ai/v1 ketika sudah diverifikasi untuk akun Anda. Jangan sertakan /chat/completions di apiBase.
  5. Pilih satu alias model per role. Mulailah dengan model chat/edit dan tambahkan autocomplete hanya jika Anda memiliki model yang disetel untuk role tersebut.
  6. Simpan key Flatkey dengan aman. Gunakan pola secret, environment variable, atau kredensial lokal yang didukung oleh versi Continue Anda. Jangan commit key mentah ke config yang dibagikan.
  7. Tambahkan entri model. Gunakan provider: openai, apiBase Flatkey, alias model Flatkey, dan roles yang spesifik.
  8. Jalankan preflight curl. Uji base URL, key, dan model yang sama sebelum menilai Continue itu sendiri.
  9. Jalankan satu prompt Continue yang aman. Gunakan branch sekali pakai atau tugas yang tidak merusak, lalu periksa penggunaan Flatkey untuk timestamp, model, token, dan biaya.
  10. Dokumentasikan kepemilikan. Catat siapa pemilik key, siapa yang dapat merotasinya, alias model mana yang disetujui, dan kapan route perlu ditinjau ulang.

Template config.yaml untuk Flatkey

Ini adalah template, bukan drop-in universal. Ganti placeholder dengan nilai yang telah diverifikasi di akun Flatkey Anda dan versi Continue Anda saat ini.

name: Flatkey Continue Config
version: 0.0.1
schema: v1

models:
  - name: Flatkey chat and edit
    provider: openai
    model: <flatkey-chat-model-alias>
    apiBase: https://console.flatkey.ai/v1
    apiKey: <load-from-your-continue-secret-or-env-flow>
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
    defaultCompletionOptions:
      maxTokens: 2000

  - name: Flatkey autocomplete
    provider: openai
    model: <flatkey-autocomplete-model-alias>
    apiBase: https://console.flatkey.ai/v1
    apiKey: <load-from-your-continue-secret-or-env-flow>
    roles:
      - autocomplete
    autocompleteOptions:
      debounceDelay: 350
      maxPromptTokens: 1024

Jika route model yang Anda pilih mengalami masalah dengan /responses, dokumentasi provider OpenAI Continue menjelaskan opsi useResponsesApi: false. Gunakan itu hanya setelah Anda memiliki bukti bahwa model, keluarga endpoint, atau route akun membutuhkan /chat/completions untuk tugas tersebut.

models:
  - name: Flatkey chat completions only
    provider: openai
    model: <flatkey-model-alias>
    apiBase: https://console.flatkey.ai/v1
    apiKey: <load-from-your-continue-secret-or-env-flow>
    useResponsesApi: false
    roles:
      - chat
      - edit

Preflight route di luar Continue

Uji curl kecil memisahkan masalah routing Flatkey dari masalah konfigurasi Continue. Gunakan base URL, key, dan alias model yang sama yang akan Anda masukkan ke config.yaml.

export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_CONTINUE_MODEL="replace-with-flatkey-model-alias"

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_CONTINUE_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Kembalikan kata ok."
      }
    ],
    "max_tokens": 16
  }'

Untuk route gaya agen Continue.dev OpenAI compatible provider, tambahkan preflight kedua dengan skema tool jika role Continue yang Anda pilih membutuhkan penggunaan tool. Respons chat biasa membuktikan transport, tetapi tidak membuktikan perilaku fungsi/tool.

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_CONTINUE_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Call route_check with status ok and no prose."
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "route_check",
          "description": "Return the route status.",
          "parameters": {
            "type": "object",
            "properties": {
              "status": { "type": "string" }
            },
            "required": ["status"]
          }
        }
      }
    ],
    "tool_choice": {
      "type": "function",
      "function": { "name": "route_check" }
    },
    "max_tokens": 64
  }'

Respons penggunaan tool yang sehat seharusnya menyertakan struktur tool_calls bergaya OpenAI. Jika permintaan ini gagal, perbaiki key Flatkey, base URL, alias model, keluarga endpoint, atau kapabilitas model sebelum mengubah Continue lagi.

Daftar periksa kapabilitas, peran, dan endpoint

Keputusan Yang perlu diverifikasi Mengapa ini penting
Model chat/edit Alias model dapat menjawab pertanyaan kode melalui endpoint Flatkey yang dipilih. Ini adalah bukti minimum untuk peran chat dan edit yang menghadap developer.
Penggunaan tool Model mengembalikan panggilan tool bergaya OpenAI dalam preflight curl. Dokumentasi kapabilitas model Continue mengaitkan tool_use dengan tools dan functions.
Autocomplete Peran terpisah, prompt lebih pendek, latensi dapat diterima dari mesin developer. Autocomplete memiliki ekspektasi UX yang berbeda dari chat.
Responses API Rute model yang dipilih mendukung endpoint yang dipanggil Continue. Beberapa kombinasi model dan gateway memerlukan useResponsesApi: false.
Review penggunaan Flatkey menampilkan request di bawah key, timestamp, model, dan biaya yang diharapkan. Tim finance dan pemilik platform membutuhkan satu tempat untuk merekonsiliasi penggunaan.

Mode kegagalan yang harus didebug terlebih dahulu

Sebagian besar kegagalan Continue.dev OpenAI compatible provider berasal dari sejumlah kecil ketidaksesuaian. Periksa hal-hal ini sebelum menganggap Continue atau Flatkey sedang down.

Gejala Penyebab yang mungkin Perbaikan
Konfigurasi tidak termuat File salah, error indentasi YAML, atau konfigurasi lama yang dipilih di dalam IDE. Buka konfigurasi melalui pemilih Continue, validasi YAML, simpan, dan pantau pemuatan ulang.
Invalid API key Key disalin dengan tidak benar, dirotasi, dibatasi ke environment lain, atau milik upstream provider. Generate atau pilih key Flatkey yang benar dan uji ulang dengan curl sebelum memperbarui Continue.
Connection error apiBase menyertakan path endpoint lengkap, menggunakan base URL lama, atau mesin tidak dapat menjangkau route tersebut. Gunakan hanya base URL provider saat ini dan uji dari mesin yang sama.
Model not found Nilai model di Continue tidak cocok dengan alias Flatkey yang diaktifkan untuk key tersebut. Salin alias model yang persis dari pricing Flatkey, katalog, atau daftar model yang terlihat di akun.
Tools atau mode Agent gagal Model yang dipilih tidak dapat menghasilkan perilaku tool/function yang diharapkan oleh peran. Gunakan model yang mendukung tool dan jalankan ulang preflight panggilan tool sebelum menetapkan tool_use.
Error khusus endpoint Continue memanggil /responses padahal route yang dipilih seharusnya memakai chat completions, atau sebaliknya. Periksa dukungan endpoint Flatkey dan gunakan flag endpoint Continue hanya bila diperlukan.
Penggunaan tidak bisa direkonsiliasi Tim tidak mencatat pemilik key, alias model, developer, environment, atau timestamp. Tambahkan baris runbook sebelum memperluas pengaturan ke lebih banyak developer.

Runbook produksi untuk Continue plus Flatkey

Sebelum lebih banyak developer menggunakan route Continue.dev OpenAI compatible provider, catat fakta operasional yang memungkinkan dukungan dan review biaya.

Field runbook Catat ini
Owner Tim, grup developer, dan orang yang bisa merotasi key Flatkey.
Surface Continue Ekstensi IDE atau CLI, versi jika tersedia, dan lokasi konfigurasi.
Flatkey base URL Base URL yang disetujui akun saat ini dan tanggal pengecekan.
Alias model Satu alias per peran: chat/edit, apply, autocomplete, atau path agent tool-use.
Kebijakan endpoint Apakah route harus menggunakan responses, chat completions, atau fallback yang terdokumentasi.
Review biaya Di mana penggunaan, jumlah token, status request, dan biaya akan ditinjau di Flatkey.
Rollback Entri provider sebelumnya, alias model lama, dan persetujuan pemilik untuk mengembalikan.

Di mana ini cocok dalam cluster tool Flatkey

Jika tim Anda sudah merutekan alat lain melalui Flatkey, gunakan pola operasi yang sama untuk Continue. Panduan pengaturan API Cherry Studio berguna untuk pemeriksaan URL dasar klien desktop yang sederhana. Panduan CC Switch Claude Code Flatkey berguna untuk disiplin perutean alat developer. Playbook migrasi API yang kompatibel dengan OpenAI yang lebih luas adalah tempat untuk menstandarkan perubahan base URL, verifikasi alias model, dan rollback.

Nilai dari router terpadu bukan hanya berkurangnya jumlah kunci provider. Melainkan kemampuan untuk melihat alat, model, pemilik kunci, dan alur kerja mana yang menghasilkan penggunaan. Itulah mengapa migrasi Continue.dev OpenAI compatible provider harus diakhiri dengan pemeriksaan penggunaan Flatkey, bukan hanya prompt yang berfungsi.

Pertanyaan yang sering diajukan

Apakah Continue masih mendukung perutean yang kompatibel dengan OpenAI?

Dokumentasi provider OpenAI terbaru dari Continue menunjukkan pola konfigurasi yang kompatibel dengan OpenAI menggunakan provider: openai, model, apiBase, dan apiKey. Beranda mereka juga menyebutkan bahwa Continue telah diakuisisi oleh Cursor, jadi verifikasi ekstensi, CLI, dan jalur dukungan Anda yang tepat sebelum rollout baru.

Base URL Flatkey apa yang harus saya gunakan?

Gunakan base URL provider terkini dari akun Flatkey Anda. Beranda publik yang diperiksa untuk artikel ini menunjukkan https://console.flatkey.ai/v1/chat/completions, yang dipetakan ke https://console.flatkey.ai/v1 sebagai base URL. Dokumentasi akun atau konsol Anda yang berlaku jika berbeda.

Haruskah satu model menangani setiap peran Continue?

Tidak secara otomatis. Chat, edit, apply, autocomplete, dan penggunaan alat bergaya agent dapat memiliki kebutuhan latensi, konteks, dan kapabilitas yang berbeda. Mulailah dengan penugasan peran yang paling sempit dan tambahkan lebih banyak peran setelah pengujian.

Apakah saya memerlukan tool_use?

Hanya ketika peran tersebut memerlukan perilaku alat/fungsi dan model yang dipilih memang dapat mengembalikan panggilan tool ala OpenAI. Continue dapat mendeteksi otomatis banyak kapabilitas, tetapi dokumentasinya mengizinkan override untuk deployment khusus atau kasus ketika autodeteksi tidak berfungsi.

Bagaimana saya harus menangani API key?

Simpan kunci Flatkey di luar file repositori, tangkapan layar, dan komentar issue yang dibagikan. Gunakan pola secret lokal atau environment variable yang didukung oleh versi Continue Anda, lalu catat siapa yang memiliki dan dapat merotasi kuncinya.

Daftar periksa akhir

  • Surface Continue terkini telah diverifikasi setelah pemberitahuan akuisisi oleh Cursor.
  • config.yaml aktif telah ditemukan dan dicadangkan.
  • Base URL Flatkey disalin dari sumber akun terkini.
  • Alias model telah dikonfirmasi untuk kunci Flatkey.
  • Perilaku endpoint chat completions atau responses telah diuji.
  • Prapemeriksaan penggunaan tool telah dijalankan ketika peran memerlukan alat.
  • Penggunaan telah ditinjau di Flatkey setelah prompt Continue aman pertama.
  • Pemilik rollback dan konfigurasi sebelumnya telah dicatat.

Ketika pemeriksaan tersebut selesai, rute Continue.dev OpenAI compatible provider menjadi integrasi Flatkey yang dapat dikelola, bukan lagi kredensial developer lain yang tidak dikelola. Jika Anda menstandarkan lebih banyak alat, bandingkan alias model dan kebijakan penggunaan di harga Flatkey, lalu dapatkan kunci untuk workspace yang akan memiliki rollout pertama.