Cara Mengintegrasikan OpenAI API ke dalam Aplikasi Anda

Untuk mengintegrasikan OpenAI API, buat kunci API di dalam proyek OpenAI, simpan sebagai rahasia di sisi server bernama OPENAI_API_KEY, dan panggil API dari rute di server Anda sendiri menggunakan SDK resmi OpenAI, jangan pernah dari kode browser. Per September 2026, quickstart OpenAI menjadikan Responses API sebagai titik awal untuk proyek baru. Atur batas pengeluaran sebelum peluncuran, batasi panjang balasan, batasi seberapa sering setiap pengguna bisa memanggil fitur, dan tangani error batas laju dengan percobaan ulang.

Panduan ini membahas pengaturan, alur permintaan, prompt untuk pembuat aplikasi AI, dan kesalahan yang membocorkan kunci atau membuang uang. Detail OpenAI diambil dari dokumentasi resminya per September 2026. Untuk konsep umum (token, context window, harga), baca dulu cara menggunakan API LLM.

Apa yang bisa Anda bangun dengannya

• Asisten chat di dalam aplikasi Anda (cara membangun aplikasi chatbot AI)
• Tombol "Ringkas ini", "tulis ulang ini", atau "buat draf balasan"
• Mengekstrak data terstruktur dari teks bebas: mengubah email menjadi pesanan, memberi label pada tiket dukungan
• Pencarian dan tanya jawab atas konten Anda sendiri
• Fitur gambar, suara, dan media lainnya, tergantung model yang tersedia

Ide lainnya ada di cara menambahkan fitur AI ke aplikasi Anda.

Menyiapkan akun OpenAI Anda

1. Buat akun dan proyek di platform OpenAI. Praktik terbaik produksi OpenAI menyarankan proyek terpisah untuk staging dan produksi, sehingga masing-masing bisa memiliki kunci dan batas sendiri.
2. Buat kunci API proyek. OpenAI menyarankan untuk mengatur tanggal kedaluwarsa dan memutar kunci secara berkala.
3. Atur peringatan pengeluaran dan batas pengeluaran yang ketat di halaman limits. Panduan OpenAI menjelaskan bahwa peringatan akan memberi tahu Anda saat penggunaan melewati suatu jumlah, dan batas ketat menerapkan plafon bulanan.
4. Tambahkan penagihan. Dokumentasi batas laju OpenAI menjelaskan tingkat penggunaan: batas Anda naik secara otomatis seiring bertambahnya pengeluaran dari waktu ke waktu.

Alur permintaan

Browser  ->  rute server Anda  ->  OpenAI API
         <-  (balasan streaming) <-

1. Pengguna mengklik tombol atau mengirim pesan.
2. Browser memanggil rute Anda, misalnya POST /api/summarise.
3. Server Anda memeriksa bahwa pengguna sudah masuk dan diizinkan menggunakan fitur tersebut.
4. Server menyusun permintaan: instruksi, input pengguna, dan data dari database Anda yang dibutuhkan tugas tersebut.
5. Server memanggil OpenAI dengan kunci dari environment. SDK OpenAI membaca OPENAI_API_KEY secara otomatis.
6. Server men-streaming atau mengembalikan balasan, dan mencatat penggunaan token.

Paket SDK resmi OpenAI bernama openai, untuk JavaScript/TypeScript (npm) maupun Python (pip).

Memilih model

OpenAI menawarkan beberapa model dengan harga dan kecepatan berbeda, dan daftarnya sering berubah. Mulai dengan model yang lebih kecil dan lebih murah, ukur kualitasnya pada contoh nyata, dan naik ke model yang lebih besar hanya jika memang perlu. Simpan nama model di nilai konfigurasi atau rahasia agar Anda bisa mengubahnya tanpa menulis ulang kode. Periksa halaman harga OpenAI untuk tarif terkini.

Pilihan dan trade-off

Prompt untuk pembuat aplikasi AI Anda

Fitur pertama:

Tambahkan tombol "Ringkas" di halaman tiket. Tombol ini memanggil rute server POST /api/summarise yang memeriksa bahwa pengguna sudah masuk, memuat tiketnya, lalu memanggil OpenAI Responses API menggunakan SDK resmi openai dan rahasia OPENAI_API_KEY. Baca nama model dari rahasia OPENAI_MODEL. Instruksi: "Ringkas dalam 3 poin, lalu sarankan satu balasan singkat. Jangan mengarang nomor pesanan." Batasi panjang output, stream balasannya ke halaman, dan jangan pernah mengirim kunci ke browser.

Pengaman:

Batasi setiap pengguna hingga 30 permintaan AI per jam, disimpan di database. Catat token input dan output per permintaan beserta ID pengguna dan nama fitur. Jika OpenAI mengembalikan 429, hormati header Retry-After dan coba lagi dengan exponential backoff dan jitter hingga 3 kali; setelah itu, tampilkan "AI sedang sibuk, coba lagi sebentar lagi." Tampilkan error yang ramah untuk kegagalan lain dan biarkan bagian halaman lainnya tetap berfungsi.

Menangani error dan batas

OpenAI mengukur batas laju dalam beberapa cara, termasuk permintaan per menit dan token per menit, dan Anda akan mencapai yang habis lebih dulu. Saat Anda melampaui salah satunya, API mengembalikan 429 dengan header Retry-After. Dokumentasi OpenAI menyebutkan bahwa nilai tersebut harus diperlakukan sebagai minimum, dan tambahkan jeda acak kecil agar klien tidak semuanya mencoba ulang bersamaan.

Juga perlu diantisipasi:

• Timeout pada generasi yang panjang. Streaming membantu, begitu juga batas output yang masuk akal.
• Gangguan penyedia. Fitur AI sebaiknya gagal dengan baik tanpa merusak halaman.
• Output yang buruk. Validasi output terstruktur sebelum menyimpannya, dan jangan biarkan output model memicu tindakan sensitif tanpa pemeriksaan di kode Anda.

Kesalahan umum

• Kunci di frontend atau di repositori. Kode browser bersifat publik, dan kunci yang bocor bisa disalahgunakan dalam hitungan menit. Lihat cara menjaga kunci API tetap aman.
• Tidak ada batas pengeluaran. Sebuah loop atau pengguna yang menyalahgunakan layanan bisa menaikkan tagihan besar dengan cepat.
• Tidak ada batas per pengguna. Batas penyedia melindungi dompet Anda, bukan pengguna lain Anda.
• Mengandalkan prompt untuk keamanan. Pengguna bisa mengetik "abaikan instruksi sebelumnya". Izin harus berada di kode server.
• Mengirim lebih dari yang dibutuhkan. Dokumen utuh dan riwayat panjang melipatgandakan biaya. Kirim apa yang dibutuhkan tugas.
• Menulis nama model secara permanen di kode. Model diperbarui dan dihentikan; jadikan itu pengaturan.
• Mengirim data pribadi tanpa berpikir. Baca ketentuan penggunaan data OpenAI dan kirim hanya yang dibutuhkan fitur.

Daftar periksa

• Proyek OpenAI (atau kunci) terpisah untuk pengujian dan produksi
• Kunci disimpan sebagai rahasia di sisi server, tidak pernah di kode browser atau repositori
• Peringatan pengeluaran dan batas pengeluaran ketat diatur
• Semua panggilan lewat server Anda dan memeriksa izin pengguna
• Batas panjang output diatur; nama model bisa dikonfigurasi
• Batas laju per pengguna di aplikasi Anda
• Penanganan 429 dengan Retry-After, backoff, dan jitter
• Status error yang ramah; halaman tetap berfungsi tanpa AI
• Penggunaan token dicatat per fitur
• Diuji dengan input yang panjang, kosong, dan bermusuhan

Menggunakan OpenAI API di Mythex

Fitur AI di aplikasi yang Anda bangun di Mythex menggunakan kunci OpenAI milik Anda sendiri, ditagihkan ke akun OpenAI Anda, bukan ke kredit build Mythex. Tambahkan OPENAI_API_KEY sebagai rahasia proyek melalui /secrets, pengaturan proyek, atau kartu rahasia yang ditampilkan agen saat membutuhkan kunci, lalu jelaskan fiturnya dengan prompt seperti di atas. Setelah mengubah rahasia pada aplikasi yang sudah dipublikasikan, publikasikan ulang agar perubahan terbaca. Resep dokumentasi Tambahkan fitur AI dengan kunci API Anda sendiri memiliki prompt awal, dan Rahasia di chat menjelaskan kartu rahasia. Sedang membandingkan penyedia? Lihat cara mengintegrasikan Claude API.

Pertanyaan