# Cara mendapatkan kunci API OpenAI anda

*Gunakan panduan ini apabila Mampu AI meminta kunci API OpenAI dalam **Settings > Integrations > AI Providers**. Kunci yang sama ini juga mungkin dipanggil kunci rahsia OpenAI, kunci API projek, kunci platform, atau token API.*

## Tonton tutorial

{% embed url="https://youtu.be/pSJDuCkgsIM" %}

Selepas anda mencipta kunci dalam OpenAI Platform, tambahkannya pada kad **OpenAI** di halaman **AI Providers** (**Settings > Integrations > AI Providers**).

## Sebelum anda mula

* Gunakan akaun OpenAI Platform yang anda kawal sendiri.
* Pastikan anda berada dalam organisasi dan projek OpenAI yang betul.
* Jika OpenAI meminta anda menambah kredit, pilih satu pelan dan tambah kaedah pembayaran sebelum menggunakan kunci tersebut.
* Rahsiakan kunci ini. Sesiapa yang memiliki kunci ini boleh membuat permintaan API bagi pihak anda.

## Mencipta kunci semasa onboarding OpenAI Platform

**1.** Pergi ke [platform.openai.com/login](https://platform.openai.com/login), masukkan alamat e-mel akaun OpenAI anda, kemudian klik **Continue**. Anda juga boleh teruskan dengan Google, Apple, Microsoft, atau nombor telefon jika ia telah dikonfigurasikan untuk akaun OpenAI anda.

![Skrin log masuk OpenAI Platform](../../.gitbook/assets/guides/93b0fa6b-image1.jpg)

**2.** Buka e-mel pengesahan daripada OpenAI, masukkan kod pada skrin **Check your inbox**, kemudian klik **Continue**.

![Skrin pengesahan e-mel OpenAI](../../.gitbook/assets/guides/d826bc95-image2.jpg)

**3.** Isikan medan profil, termasuk **Full name** dan **Age**, kemudian klik **Finish creating account**.

![Skrin persediaan profil akaun OpenAI](../../.gitbook/assets/guides/92512ce9-image3.jpg)

**4.** Pada **Welcome to OpenAI Platform**, masukkan **Organization name** dan **Project name**, kemudian klik **Continue**. Projek yang anda pilih di sini adalah tempat kunci API akan tergolong.

![Skrin persediaan organisasi dan projek OpenAI](../../.gitbook/assets/guides/4331161f-image4.jpg)

**5.** Pada **Choose your plan**, pilih pelan yang sesuai dengan penggunaan anda. Skrin mungkin memaparkan pilihan seperti **Free**, **Prototype**, atau **Accelerate**. Jika anda memerlukan lebih banyak penggunaan atau akses, pilih pelan berbayar.

![Skrin pemilihan pelan OpenAI](../../.gitbook/assets/guides/9595d7b5-image5.jpg)

**6.** Jika OpenAI meminta pembayaran, tambah kaedah pembayaran dan teruskan. Jangan masukkan butiran kad kecuali anda mempercayai akaun dan projek yang sedang anda sediakan.

![Skrin tambah kaedah pembayaran OpenAI](../../.gitbook/assets/guides/60e5938f-image6.jpg)

**7.** Pada **Make your first API call**, masukkan **API key name** yang jelas seperti `Mampu AI OpenAI`, kemudian klik **Generate API Key**.

![Skrin penjanaan kunci API pertama OpenAI](../../.gitbook/assets/guides/415a23c9-image7.jpg)

**8.** Apabila kunci telah dijana, klik **Copy** dan simpan dalam pengurus kata laluan yang selamat. OpenAI hanya memaparkan kunci rahsia penuh sekali sahaja. Jika anda kehilangannya, cipta kunci baharu dan gantikan nilai lama dalam Mampu AI.

![Skrin kunci API yang dijana oleh OpenAI](../../.gitbook/assets/guides/e062b8f5-image8.jpg)

## Mencipta kunci daripada akaun OpenAI Platform sedia ada

**1.** Buka [platform.openai.com/home](https://platform.openai.com/home) dan sahkan projek yang betul dipilih pada bar sisi kiri. Jika baki kredit anda ialah `0.00`, tambah kredit sebelum menggunakan kunci tersebut dalam produksi.

![Skrin utama OpenAI Platform](../../.gitbook/assets/guides/28dc1e68-image9.jpg)

**2.** Pada bar sisi kiri, klik **API Keys**. Ini akan membuka halaman **API keys**, di mana anda boleh melihat kunci sedia ada dan mencipta satu yang baharu.

![Halaman API keys OpenAI](../../.gitbook/assets/guides/813bb9a6-image10.jpg)

**3.** Klik **Create new secret key**.

![Butang cipta kunci rahsia baharu OpenAI](../../.gitbook/assets/guides/2641c975-image11.jpg)

**4.** Dalam modal **Create new secret key**, masukkan nama seperti `Mampu AI OpenAI`, pilih **Project** yang betul, kemudian klik **Create secret key**.

![Modal cipta kunci rahsia baharu OpenAI](../../.gitbook/assets/guides/a33991f9-image12.jpg)

**5.** Pada **Save your key**, klik **Copy** dan simpan kunci tersebut dengan selamat. Klik **Done** hanya selepas anda menyimpannya.

## Tambah kunci ke Mampu AI

**1.** Dalam Mampu AI, pergi ke **Settings > Integrations > AI Providers**.
**2.** Cari kad **OpenAI** di bawah **FAQ, knowledge & media processing**.
**3.** Tampal kunci yang disalin dan sambungkan.
**4.** Kad akan memaparkan **Connected** apabila kunci diterima.

Kunci OpenAI menggerakkan AI Knowledge (penjanaan dan carian FAQ), transkripsi nota suara, pemahaman imej, dan terjemahan artikel.

## Penyelesaian masalah

* Jika integrasi OpenAI gagal, sahkan bahawa nilai yang disalin ialah kunci rahsia penuh dan bukan sekadar ID penjejakan.
* Jika balasan AI, ringkasan, pembetulan tatabahasa, label, atau ciri Copilot gagal selepas persediaan, semak sama ada projek OpenAI mempunyai kredit dan kunci masih aktif.
* Jika kunci terdedah atau dikongsi secara tidak sengaja, padamkannya daripada halaman **API Keys** OpenAI dan cipta kunci rahsia baharu.
* Jika anda menggunakan beberapa projek OpenAI, cipta kunci di dalam projek yang sepatutnya menanggung kos penggunaan Mampu AI.

---
Source: https://help.mampuai.com/ms/mampu-ai/settings/how-to-get-your-openai-api-key