Memakai API Key Sendiri

Dengan API key milik Anda sendiri, agent Anda menjangkau model di akun provider Anda sendiri (OpenAI, Azure OpenAI, Azure AI Inference, atau DeepSeek) sebagai ganti model Qlar. Provider menagih Anda langsung, dan tidak ada credit Qlar yang ditagih untuk token model tersebut.

Setiap key yang Anda tambahkan adalah satu model: sebuah alias yang dipilih tim Anda dari daftar model, provider dan model yang dijangkaunya, serta key untuk menjangkaunya.

Siapa yang bisa melakukannya? Owner dan Admin, di organization yang diizinkan Qlar membawa model AI sendiri. Bila tab Sources atau tombol Add API key tidak muncul, minta support Qlar menyalakannya untuk organization Anda.

Sebelum mulai

• Akun di provider yang didukung beserta API key-nya:
  • OpenAI: nama model, misalnya gpt-4o-mini.
  • Azure OpenAI: endpoint dan nama deployment.
  • Azure AI Inference: endpoint, dan opsional endpoint Response API.
  • DeepSeek: nama model; endpoint default-nya https://api.deepseek.com.
• Apa yang diterima dan dihasilkan model (gambar, audio, dokumen, …), dari dokumentasi provider itu sendiri. Qlar tidak bisa mendeteksinya.
• Role Owner atau Admin di organization.

Ingin memakai paket Claude atau ChatGPT Anda, dengan key yang tidak pernah keluar dari komputer Anda sendiri? Lihat Menghubungkan Gateway.

Menambahkan key

Buka halaman Organization → Configure pada organization Anda → tile AI Models → tab Sources → Add API key (atau Add API key di grup Your API keys pada tab Models).

1. Alias: nama yang dilihat tim Anda di daftar model, misalnya my-gpt-4o. Harus unik dan tidak boleh sama dengan nama model Qlar. Tidak bisa diubah nanti.
2. Provider: OpenAI, Azure OpenAI, Azure AI Inference, atau DeepSeek.
3. Invocation method: Chat Completion atau Response API. DeepSeek hanya mendukung Chat Completion.
4. Native model name (misalnya gpt-4o-mini) atau, untuk Azure, Deployment name, ditambah Endpoint untuk provider Azure.
5. API key: ditempel sekali. Key disimpan terenkripsi; setelah itu hanya sebagian yang disamarkan yang ditampilkan.
6. Opsional Short description dan Estimated credit ratio (biarkan 0 bila tidak diketahui).
7. Capabilities: nyalakan apa yang diterima model (Image, Audio, Video, Document) dan yang dihasilkannya (Image, Audio, Video). Bila Document menyala, pilih minimal satu jenis dokumen.
8. Klik Create.

Model tampil di Models dalam grup Your API keys, dalam keadaan menyala.

Memakainya

• Di sebuah agent: sebagai model percakapan, di Allowed Conversation AI Models, atau sebagai Answering AI model untuk panggilan voice Natural conversation. Daftar model menampilkannya di bawah API key.
• Sebagai default fitur: di tab Defaults, pilih untuk Conversation, Summarization, Personalization, Reranker, KB Training, atau Conversation Analysis.
• Billing: tidak ada credit Qlar untuk token model; provider Anda yang menagih. Tool yang dipakai jawabannya, seperti web search, knowledge base, dan plugin, tetap ditagih seperti biasa.

Mengubah atau menghapus key

Troubleshooting

Halaman Terkait

• AI Models (organization)
• Menghubungkan Gateway
• Referensi layar AI Models
• Model & Context