Kunci API Codex VS Code: Gunakan Endpoint Kustom

Yang sedang Anda siapkan

Asisten kode di VS Code berkomunikasi dengan model melalui HTTP. Sebagian besar menggunakan format API OpenAI, yang berarti mereka menerima URL dasar dan kunci kustom, bukan pengaturan default vendor. Layanan ini kompatibel dengan OpenAI, sehingga dapat terhubung ke alat apa pun yang menyediakan opsi tersebut.

Pahami apa yang ada di sisi lain. Ini adalah satu model bobot terbuka yang dijalankan oleh penyedia independen, yang disesuaikan untuk menjawab tanpa penolakan konten untuk penggunaan dewasa yang sah. Ini bukan model Codex OpenAI dan bukan API resmi vendor lain. Ini hanya teks, dengan jendela 100.000 token, pemanggilan fungsi, dan mode JSON. Jika Anda ingin detail rute bergaya OpenAI, baca dokumentasi; jika Anda hanya memerlukan alamat, lihat halaman URL dasar API Codex.

Berikut adalah tiga nilai yang harus digunakan di mana saja:

Dapatkan kunci dan uji terlebih dahulu

Buat akun di halaman kunci API dengan Google atau dengan email dan kata sandi. Pengguna baru dapat mengklaim $0,50 kredit uji coba dengan satu klik, berlaku selama 7 hari, tanpa memerlukan kartu. Kemudian uji kunci di terminal sebelum menyentuh VS Code. Panggilan curl yang berfungsi membuktikan kunci dan URL, sehingga kesalahan selanjutnya berkaitan dengan ekstensi.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

Balasan berupa JSON pelengkapan obrolan, dan respons menyertakan header X-Balance-USD dengan sisa saldo Anda. Simpan kunci di variabel lingkungan atau penyimpanan rahasia ekstensi, jangan di repositori.

Ekstensi dan CLI Codex: berkas konfigurasi

Alat Codex dari OpenAI mendukung penyedia model kustom melalui file konfigurasi TOML di direktori home Anda, dan ekstensi VS Code didokumentasikan untuk membagikan konfigurasi tersebut ke CLI. Verifikasi ini terhadap dokumentasi Codex terbaru untuk versi Anda, karena formatnya telah berkembang.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Poin yang harus diperiksa:

• base_url berakhir dengan /v1, tanpa /chat/completions.
• env_key adalah nama variabel lingkungan, bukan kuncinya sendiri.
• wire_api memilih format permintaan. Layanan ini menerima baik POST /v1/chat/completions maupun POST /v1/responses. Coba "chat" terlebih dahulu; gunakan "responses" jika versi Codex Anda memerlukannya.
• Mulai VS Code dari shell yang memiliki variabel yang diatur, atau mulai ulang setelah Anda menambahkan variabel ke profil Anda. Peluncuran GUI di macOS sering kali tidak melihat ekspor shell.

Alat gaya agen bergantung pada pemanggilan fungsi. Hal ini didukung di sini, termasuk pemanggilan fungsi streaming, tetapi kualitas bervariasi tergantung model, jadi jalankan tugas kecil terlebih dahulu. Halaman terkait tentang menggunakan API di Cursor mencakup pengaturan serupa di editor lain.

Continue, Cline, dan ekstensi lainnya

Ekstensi pihak ketiga masing-masing memiliki halaman pengaturan sendiri, namun polanya tetap sama: pilih penyedia OpenAI atau "kompatibel OpenAI", lalu isi URL dasar, kunci, dan model. Continue menggunakan konfigurasi YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline dan Roo Code menawarkan penyedia "Kompatibel dengan OpenAI" di panel pengaturan mereka dengan tiga bidang yang sama. Nama dan menu sering berubah, jadi cari di dokumentasi ekstensi sendiri untuk "Kompatibel dengan OpenAI" atau "URL dasar kustom". Jika ekstensi tidak memiliki bidang untuk URL dasar, ekstensi tersebut tidak dapat menggunakan endpoint ini.

Tips yang menghemat waktu:

• Nonaktifkan pelengkapan otomatis tab terhadap model yang di-hosting kecuali jika Anda menginginkan permintaan pada setiap jeda. Tindakan obrolan dan edit lebih murah.
• Atur konteks yang lebih kecil di ekstensi untuk pengeditan sehari-hari. Mengirim seluruh repositori ke model menghabiskan token input setiap kali.
• Gunakan kunci terpisah per alat sehingga Anda dapat mengetahui alat mana yang menggunakan kredit Anda.

Tugas editor mana yang cocok untuk model ini

Model teks umum dengan jendela besar adalah pilihan yang tepat untuk beberapa tugas sehari-hari: menjelaskan kode yang tidak dikenal, menulis uji unit untuk fungsi, mengonversi skrip antar bahasa, membuat draf docstring dan regex, serta menulis ulang modul saat Anda menempelkan seluruh file. Jendela 100.000 token berarti beberapa file menengah plus instruksi Anda muat dalam satu permintaan, dan penyelesaian dapat menggunakan apa pun yang tersisa.

Jadilah realistis tentang sisanya. Ini bukan model pengkodean khusus dengan pelatihan sadar editor, sehingga menjalankan agen multi-file besar mungkin memerlukan lebih banyak panduan dan pemeriksaan lebih banyak daripada yang Anda berikan untuk alat yang dibangun untuk itu. Minta diff daripada seluruh file, tinjau setiap perubahan sebelum menerimanya, dan jalankan pengujian Anda. Jika tugas memerlukan konten yang ditolak oleh asisten terfilter, seperti membuat kerangka fiksi dewasa atau teks penelitian keamanan untuk penggunaan yang sah, endpoint tanpa penolakan konten adalah alasan untuk menggunakan yang ini.

Biayanya di editor

Harga adalah $0,15 per 1M token input dan $0,50 per 1M token output. Alat pengkodean mengirim banyak konteks, jadi lihat input terlebih dahulu.

Contoh: permintaan edit dengan 8.000 token konteks file dan jawaban 600 token biayanya 8.000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. Satu hari 150 permintaan seperti itu biayanya 150 x $0,0015 = $0,225. Dua puluh hari kerja: $4,50.

Agen yang membaca banyak file dapat mengirim 40.000 token per langkah. Pada ukuran tersebut, satu langkah biayanya $0,006 ditambah output, sehingga 100 langkah biayanya sekitar $0,60 ditambah output. Perhatikan loop agen. Permintaan yang gagal atau ditolak tidak dibebankan biaya, dan saldo tidak pernah habis. Top-up dari $20 hingga $500 dapat dibayar dengan kartu (Visa, Mastercard, Apple Pay, Google Pay) atau kripto. Paket saat ini terdaftar di halaman harga.

Pemecahan Masalah

401 Tidak Diotorisasi

Kunci hilang, memiliki spasi berlebih, atau variabel lingkungan tidak terlihat oleh VS Code. Mulai ulang editor dari terminal yang memiliki variabel tersebut.

404 atau "model tidak ditemukan"

Gunakan model tepat uncensored dan URL dasar dengan /v1 di akhir.

Kesalahan 429

Kunci penuh memungkinkan 8 permintaan bersamaan dan 300 per menit; kunci uji memungkinkan 2 dan 60. Ekstensi yang memicu beberapa permintaan paralel, seperti pelengkapan otomatis plus obrolan, dapat mencapai batas konkurensi. Kode kesalahan adalah concurrency untuk terlalu banyak sekaligus dan rate_limited untuk batas per menit. Header Retry-After: 5 berarti kelebihan beban sementara.

Streaming macet

Beberapa proxy perusahaan buffering event yang dikirim server. Uji dari jaringan lain atau matikan streaming di ekstensi.

Jawaban berbeda dari yang Anda lihat dengan asisten lain

Itu diharapkan. Ini adalah model berbeda dengan kekuatan tersendiri. Berikan instruksi yang jelas dan spesifik, dan uji pada kode dari proyek Anda sendiri.

Panduan lainnya

• API Codex di Python: Memanggil LLM Pengkodean
• URL Dasar API Codex: Cara Mengarahkan Klien Anda ke Kami