# Provider Sendiri (BYOK)

BYOK (bring your own key) berarti Anda memakai provider AI sendiri, misalnya akun dan API key Anda, alih-alih provider bawaan platform. Atur di menu **Provider**.

## Sebelum mulai

- Punya akun dan API key dari provider AI yang Anda pilih.
- Tahu model yang ingin dipakai dan, untuk provider kustom, **Base URL**-nya.

Bila Anda tidak mengatur provider sendiri, tumbuh.ai memakai provider bawaan yang siap pakai (ditandai **Siap pakai** atau **Official**) dan Anda tidak perlu melakukan apa pun.

## Konsep

Konfigurasi provider dikunci berdasarkan provider dan **Purpose** (kegunaan). Satu provider bisa punya konfigurasi berbeda per purpose, dan hanya satu konfigurasi yang aktif untuk tiap purpose. Purpose yang tersedia: CHAT, CLASSIFICATION, EMBEDDING, GROOT_ASSISTANT, dan TOOL_REASONING.

## Menambah provider

1. Buka **AI Automation** lalu **Provider**.
2. Klik **Tambah provider**.
3. Pilih **Provider key**, atau isi nama provider kustom.
4. Pilih **Purpose**.
5. Isi **Model**. Klik **Ambil model** untuk mengambil daftar model dari provider; bila gagal, daftar saran preset ditampilkan.
6. Isi **Base URL** bila diperlukan dan tempel **API key**.
7. Buka **Pengaturan lanjutan** untuk **Timeout (ms)** atau metadata tambahan bila perlu.
8. Klik **Tes provider** untuk memastikan koneksi berhasil.
9. Klik **Simpan provider**.

![Formulir Tambah provider dengan kolom Provider key, Purpose, Base URL, API key, dan Model](/images/byok-tambah-provider.png)

Sebuah provider bisa disimpan dalam keadaan nonaktif (kolom **Aktif** dimatikan) sampai Anda siap memakainya.

## Mengaktifkan provider

Di daftar provider, klik **Jadikan aktif** pada konfigurasi yang ingin dipakai untuk sebuah purpose. Konfigurasi aktif lain untuk purpose yang sama otomatis dinonaktifkan. **Nonaktifkan** mengembalikan purpose itu ke default platform.

## Mengganti atau menghapus API key

- API key yang tersimpan ditampilkan tersamar. Key hanya diganti bila Anda mengetik nilai baru, dan Anda diminta konfirmasi sebelum menggantinya.
- **Hapus** menghapus konfigurasi beserta API key tersimpan.

## Hasil yang diharapkan

Konfigurasi muncul di daftar dengan status **Aktif**, tes provider berhasil, dan alur kerja memakai model Anda untuk purpose tersebut.

## Tips dan peringatan

- Selalu jalankan **Tes provider** sebelum mengaktifkan.
- Pakai key khusus untuk tumbuh.ai agar mudah dicabut.
- Dengan provider sendiri, biaya pemakaian model ditagih oleh provider Anda.
- Pemakaian kredit tumbuh.ai oleh fitur AI mengikuti penagihan akun Anda dan dijelaskan di halaman pembayaran; jangan berasumsi provider sendiri membebaskan kredit.

## Masalah umum

- **Tes provider gagal.** Periksa API key, Base URL, nama model, dan batas atau saldo di akun provider Anda.
- **Gagal mengambil daftar model.** Isi nama model secara manual.
- **Balasan AI berhenti setelah mengganti provider.** Pastikan konfigurasi untuk purpose CHAT berstatus **Aktif**, lalu uji di [Playground](/ai-automation/playground).
- **AI tidak membalas sama sekali.** Lihat [Alur Kerja](/ai-automation/alur-kerja); auto-reply AI hanya aktif bila paket Anda menyertakannya.
