Cara Integrasikan OpenAI API ke dalam Apl Anda

Untuk mengintegrasikan OpenAI API, cipta kunci API dalam projek OpenAI, simpan sebagai rahsia di pelayan bernama OPENAI_API_KEY, dan panggil API daripada laluan di pelayan anda sendiri menggunakan SDK rasmi OpenAI, bukan sekali-kali dari kod pelayar. Pada September 2026, panduan permulaan pantas OpenAI meletakkan Responses API sebagai titik permulaan untuk projek baharu. Tetapkan had perbelanjaan sebelum pelancaran, hadkan panjang balasan, hadkan kekerapan setiap pengguna boleh memanggil ciri itu, dan uruskan ralat had kadar dengan cubaan semula.

Panduan ini meliputi persediaan, aliran permintaan, prompt untuk pembina AI, dan kesilapan yang membocorkan kunci atau membazirkan wang. Butiran OpenAI adalah daripada dokumentasi rasminya setakat September 2026. Untuk konsep umum (token, tetingkap konteks, harga), baca cara guna LLM API dahulu.

Apa yang boleh anda bina dengannya

Pembantu sembang dalam apl anda (cara bina aplikasi chatbot AI)
Butang "Ringkaskan ini", "tulis semula ini" atau "draf balasan"
Mengekstrak data berstruktur daripada teks bebas: menukar e-mel kepada pesanan, menanda tiket sokongan
Carian dan menjawab soalan ke atas kandungan anda sendiri
Ciri imej, pertuturan dan media lain, bergantung pada model yang tersedia

Lebih banyak idea ada dalam cara tambah ciri AI ke dalam apl anda.

Menyediakan akaun OpenAI anda

Cipta akaun dan projek dalam platform OpenAI. Panduan amalan terbaik pengeluaran OpenAI mengesyorkan projek berasingan untuk staging dan pengeluaran, supaya setiap satu boleh mempunyai kunci dan had sendiri.
Cipta kunci API projek. OpenAI mengesyorkan menetapkan tarikh tamat dan menukar kunci secara berkala.
Tetapkan amaran perbelanjaan dan had perbelanjaan keras pada halaman had. Panduan OpenAI menyatakan amaran memberitahu anda apabila penggunaan melepasi jumlah tertentu, dan had keras menguatkuasakan had bulanan.
Tambah pengebilan. Dokumentasi had kadar OpenAI menerangkan tahap penggunaan: had anda meningkat secara automatik apabila anda berbelanja lebih dari masa ke masa.

Aliran permintaan

Pelayar  ->  laluan pelayan anda  ->  OpenAI API
         <-  (balasan distrim)    <-

Pengguna mengklik butang atau menghantar mesej.
Pelayar memanggil laluan anda, contohnya POST /api/summarise.
Pelayan anda menyemak pengguna telah log masuk dan dibenarkan menggunakan ciri itu.
Pelayan membina permintaan: arahan, input pengguna, dan sebarang data daripada pangkalan data yang diperlukan tugas.
Ia memanggil OpenAI dengan kunci daripada persekitaran. SDK OpenAI membaca OPENAI_API_KEY secara automatik.
Ia menstrim atau memulangkan balasan, dan merekod penggunaan token.

Pakej SDK rasmi OpenAI dinamakan openai untuk JavaScript/TypeScript (npm) dan Python (pip).

Memilih model

OpenAI menawarkan beberapa model pada harga dan kelajuan berbeza, dan senarai itu kerap berubah. Mulakan dengan model yang lebih kecil dan lebih murah, ukur kualiti dengan contoh sebenar, dan naik taraf hanya jika perlu. Simpan nama model dalam nilai konfigurasi atau rahsia supaya anda boleh menukarnya tanpa menulis semula kod. Semak halaman harga OpenAI untuk kadar semasa.

Pilihan dan pertukaran

Keputusan	Pilihan mudah	Bila hendak lebih jauh
Streaming	Pulangkan jawapan penuh	Strim untuk sembang dan balasan panjang; pengguna nampak teks serta-merta
Memori perbualan	Hantar mesej terkini setiap kali	Ringkaskan mesej lama apabila sembang menjadi panjang
Format output	Teks biasa	Minta JSON berstruktur apabila kod anda perlu membaca medan
Data anda sendiri	Sertakan rekod berkaitan dalam permintaan	Tambah carian ke atas kandungan anda apabila terlalu banyak untuk dimasukkan (lihat apa itu RAG)
Kerja pukal tidak mendesak	Gelung pada setiap item	Gunakan pilihan batch OpenAI untuk kos lebih rendah apabila keputusan boleh menunggu

Prompt untuk pembina AI anda

Ciri pertama:

Tambah butang "Ringkaskan" pada halaman tiket. Ia memanggil laluan pelayan POST /api/summarise yang menyemak pengguna telah log masuk, memuatkan tiket, dan memanggil OpenAI Responses API menggunakan SDK rasmi openai dan rahsia OPENAI_API_KEY. Baca nama model daripada rahsia OPENAI_MODEL. Arahan: "Ringkaskan dalam 3 poin, kemudian cadangkan balasan ringkas. Jangan reka nombor pesanan." Hadkan panjang output, strim balasan ke halaman, dan jangan sekali-kali hantar kunci ke pelayar.

Pengawal:

Hadkan setiap pengguna kepada 30 permintaan AI sejam, disimpan dalam pangkalan data. Rekod token input dan output bagi setiap permintaan bersama ID pengguna dan nama ciri. Jika OpenAI mengembalikan 429, hormati pengepala Retry-After dan cuba semula dengan backoff eksponen dan jitter sehingga 3 kali; selepas itu, papar "AI sedang sibuk, cuba lagi dalam seminit." Papar ralat mesra untuk sebarang kegagalan lain dan kekalkan bahagian lain halaman berfungsi.

Mengendalikan ralat dan had

OpenAI mengukur had kadar dengan beberapa cara, termasuk permintaan seminit dan token seminit, dan anda akan mencapai mana-mana yang habis dahulu. Apabila anda melepasi salah satu, API mengembalikan 429 dengan pengepala Retry-After. Dokumentasi OpenAI menyatakan supaya anda menganggap nilai itu sebagai minimum dan menambah sedikit kelewatan rawak supaya klien tidak semua cuba semula serentak.

Juga rancang untuk:

Tamat masa pada penjanaan yang panjang. Streaming membantu, begitu juga had output yang munasabah.
Gangguan pembekal. Ciri AI patut gagal dengan baik tanpa memecahkan halaman.
Output yang buruk. Sahkan output berstruktur sebelum menyimpannya, dan jangan biarkan output model mencetuskan tindakan sensitif tanpa semakan dalam kod anda.

Kesilapan biasa

Kunci dalam frontend atau dalam repositori. Kod pelayar adalah awam, dan kunci yang bocor boleh disalah guna dalam beberapa minit. Lihat cara pastikan kunci API selamat.
Tiada had perbelanjaan. Gelung atau pengguna yang menyalahgunakan boleh menaikkan bil besar dengan cepat.
Tiada had setiap pengguna. Had pembekal melindungi dompet anda, bukan pengguna lain anda.
Mempercayai prompt untuk keselamatan. Pengguna boleh menaip "abaikan arahan sebelumnya". Kebenaran patut berada dalam kod pelayan.
Menghantar lebih daripada yang diperlukan. Dokumen penuh dan sejarah panjang menggandakan kos. Hantar apa yang tugas perlukan.
Mengkodkan nama model secara keras. Model dikemas kini dan ditamatkan; jadikannya tetapan.
Menghantar data peribadi tanpa berfikir. Baca terma penggunaan data OpenAI dan hantar hanya apa yang ciri perlukan.

Senarai semak

Projek OpenAI berasingan (atau kunci) untuk ujian dan pengeluaran
Kunci disimpan sebagai rahsia di pelayan, tidak sekali-kali dalam kod pelayar atau repositori
Amaran perbelanjaan dan had perbelanjaan keras ditetapkan
Semua panggilan melalui pelayan anda dan menyemak kebenaran pengguna
Panjang output dihadkan; nama model boleh dikonfigurasi
Had setiap pengguna dalam apl anda
Pengendalian 429 dengan Retry-After, backoff dan jitter
Keadaan ralat mesra; halaman berfungsi tanpa AI
Penggunaan token direkod bagi setiap ciri
Diuji dengan input panjang, kosong dan bermusuhan

Menggunakan OpenAI API dalam Mythex

Ciri AI dalam apl yang anda bina di Mythex menggunakan kunci OpenAI anda sendiri, dibilkan ke akaun OpenAI anda dan bukan kepada kredit binaan Mythex. Tambah OPENAI_API_KEY sebagai rahsia projek melalui /secrets, tetapan projek atau kad rahsia yang ditunjukkan ejen apabila ia memerlukan kunci, kemudian terangkan ciri dengan prompt seperti di atas. Selepas menukar rahsia pada apl yang diterbitkan, terbitkan semula supaya ia mengambilnya. Resipi dokumen Tambah ciri AI dengan kunci API anda sendiri mempunyai prompt permulaan, dan Rahsia dalam sembang menerangkan kad rahsia. Membandingkan pembekal? Lihat cara integrasi Claude API.

Soalan lazim

Apakah OpenAI API yang patut saya guna untuk apl baharu?

Pada September 2026, panduan permulaan pantas OpenAI membentangkan Responses API sebagai titik permulaan untuk projek baharu, dengan contoh menggunakan client.responses.create() dalam SDK rasminya. Semak dokumentasi OpenAI untuk cadangan semasa sebelum anda mula.

Bolehkah saya panggil OpenAI API dari pelayar?

Tidak dengan kunci rahsia anda. Sesiapa sahaja boleh membaca kod pelayar dan menggunakan semula kunci itu untuk menaikkan bil anda. Pelayar patut memanggil laluan pelayan anda sendiri, dan pelayan anda memanggil OpenAI dengan kunci yang disimpan sebagai pembolehubah persekitaran.

Bagaimana saya hentikan OpenAI API daripada menelan kos terlalu banyak?

Panduan pengeluaran OpenAI mengesyorkan amaran perbelanjaan dan had perbelanjaan bulanan yang keras pada halaman had. Dalam apl anda, hadkan panjang balasan, hadkan permintaan setiap pengguna, dan rekod penggunaan token supaya anda tahu ciri mana yang paling mahal.

Apa maksud ralat 429 daripada OpenAI?

Ia bermaksud anda telah mencapai had kadar. Dokumentasi had kadar OpenAI menyatakan respons termasuk pengepala Retry-After; tunggu sekurang-kurangnya tempoh itu, tambah sedikit kelewatan rawak, dan cuba semula dengan backoff eksponen.