Mengisi Pengaturan API

Terakhir dicek: 15 September 2026.

Fitur AI seperti AI Chat, AI Blogger, Storyboard, dan Auto Shorts butuh model bahasa. Modelnya bisa dari layanan cloud (pakai kunci API) atau dari server lokal seperti LM Studio dan Ollama. Semua itu diatur di satu tempat: tab 🔑 API.

Letak tab-nya

Buka menu Pengaturan, lalu pilih sub-tab 🔑 API. Di menu yang sama ada juga ⚡ Performa, ✍ AI Blogger, dan 🔧 Developer.

Isi tab API terbagi dua kolom:

• Kiri: kartu Jalur API Teks dan Jalur API Vision.
• Kanan: kartu Preset Endpoint dan tombol Simpan Semua Pengaturan API.

Dua jalur: Teks dan Vision

Aplikasi memakai dua jalur API terpisah, jadi keduanya bisa diarahkan ke penyedia yang berbeda.

Jalur	Dipakai untuk (menurut keterangan di tab)
Teks	AI Blogger, Storyboard, Naskah Template, AI Chat
Vision	Highlight Video, Auto Shorts, analisis gambar

Masing-masing jalur punya tiga kolom:

• Base URL: alamat penyedia.
• API Key: kunci dari penyedia. Boleh kosong untuk penyedia lokal.
• Nama Model: bisa diketik atau dipilih dari daftar, lewat tombol Ambil daftar model.

Bawaannya: jalur Teks mengarah ke sebuah gateway cloud, dan jalur Vision ke LM Studio lokal di http://127.0.0.1:1234/v1. Keduanya bisa diganti lewat preset di bawah.

Preset Endpoint

Base URL tiap penyedia berbeda tipis, misalnya ada yang pakai /v1 dan ada yang tidak. Salah satu huruf saja bisa menghasilkan error 401 yang membingungkan. Karena itu, pakai tombol preset daripada mengetik alamat sendiri. Ada dua deret tombol, satu untuk Teks dan satu untuk Vision.

Preset	Base URL dan model bawaan
LM Studio	http://127.0.0.1:1234/v1 model: qwen3.8 27B
Ollama	http://127.0.0.1:11434/v1 model: qwen3 coder next 80B
Gemini	https://generativelanguage.googleapis.com/v1beta model: gemini-3.1-flash
Gemini +Alat	https://generativelanguage.googleapis.com/v1beta/openai/ model: gemini-3.1-flash

Di aplikasi ada satu tombol preset lagi untuk gateway cloud. Yang itu tidak dibahas di panduan ini.

Kunci diingat per penyedia

Setiap penyedia punya kunci sendiri, dan aplikasi mengingatnya berdasarkan alamat dan port. Jadi bolak-balik antarpenyedia tidak menghapus kunci yang sudah pernah disimpan. Yang terjadi saat preset diklik:

1. Kunci yang sedang tampil diingat dulu untuk penyedia lama.
2. Base URL dan nama model diganti sesuai preset.
3. Kolom kunci diisi:
   • dengan kunci yang pernah disimpan untuk penyedia itu, kalau ada;
   • dengan penanda lm-studio untuk penyedia lokal, karena pustaka yang dipakai menolak kunci kosong;
   • atau sengaja dikosongkan, kalau penyedia barunya belum pernah punya kunci. Ini supaya kunci penyedia lama tidak terkirim ke penyedia lain.

Gemini atau Gemini +Alat?

Google punya dua alamat, dan bedanya menentukan apa yang bisa dilakukan AI:

Preset	Bisa mengobrol	Bisa mengubah timeline
Gemini	Ya	Tidak
Gemini +Alat	Ya	Ya

Untuk memerintah AI Chat mengedit timeline, misalnya memotong atau memindahkan klip, pilih Gemini +Alat.

Langkah mengisi

1. Buka Pengaturan → 🔑 API.
2. Di kartu Preset Endpoint, klik preset yang diinginkan pada deret Teks, lalu pada deret Vision.
3. Isi API Key untuk penyedia cloud. Untuk LM Studio dan Ollama, biarkan apa adanya.
4. Klik Ambil daftar model, lalu pilih model dari daftar. Ini sekaligus menguji apakah alamat dan kuncinya benar.
5. Klik Simpan Semua Pengaturan API.

Setelah disimpan, muncul kotak konfirmasi berisi jalur teks, endpoint, dan model yang dipakai. Periksa baris jalur teksnya:

Base URL	Jalur teks yang ditentukan otomatis
Alamat Google tanpa /openai	Google Gemini
Kosong, atau alamat api.openai.com	OpenAI
Alamat lain (LM Studio, Ollama, Gemini +Alat)	Custom API (Global)

Di mana pengaturannya disimpan

%APPDATA%\Idris Back Media\api_settings.json

Kunci disimpan apa adanya di file JSON itu, tidak dienkripsi. Jangan salin atau kirim file ini ke siapa pun.

Kalau gagal

"Gagal mengambil daftar model dari API!" dengan status 401

Kuncinya ditolak. Untuk preset Gemini, penyebabnya hampir selalu jenis kunci, bukan nilainya. Aplikasi sendiri menyarankan:

Pastikan kuncinya kunci Google AI Studio (diawali "AIza"), bukan kunci OpenAI atau OAuth.

Untuk penyedia lain, pastikan kuncinya memang milik penyedia yang alamatnya sedang diisi.

Status 404

Base URL mungkin kurang atau kelebihan bagian akhir (mis. /v1 atau /v1beta).

"Gagal terhubung ke API Server!"

Aplikasi tidak mendapat jawaban sama sekali. Untuk LM Studio atau Ollama, biasanya servernya belum dinyalakan (lihat panduan P2). Untuk layanan cloud, periksa koneksi internet.

"API menjawab, tapi tidak ada satu pun model yang bisa dipakai di daftarnya."

Alamat dan kuncinya benar, tapi daftar modelnya kosong. Untuk LM Studio, pastikan sudah ada model yang dimuat.

AI Chat gagal dengan status 503 atau 429

Kedua status ini berasal dari server penyedia, bukan dari aplikasi. Aplikasi otomatis mencoba ulang dua kali:

Status	Arti	Jeda coba ulang
503 (dan 500, 502, 504)	Penyedia sedang penuh	1,5 detik, lalu 4 detik
429	Kuota per menit terlampaui	12 detik, lalu 30 detik

Kalau setelah itu masih gagal, tunggu sebentar sebelum bertanya lagi. Status seperti 401 atau 400 tidak dicoba ulang, karena hasilnya tidak akan berubah.

AI Chat crash "index out of range" setelah alat berjalan

Sekarang aplikasi mencoba ulang sekali setelah 2 detik. Kalau masih gagal, yang muncul bukan lagi crash tanpa keterangan, tapi pesan yang menyebut nama model dan penyedianya, diawali:

Model '...' lewat provider '...' mengembalikan balasan dengan isi kosong, ...

Ringkasan

Letak        : Pengaturan -> API
Dua jalur    : Teks (AI Chat, Blogger, Storyboard) dan Vision (Highlight, Shorts)
Isi dengan   : preset -> API Key -> Ambil daftar model -> Simpan
Kunci        : diingat per penyedia (alamat + port)
Edit timeline: pakai "Gemini +Alat", bukan "Gemini"
Disimpan di  : %APPDATA%\Idris Back Media\api_settings.json (tanpa enkripsi)