Kategori: AI Integration

Tahap: 🟡 Intermediate

👥 Sesuai Untuk:

• 🛠 Agency Administrator

📋 Prasyarat:

• ✅ Artikel 3.2 – AI Providers telah dibaca.
• ✅ Akaun OpenAI.

⏱ Masa Membaca: ±15 minit

---

Pengenalan

Untuk membolehkan AnyChat menggunakan model AI daripada OpenAI, anda perlu menyediakan API Key.

API Key bertindak seperti kunci akses yang membolehkan AnyChat berkomunikasi dengan pelayan OpenAI secara selamat.

Tanpa API Key yang sah, AI Assistant tidak dapat menjana sebarang jawapan.

---

🎯 Objektif

Selepas membaca panduan ini, anda akan dapat:

• Mendapatkan API Key daripada OpenAI.
• Memahami fungsi API Key.
• Menyambungkan API Key ke AnyChat.
• Menguji sambungan bagi memastikan ia berfungsi dengan baik.

---

📖 Apa Itu API Key?

API Key ialah kod rahsia yang diberikan oleh OpenAI kepada setiap akaun.

Kod ini digunakan untuk:

• Mengenal pasti akaun anda.
• Mengesahkan setiap permintaan daripada AnyChat.
• Merekod penggunaan API.
• Mengira kos penggunaan berdasarkan token.

⚠️ API Key adalah maklumat sulit. Jangan kongsi atau dedahkan kepada pihak lain.

---

⚙️ Cara Mendapatkan API Key

1. Log masuk ke akaun OpenAI.
2. Buka bahagian API Keys.
3. Klik Create new secret key.
4. Berikan nama yang mudah dikenal pasti, contohnya:
   • AnyChat Production
   • AnyChat Testing
5. Salin API Key yang dijana.
6. Simpan di tempat yang selamat kerana ia hanya dipaparkan sekali.

---

⚙️ Menyambungkan API Key ke AnyChat

1. Buka Settings → AI Providers.
2. Klik Add Provider atau edit Provider sedia ada.
3. Pilih OpenAI.
4. Tampalkan API Key ke ruangan API Key.
5. Pastikan Base URL menggunakan nilai lalai jika anda menggunakan OpenAI secara terus.
6. Klik Save.

📸 Screenshot Dicadangkan

Paparan borang Add AI Provider dengan ruangan API Key.

---

🎯 Strategi Penggunaan

Jika anda mempunyai beberapa projek atau pelanggan, cipta API Key yang berasingan untuk setiap kegunaan.

Contohnya:

• AnyChat Production
• AnyChat Development
• Internal Testing

Ini memudahkan pemantauan penggunaan dan meminimumkan risiko jika salah satu API Key perlu dibatalkan.

---

💰 Kos & Penggunaan

OpenAI API bukan percuma secara berterusan.

Kos penggunaan bergantung kepada beberapa faktor:

• Model AI yang dipilih (contohnya GPT-4.1, GPT-4o, GPT-4o mini atau model lain yang tersedia).
• Bilangan mesej yang diproses.
• Panjang arahan (Instructions) yang dihantar.
• Panjang jawapan yang dijana.

Semakin banyak pelanggan menggunakan AI, semakin tinggi penggunaan token dan kos API.

Cadangan ResellerMY:

• Gunakan model yang sesuai dengan keperluan sebenar.
• Elakkan arahan (Instructions) yang terlalu panjang jika tidak diperlukan.
• Pantau penggunaan API secara berkala melalui dashboard OpenAI.
• Tetapkan bajet bulanan untuk mengelakkan penggunaan yang tidak dijangka.

---

💡 Tip ResellerMY

Cipta API Key yang berasingan untuk Production dan Testing.

Dengan cara ini, anda boleh menguji prompt atau konfigurasi baharu tanpa menjejaskan operasi sebenar atau menyukarkan pemantauan penggunaan.

---

🌍 Senario Dunia Sebenar

Sebuah syarikat menggunakan satu API Key untuk semua projek.

Apabila berlaku lonjakan penggunaan pada salah satu projek, mereka sukar mengenal pasti puncanya.

Selepas memisahkan API Key mengikut projek, mereka dapat memantau penggunaan dengan lebih mudah dan mengambil tindakan lebih cepat apabila berlaku peningkatan kos.

---

📌 Nota ResellerMY

API Key memberikan akses terus kepada akaun OpenAI anda.

Jika anda mengesyaki API Key telah terdedah, padam (revoke) API Key tersebut dengan segera dan cipta yang baharu.

---

❓ Soalan Lazim

Adakah saya perlu memasukkan maklumat kad pembayaran di OpenAI?

Ya. Kebanyakan penggunaan API memerlukan akaun OpenAI yang mempunyai kaedah pembayaran atau kredit yang aktif.

---

Mengapa API Key saya tidak berfungsi?

Antara sebab yang biasa ialah:

• API Key tidak lengkap.
• API Key telah dipadam.
• Akaun tidak mempunyai kredit atau kaedah pembayaran yang sah.
• Terdapat kesilapan semasa menyalin API Key.

---

Adakah saya boleh menggunakan API Key yang sama untuk beberapa AI Assistant?

Ya. Satu AI Provider boleh digunakan oleh beberapa AI Assistant dalam Workspace yang sama.

---

📑 Ringkasan

• API Key diperlukan untuk menghubungkan AnyChat dengan OpenAI.
• Simpan API Key di tempat yang selamat dan jangan dedahkan kepada orang lain.
• Pantau penggunaan API untuk mengawal kos.
• Gunakan API Key yang berasingan untuk tujuan Production dan Testing.

---

📖 Learning Path

✅ 3.2 – AI Providers

📍 Anda sedang membaca: 3.3 – Mendapatkan OpenAI API Key dan Menghubungkannya ke AnyChat

➡️ Seterusnya: 3.4 – AI Assistants: Mencipta Pembantu AI Pertama Anda