Integrasi API AI ke Flutter: Aplikasi Mobile dengan AI
Oleh Darus S Alfatah · 2025-09-16 · Tutorial · 8 menit
Catatan penulis: Kami menyimpan kunci di backend, bukan di aplikasi Flutter, agar tidak bisa dibongkar dari paket.
Pendahuluan: Flutter dan AI
Flutter adalah framework Google untuk membangun aplikasi Android dan iOS dari satu codebase. Menggabungkan Flutter dengan API AI memungkinkan Anda membuat aplikasi mobile pintar — chatbot, asisten belajar, atau aplikasi translate — dengan cepat. Artikel ini memandu integrasi dasar Flutter + All in One API Key BankAI.
Langkah 1: Tambah Dependency
flutter pub add http
Langkah 2: Buat Service AI
import 'dart:convert';
import 'package:http/http.dart' as http;
class AiService {
final String apiKey = 'sk-bankai-xxxx';
Future chat(String prompt) async {
final response = await http.post(
Uri.parse('https://bankai.web.id/api/chat/completions'),
headers: {
'Content-Type': 'application/json',
'Authorization': 'Bearer $apiKey',
},
body: jsonEncode({
'model': 'auto',
'messages': [
{'role': 'user', 'content': prompt}
],
}),
);
final data = jsonDecode(response.body);
return data['choices'][0]['message']['content'];
}
}
Langkah 3: Buat UI Sederhana
import 'package:flutter/material.dart';
class ChatPage extends StatefulWidget {
@override
_ChatPageState createState() => _ChatPageState();
}
class _ChatPageState extends State {
final _ai = AiService();
final _controller = TextEditingController();
String _reply = '';
Future _send() async {
final reply = await _ai.chat(_controller.text);
setState(() => _reply = reply);
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text('AI Chat')),
body: Column(children: [
Expanded(child: Text(_reply)),
Row(children: [
Expanded(child: TextField(controller: _controller)),
IconButton(onPressed: _send, icon: Icon(Icons.send)),
]),
]),
);
}
}
Penting: Keamanan API Key
Jangan hardcode API key di aplikasi mobile — pengguna bisa mengekstraknya. Solusinya: taruh API key di backend Anda sendiri, lalu aplikasi Flutter memanggil backend tersebut. Backend-lah yang memanggil BankAI.
Bangun aplikasi mobile AI Anda dengan All in One API Key BankAI — murah, QRIS, dan unlimited selama token masih ada!
Menyimpan Kunci dengan Aman
Jangan pernah menanam API key di kode aplikasi Flutter. APK dapat dibongkar, dan string di dalamnya mudah dibaca. Solusi yang benar: aplikasi memanggil backend Anda (atau gateway yang mendukung kunci per pengguna), dan kunci rahasia tetap di server. Untuk aplikasi internal, kredensial bisa disimpan di secure storage dan tetap dibatasi cakupannya.
Menangani Streaming di Flutter
Untuk pengalaman chat yang halus, gunakan paket HTTP yang mendukung respons bertahap, lalu tambahkan potongan teks ke state saat diterima. Pastikan widget di-scroll otomatis dan tombol berhenti tersedia. Uji pada koneksi lambat karena perbedaan perilaku streaming sering muncul di sana.
Tampilan Status yang Jelas
Gunakan status bertingkat: mengirim, menunggu model, menerima jawaban, selesai, gagal. Sertakan tombol coba lagi pada kegagalan dan jangan biarkan pengguna mengirim pesan baru sementara proses berjalan, agar riwayat tidak kacau.
Biaya dan Kuota
Tampilkan sisa kuota pengguna di dalam aplikasi agar tidak ada kejutan. Untuk aplikasi gratis, terapkan batas harian di server — bukan di aplikasi — karena batas di sisi klien mudah dilewati.
Desain Antarmuka Chat yang Nyaman
Antarmuka chat yang baik memberi umpan balik jelas di setiap tahap. Tampilkan indikator saat menunggu, animasi halus saat teks muncul, dan tombol berhenti ketika jawaban sedang berjalan. Untuk jawaban panjang, gunakan pemisah paragraf yang rapi dan dukung pemilihan teks agar pengguna bisa menyalin bagian tertentu.
Perhatikan juga aksesibilitas: ukuran teks yang bisa diperbesar, kontras memadai, dan dukungan pembaca layar. Aplikasi yang memakai AI untuk pengguna luas sebaiknya bisa dipakai tanpa bergantung pada warna atau gestur rumit.
Mode Luring dan Sinkronisasi
Karena jaringan seluler tidak selalu stabil, simpan percakapan secara lokal dan kirim ulang ketika koneksi pulih. Beri tanda jelas pada pesan yang belum terkirim, dan jangan menghapus riwayat ketika aplikasi ditutup. Fitur kecil ini sangat terasa di daerah dengan koneksi terputus-putus.
Untuk menghemat kuota pengguna, cache jawaban atas pertanyaan umum dan tampilkan tanpa memanggil API bila memungkinkan.
Contoh Layanan Klien
class AiService {
final http.Client _c = http.Client();
Future<String> ask(String pesan) async {
final r = await _c.post(
Uri.parse('https://bankai.web.id/api/v1/chat/completions'),
headers: {'Content-Type': 'application/json'},
body: jsonEncode({
'model': 'auto',
'messages': [{'role': 'user', 'content': pesan}],
'max_tokens': 600,
}),
);
if (r.statusCode != 200) throw Exception('gagal ' + r.statusCode);
return jsonDecode(r.body)['choices'][0]['message']['content'] as String;
}
}
Menyimpan Riwayat Lokal
Gunakan penyimpanan lokal untuk riwayat, lalu kirim hanya delapan pesan terakhir. Ini menjaga biaya dan tetap memberi konteks yang cukup.
Menangani Koneksi Buruk
Tampilkan status jelas ketika permintaan gagal, dan sediakan tombol coba lagi. Hindari menampilkan pesan error teknis ke pengguna akhir.
Contoh backend perantara: Aplikasi Flutter mengirim pesan ke API Anda, API memegang kunci dan memanggil gateway, lalu mengembalikan jawaban. Kunci tidak pernah ada di perangkat.
Pertanyaan yang Sering Diajukan
Apakah tutorial ini bisa diikuti pemula?
Ya. Langkah-langkahnya dijelaskan berurutan dan menyertakan contoh kode, jadi bisa diikuti pemula maupun developer berpengalaman.
Apakah endpoint BankAI kompatibel dengan library yang sudah saya pakai?
Ya, BankAI 100% kompatibel dengan standar OpenAI, sehingga library seperti OpenAI SDK, LangChain, dan tools sejenis bisa dipakai tanpa mengubah kode selain Base URL dan API key.
Di mana saya mendapatkan API key untuk mengikuti tutorial ini?
API key (dan Secret Token) didapat setelah daftar dan menyelesaikan pembayaran di dashboard BankAI.