Integrasi API AI ke Flutter: Aplikasi Mobile dengan AI

Oleh Darus S Alfatah · 2025-09-16 · Tutorial · 8 menit

Integrasi API AI ke Flutter: Aplikasi Mobile dengan AI

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.

Sumber & Referensi

Tentang penulis

Darus S Alfatah — Founder & Penulis

Darus S Alfatah adalah pendiri BankAI. Ia membangun dan mengoperasikan gateway API LLM yang melayani developer Indonesia, dan menulis tentang integrasi LLM, arsitektur gateway, serta cara memakai AI secara praktis dan hemat biaya. Setiap panduan diuji di lingkungan nyata — termasuk kode, konfigurasi, dan perhitungan token — sebelum diterbitkan, dan diperbarui ketika dokumentasi penyedia atau harga berubah.

Kebijakan editorial

Artikel terkait

🚀 Siap Pakai All in One API Key?

Daftar sekarang, top-up pakai QRIS, dan langsung ngoding pake ChatGPT, Claude, DeepSeek & semua AI dalam satu API Key!

🔑 DAFTAR SEKARANG · Harga