Jika Anda mencari kunci API Open AI, langkah praktisnya sederhana: buat kunci API proyek di OpenAI Platform, simpan di server atau pengelola rahasia, buat permintaan uji kecil di sisi server, lalu tambahkan kontrol biaya dan keandalan sebelum trafik nyata masuk. Kunci tersebut adalah rahasia autentikasi—bukan nilai konfigurasi sisi klien dan bukan paket produksi dengan sendirinya.
OpenAI ditulis sebagai satu kata dalam dokumentasi produknya. Panduan ini menggunakan frasa pencarian berjarak “Open AI API key” ketika membantu orang menemukan langkah penyiapan yang mereka perlukan.
Jawaban singkat: Buat kunci di dasbor OpenAI Platform, muat sebagai
OPENAI_API_KEYdi server, gunakan dengan autentikasi bearer atau SDK resmi, tinjau harga dan batas API saat ini, lalu siapkan rotasi, pencatatan permintaan, dan perilaku coba lagi sebelum peluncuran.
Apa yang dilakukan—dan tidak dilakukan—oleh kunci API OpenAI
Kunci API OpenAI mengautentikasi aplikasi ke API. Kunci ini memungkinkan platform mengaitkan permintaan dengan organisasi dan proyek yang berlaku. Kunci ini tidak membuat kredensial aman untuk diekspos di browser, aplikasi seluler, repositori publik, atau bundel sisi klien.
Kunci ini juga tidak menggantikan kontrol operasional. Layanan produksi tetap memerlukan pemilik penagihan, aturan pemilihan model, batas permintaan, observabilitas, jalur rollback, dan jawaban untuk apa yang terjadi ketika dependensi lambat atau tidak tersedia. Ringkasan API OpenAI merekomendasikan peninjauan kode kesalahan, batas laju, dan pencatatan ID permintaan sebelum pekerjaan produksi dimulai. Ringkasan API OpenAI
Cara mendapatkan kunci API Open AI
- Masuk ke halaman kunci API OpenAI Platform dan pilih organisasi atau proyek yang harus memiliki penggunaan tersebut.
- Buat kunci API proyek untuk beban kerja tersebut. Beri nama yang jelas dan berorientasi pada tujuan, seperti
support-api-prodataustaging-evals. - Tetapkan tanggal kedaluwarsa ketika platform menawarkan opsi tersebut. OpenAI merekomendasikan kedaluwarsa dan proses rotasi rutin untuk kunci proyek. Praktik terbaik produksi
- Letakkan nilainya di lingkungan lokal Anda hanya untuk pengujian pengembangan jangka pendek. Dalam lingkungan yang diterapkan, masukkan melalui penyimpanan rahasia penyedia hosting Anda atau pengelola rahasia khusus.
- Jangan pernah menempelkan nilainya ke aplikasi frontend, prompt, tiket, dokumen bersama, atau kontrol sumber.
Kunci API Open AI harus dipetakan ke batas kepemilikan yang nyata. Gunakan proyek atau kredensial terpisah untuk pengembangan, staging, dan produksi ketika model operasional Anda memerlukan akses, batas, atau pencabutan yang independen. Hal itu membuat kebocoran, insiden anggaran, atau peluncuran lebih mudah dikendalikan.
Integrasikan kunci API Open AI di server
SDK resmi OpenAI membaca OPENAI_API_KEY dari lingkungan. Contoh Node.js berikut menjaga kredensial tetap di luar basis kode dan menjadikan model yang dipilih sebagai konfigurasi penerapan, bukan asumsi yang di-hard-code.
npm install openai
export OPENAI_API_KEY="replace-this-locally"
export OPENAI_MODEL="your-approved-model-id"
import OpenAI from "openai";
if (!process.env.OPENAI_API_KEY) {
throw new Error("OPENAI_API_KEY is not configured");
}
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
});
const response = await client.responses.create({
model: process.env.OPENAI_MODEL,
input: "Return a one-sentence health check for this integration.",
});
console.log(response.output_text);
Jalankan ini hanya dari lingkungan sisi server. panduan cepat pengembang OpenAI menunjukkan pola variabel lingkungan yang sama dan instruksi instalasi SDK terbaru.
Jaga batas klien tetap eksplisit
Untuk produk web atau seluler, browser harus memanggil backend Anda. Backend Anda mengautentikasi pengguna, menerapkan kuota produk dan aturan penyalahgunaan Anda, memanggil OpenAI dengan rahasia tersebut, dan hanya mengembalikan hasil yang dibutuhkan klien. Ini mencegah satu kunci penyedia yang bocor berubah menjadi penggunaan pihak ketiga tanpa batas.
Jika Anda menggunakan fungsi serverless, aturan yang sama berlaku: konfigurasikan rahasia di runtime sisi server fungsi, bukan dalam variabel build yang terlihat oleh browser. Tambahkan pemindai rahasia repositori dan pemeriksaan pre-commit atau CI agar commit yang tidak disengaja tertangkap sebelum menjadi insiden kredensial.
Tentukan harga alur kerja kunci API Open AI tanpa menebak
Jangan perlakukan artikel ini sebagai kartu tarif statis. Harga API, ketersediaan model, dan biaya fitur dapat berubah. Gunakan halaman harga API resmi untuk tarif saat ini, lalu hitung biaya tugas produk yang selesai—bukan hanya item baris token.
| Biaya atau kontrol | Yang perlu diputuskan sebelum peluncuran |
|---|---|
| Penggunaan model dan token | Ukur permintaan yang representatif, termasuk input, output, serta penggunaan penalaran atau alat apa pun yang dipanggil oleh beban kerja Anda. |
| Biaya fitur | Periksa harga terkini untuk alat, penyimpanan, atau modalitas yang benar-benar digunakan aplikasi Anda. |
| Percobaan ulang | Batasi upaya percobaan ulang agar insiden sementara tidak melipatgandakan volume beban kerja dan biaya. |
| Peringatan pengeluaran | Tetapkan ambang notifikasi yang menjangkau orang yang dapat mengambil tindakan. |
| Batas pengeluaran ketat | Pahami kompromi terhadap waktu henti: OpenAI menyatakan bahwa permintaan yang terdampak batas pengeluaran ketat akan mengembalikan 429 setelah batas yang dikonfigurasi tercapai. |
| Kontrol per pengguna | Terapkan kuota dan batas penyalahgunaan pada tingkat produk Anda sendiri sebelum pengguna akhir dapat menyebabkan tagihan tak terduga. |
Perbedaannya penting: peringatan pengeluaran memberi tahu Anda bahwa suatu ambang telah terlewati; peringatan tersebut tidak menghentikan lalu lintas. Batas ketat dapat melindungi anggaran, tetapi juga dapat menghentikan fitur yang sebenarnya sehat. Uji perilaku tersebut dan siapkan fallback yang berhadapan dengan pelanggan sebelum mengandalkannya. Batas laju dan kontrol pengeluaran OpenAI
Apakah kunci API Open AI gratis?
Membuat kunci API tidak sama dengan menerima alokasi produksi gratis yang dijamin. Biaya API bergantung pada model dan fitur yang Anda gunakan, dan kelayakan akun, penagihan, serta batas dapat berubah. Verifikasi status penagihan saat ini, batas penggunaan, dan halaman harga langsung organisasi Anda sebelum menjanjikan pengalaman gratis kepada pengguna.
Amankan kunci API Open AI sepanjang siklus hidupnya
Kunci API yang paling aman adalah kunci yang digunakan secara terbatas, dipantau, dan mudah diganti. OpenAI secara eksplisit menyatakan untuk tidak mengekspos kunci API di browser atau aplikasi serta merekomendasikan variabel lingkungan sisi server atau layanan manajemen kunci. Panduan autentikasi OpenAI
Gunakan siklus hidup minimum berikut:
- Buat dengan pemilik. Catat proyek, layanan, lingkungan, tim yang bertanggung jawab, dan masa berlaku yang dimaksudkan.
- Simpan sekali. Letakkan nilainya dalam pengelola rahasia atau rahasia deployment sisi server; berikan akses kepada sesedikit mungkin orang dan beban kerja secara praktis.
- Gunakan melalui satu batas. Biarkan layanan aplikasi, bukan perangkat pengguna akhir, mengirimkan permintaan ke penyedia.
- Rotasikan dengan sengaja. Buat penggantinya, deploy, verifikasi permintaan nyata, lalu cabut kredensial lama.
- Cabut saat terekspos. Perlakukan kunci penyedia yang masuk ke log publik, browser, repositori, atau transkrip chat sebagai telah dikompromikan. Ganti kunci tersebut alih-alih mencoba menentukan apakah kunci itu telah disalin.
Untuk daftar periksa yang lebih luas mengenai inventaris rahasia, respons kebocoran, dan tata kelola, lihat panduan Flatkey tentang manajemen kunci API yang aman untuk produk AI.
Daftar periksa produksi: beralih dari permintaan yang berfungsi ke layanan yang dapat dioperasikan
Pengujian yang paling berguna bukanlah “apakah satu prompt mengembalikan teks?” Melainkan “dapatkah tim mengoperasikan jalur permintaan ini dengan aman ketika penggunaan, kegagalan, dan biaya benar-benar terjadi?”
| Pemeriksaan | Selesai ketika |
|---|---|
| Isolasi kredensial | Kredensial penyedia hanya ada dalam penyimpanan rahasia sisi server dan runtime deployment. |
| Kepemilikan proyek | Seorang pemilik yang ditunjuk dapat melihat penagihan, merotasi kredensial, dan merespons insiden. |
| Kesiapan penagihan | Tim telah meninjau harga terkini, batas penggunaan, ambang peringatan, dan perilaku batas ketat. |
| Konfigurasi model | Model produksi dikonfigurasi di luar kode sumber dan diuji pada tugas yang representatif. |
| Telemetri permintaan | Anda mencatat ID korelasi, hasil, latensi, model, sinyal token/biaya yang tersedia bagi Anda, serta ID permintaan OpenAI saat dikembalikan. |
| Penanganan batas laju | Layanan mematuhi header batas laju dan mengikuti Retry-After ketika valid. |
| Kebijakan percobaan ulang | Percobaan ulang dibatasi, diberi jitter, dan terbatas pada kondisi sementara—bukan kesalahan kuota, penagihan, atau permintaan yang tidak valid. |
| Keamanan peluncuran | Feature flag, canary, atau prosedur rollback tersedia sebelum perubahan model atau prompt dipromosikan. |
| Kontrol pengguna | Pengguna akhir memiliki kuota tingkat produk, autentikasi, dan perlindungan penyalahgunaan yang sesuai dengan fitur. |
| Jalur insiden | Tim dapat mencabut kunci yang dikompromikan, men-deploy pengganti, dan memberi tahu pemilik yang terdampak tanpa berimprovisasi. |
OpenAI merekomendasikan pencatatan header x-request-id untuk pemecahan masalah produksi. OpenAI juga membedakan pembatasan laju sementara dari kesalahan yang memerlukan perubahan penagihan, kuota, atau konfigurasi. Respons 429 sementara dan kelebihan beban 503 memerlukan penanganan yang berbeda dari kesalahan yang tidak dapat Anda selesaikan dengan percobaan ulang. Praktik produksi OpenAI dan panduan batas laju
Ketika satu kunci penyedia tidak lagi menjadi keseluruhan arsitektur
Mulai secara langsung ketika satu penyedia dan satu beban kerja memenuhi kebutuhan Anda. Seiring produk menambahkan model, modalitas, wilayah, atau kontrol biaya pelanggan yang berbeda, pekerjaan sering kali bergeser dari “di mana saya menaruh rahasia?” menjadi “bagaimana saya mengelola dan memantau beberapa upstream tanpa mengubah setiap klien?”
Di situlah gateway atau router dapat berguna. panduan awal integrasi Flatkey dan daftar periksa migrasi gateway API yang kompatibel dengan OpenAI menjelaskan cara mengevaluasi satu permukaan kompatibilitas tanpa mengasumsikan bahwa setiap penyedia memiliki perilaku yang identik. Pertahankan jalur OpenAI langsung beserta pengujiannya sambil memvalidasi streaming, alat, error, batas laju, dan kemampuan khusus model.
FAQ
Di mana saya membuat kunci API?
Buat kunci tersebut di pengaturan kunci API OpenAI Platform untuk organisasi atau proyek yang benar. panduan cepat pengembang resmi menautkan ke alur pembuatan saat ini.
Dapatkah saya menggunakan kunci API di JavaScript browser atau aplikasi seluler?
Tidak. Jangan distribusikan rahasia penyedia ke lingkungan yang dikendalikan klien. Arahkan permintaan melalui backend Anda, tempat kunci tetap berada dalam penyimpanan rahasia sisi server dan aturan autentikasi serta kuota Anda sendiri dapat dijalankan terlebih dahulu.
Mengapa permintaan kunci API saya mengembalikan 429?
Pertama, periksa isi respons dan header. 429 dapat mencerminkan batas laju sementara, tetapi juga dapat mencerminkan kondisi pengeluaran, kuota, atau penagihan yang tidak akan diperbaiki dengan mencoba ulang. Ikuti Retry-After untuk penundaan sementara yang valid, gunakan backoff eksponensial terbatas dengan jitter bila sesuai, dan arahkan error yang memerlukan tindakan kepada pemilik. panduan batas laju OpenAI berisi perbedaan terkini.
Haruskah setiap engineer berbagi satu kunci API?
Hindari kredensial produksi bersama yang tidak memiliki pemilik. Pisahkan kunci atau proyek berdasarkan lingkungan dan layanan jika memungkinkan, tetapkan kepemilikan, dan lakukan rotasi sesuai jadwal yang direncanakan. Hal itu memberi Anda cakupan dampak yang lebih kecil dan jejak audit yang bersih ketika sebuah kunci harus diganti.
Langkah berikutnya
Jalankan kunci API Open AI terlebih dahulu dengan satu permintaan kecil di sisi server. Kemudian lakukan hal-hal rutin yang mencegah insiden mahal: lingkungan terpisah, pemilik yang ditetapkan, pemeriksaan harga terkini, peringatan pengeluaran, jalur rotasi, ID permintaan, dan perilaku coba ulang yang telah diuji. Jika masalah berikutnya adalah akses multi-model, bukan penyiapan OpenAI langsung, tinjau panduan cepat Flatkey sebelum mengubah integrasi klien yang ada.
