Gemini Live API memungkinkan interaksi suara dan video real-time berlatensi rendah dengan model Gemini yang bersifat dua arah.
Live API dan rangkaian model khususnya dapat memproses streaming audio, video, atau teks berkelanjutan untuk memberikan respons lisan yang cepat dan mirip manusia, sehingga menciptakan pengalaman percakapan yang alami bagi pengguna Anda.
Halaman ini menjelaskan cara mulai menggunakan kemampuan yang paling umum — input dan output audio streaming, tetapi Live API mendukung berbagai kemampuan dan opsi konfigurasi.
Live API adalah API stateful yang membuat koneksi WebSocket untuk membangun sesi antara klien dan server Gemini. Untuk mengetahui detailnya, lihat dokumentasi referensi Live API (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).
Lihat referensi yang bermanfaat
Swift - aplikasi panduan memulai | Android - aplikasi panduan memulai | Web - aplikasi panduan memulai | Flutter - aplikasi panduan memulai | Unity - segera hadir!
Rasakan pengalaman Gemini Live API dalam aplikasi yang di-deploy secara nyata - lihat aplikasi Flutter AI Playground yang dapat diakses melalui konsol Firebase.
Sebelum memulai
Jika Anda belum melakukannya, selesaikan
panduan memulai,
yang menjelaskan cara menyiapkan project Firebase,
menghubungkan aplikasi ke Firebase, menambahkan SDK,
menginisialisasi layanan backend untuk penyedia Gemini API yang Anda pilih, dan
membuat instance LiveModel.
Anda dapat membuat prototipe dengan perintah dan Live API di Google AI Studio atau Agent Studio.
Model yang mendukung kemampuan ini
Model 3.x
Gemini Developer API
gemini-3.1-flash-live-preview
Meskipun merupakan model pratinjau, model ini tersedia di "paket gratis" Gemini Developer API.
Agent Platform Gemini API (formerly Vertex AI)
Tidak ada dukungan untuk model Gemini Live 3.x
Model 2.5
Meskipun model memiliki nama model yang berbeda bergantung pada penyedia API Gemini, fitur modelnya sama.
Gemini Developer API
gemini-2.5-flash-native-audio-preview-12-2025gemini-2.5-flash-native-audio-preview-09-2025
Meskipun merupakan model pratinjau, model ini tersedia di "paket gratis" Gemini Developer API.
Agent Platform Gemini API (formerly Vertex AI)
gemini-live-2.5-flash-native-audio(dirilis pada Desember 2025)gemini-live-2.5-flash-preview-native-audio-09-2025
Saat menggunakan Agent Platform Gemini API (formerly Vertex AI), model Live API 2.5 tidak tersedia di lokasi
global.
Melakukan streaming input dan output audio
|
Klik penyedia Gemini API untuk melihat konten dan kode khusus penyedia di halaman ini. |
Contoh berikut menunjukkan penerapan dasar untuk mengirim input audio yang di-streaming dan menerima output audio yang di-streaming.
Untuk mengetahui opsi dan kemampuan tambahan untuk Live API, tinjau bagian "Apa lagi yang dapat Anda lakukan?" nanti di halaman ini.
Swift
Untuk menggunakan Live API, buat instance
LiveModel
dan tetapkan
modalitas respons
ke audio.
import FirebaseAILogic
// Initialize the Gemini Developer API backend service.
// Create a `liveModel` instance with a model that supports the Live API.
let liveModel = FirebaseAI.firebaseAI(backend: .googleAI()).liveModel(
modelName: "GEMINI_LIVE_API_MODEL_NAME",
// Configure the model to respond with audio.
generationConfig: LiveGenerationConfig(
responseModalities: [.audio]
)
)
do {
let session = try await liveModel.connect()
// Load the audio file, or tap a microphone.
guard let audioFile = NSDataAsset(name: "audio.pcm") else {
fatalError("Failed to load audio file")
}
// Provide the audio data.
await session.sendAudioRealtime(audioFile.data)
var outputText = ""
for try await message in session.responses {
if case let .content(content) = message.payload {
content.modelTurn?.parts.forEach { part in
if let part = part as? InlineDataPart, part.mimeType.starts(with: "audio/pcm") {
// Handle 16bit pcm audio data at 24khz
playAudio(part.data)
}
}
// Optional: if you don't need to send more requests.
if content.isTurnComplete {
await session.close()
}
}
}
} catch {
fatalError(error.localizedDescription)
}
Kotlin
Untuk menggunakan Live API, buat instance
LiveModel
dan tetapkan
modalitas respons
ke AUDIO.
// Initialize the Gemini Developer API backend service.
// Create a `liveModel` instance with a model that supports the Live API.
val liveModel = Firebase.ai(backend = GenerativeBackend.googleAI()).liveModel(
modelName = "GEMINI_LIVE_API_MODEL_NAME",
// Configure the model to respond with audio.
generationConfig = liveGenerationConfig {
responseModality = ResponseModality.AUDIO
}
)
val session = liveModel.connect()
// This is the recommended approach.
// However, you can create your own recorder and handle the stream.
session.startAudioConversation()
Java
Untuk menggunakan Live API, buat instance
LiveModel
dan tetapkan
modalitas respons
ke AUDIO.
ExecutorService executor = Executors.newFixedThreadPool(1);
// Initialize the Gemini Developer API backend service.
// Create a `liveModel` instance with a model that supports the Live API.
LiveGenerativeModel lm = FirebaseAI.getInstance(GenerativeBackend.googleAI()).liveModel(
"GEMINI_LIVE_API_MODEL_NAME",
// Configure the model to respond with audio.
new LiveGenerationConfig.Builder()
.setResponseModality(ResponseModality.AUDIO)
.build()
);
LiveModelFutures liveModel = LiveModelFutures.from(lm);
ListenableFuture<LiveSession> sessionFuture = liveModel.connect();
Futures.addCallback(sessionFuture, new FutureCallback<LiveSession>() {
@Override
public void onSuccess(LiveSession ses) {
LiveSessionFutures session = LiveSessionFutures.from(ses);
session.startAudioConversation();
}
@Override
public void onFailure(Throwable t) {
// Handle exceptions
}
}, executor);
Web
Untuk menggunakan Live API, buat instance
LiveGenerativeModel
dan tetapkan
modalitas respons
ke AUDIO.
import { initializeApp } from "firebase/app";
import { getAI, getLiveGenerativeModel, GoogleAIBackend, ResponseModality } from "firebase/ai";
// TODO(developer): Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
// ...
};
// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);
// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });
// Create a `LiveGenerativeModel` instance with a model that supports the Live API.
const liveModel = getLiveGenerativeModel(ai, {
model: "GEMINI_LIVE_API_MODEL_NAME",
// Configure the model to respond with audio.
generationConfig: {
responseModalities: [ResponseModality.AUDIO],
},
});
const session = await liveModel.connect();
// Start the audio conversation.
const audioConversationController = await startAudioConversation(session);
// ... Later, to stop the audio conversation
// await audioConversationController.stop()
Dart
Untuk menggunakan Live API, buat
instance LiveGenerativeModel
dan tetapkan
modalitas respons
ke audio.
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
import 'package:your_audio_recorder_package/your_audio_recorder_package.dart';
late LiveSession _session;
final _audioRecorder = YourAudioRecorder();
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// Initialize the Gemini Developer API backend service.
// Create a `liveGenerativeModel` instance with a model that supports the Live API.
final liveModel = FirebaseAI.googleAI().liveGenerativeModel(
model: 'GEMINI_LIVE_API_MODEL_NAME',
// Configure the model to respond with audio.
liveGenerationConfig: LiveGenerationConfig(
responseModalities: [ResponseModalities.audio],
),
);
_session = await liveModel.connect();
final audioRecordStream = _audioRecorder.startRecordingStream();
// Map the Uint8List stream to InlineDataPart stream.
final mediaChunkStream = audioRecordStream.map((data) {
return InlineDataPart('audio/pcm', data);
});
await for (final chunk in mediaChunkStream) {
await _session.sendAudioRealtime(chunk);
}
// In a separate thread, receive the audio response from the model.
await for (final message in _session.receive()) {
// Process the received message.
}
Unity
Untuk menggunakan Live API, buat instance
LiveModel
dan tetapkan
modalitas respons
ke Audio.
using Firebase;
using Firebase.AI;
async Task SendTextReceiveAudio() {
// Initialize the Gemini Developer API backend service.
// Create a `LiveModel` instance with a model that supports the Live API.
var liveModel = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI()).GetLiveModel(
modelName: "GEMINI_LIVE_API_MODEL_NAME",
// Configure the model to respond with audio.
liveGenerationConfig: new LiveGenerationConfig(
responseModalities: new[] { ResponseModality.Audio })
);
LiveSession session = await liveModel.ConnectAsync();
// Start a coroutine to send audio from the Microphone.
var recordingCoroutine = StartCoroutine(SendAudio(session));
// Start receiving the response.
await ReceiveAudio(session);
}
IEnumerator SendAudio(LiveSession liveSession) {
string microphoneDeviceName = null;
int recordingFrequency = 16000;
int recordingBufferSeconds = 2;
var recordingClip = Microphone.Start(microphoneDeviceName, true,
recordingBufferSeconds, recordingFrequency);
int lastSamplePosition = 0;
while (true) {
if (!Microphone.IsRecording(microphoneDeviceName)) {
yield break;
}
int currentSamplePosition = Microphone.GetPosition(microphoneDeviceName);
if (currentSamplePosition != lastSamplePosition) {
// The Microphone uses a circular buffer, so we need to check if the
// current position wrapped around to the beginning, and handle it accordingly.
int sampleCount;
if (currentSamplePosition > lastSamplePosition) {
sampleCount = currentSamplePosition - lastSamplePosition;
} else {
sampleCount = recordingClip.samples - lastSamplePosition + currentSamplePosition;
}
if (sampleCount > 0) {
// Get the audio chunk.
float[] samples = new float[sampleCount];
recordingClip.GetData(samples, lastSamplePosition);
// Send the data, discarding the resulting Task to avoid the warning.
_ = liveSession.SendAudioAsync(samples);
lastSamplePosition = currentSamplePosition;
}
}
// Wait for a short delay before reading the next sample from the Microphone.
const float MicrophoneReadDelay = 0.5f;
yield return new WaitForSeconds(MicrophoneReadDelay);
}
}
Queue<float> audioBuffer = new();
async Task ReceiveAudio(LiveSession liveSession) {
int sampleRate = 24000;
int channelCount = 1;
// Create a looping AudioClip to fill with the received audio data.
int bufferSamples = (int)(sampleRate * channelCount);
AudioClip clip = AudioClip.Create("StreamingPCM", bufferSamples, channelCount,
sampleRate, true, OnAudioRead);
// Attach the clip to an AudioSource and start playing it.
AudioSource audioSource = GetComponent<AudioSource>();
audioSource.clip = clip;
audioSource.loop = true;
audioSource.Play();
// Start receiving the response.
await foreach (var message in liveSession.ReceiveAsync()) {
// Process the received message
foreach (float[] pcmData in message.AudioAsFloat) {
lock (audioBuffer) {
foreach (float sample in pcmData) {
audioBuffer.Enqueue(sample);
}
}
}
}
}
// This method is called by the AudioClip to load audio data.
private void OnAudioRead(float[] data) {
int samplesToProvide = data.Length;
int samplesProvided = 0;
lock(audioBuffer) {
while (samplesProvided < samplesToProvide && audioBuffer.Count > 0) {
data[samplesProvided] = audioBuffer.Dequeue();
samplesProvided++;
}
}
while (samplesProvided < samplesToProvide) {
data[samplesProvided] = 0.0f;
samplesProvided++;
}
}
Harga dan penghitungan token
Anda dapat menemukan informasi harga untuk model Live API dalam dokumentasi untuk penyedia Gemini API yang Anda pilih: Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI).
Terlepas dari penyedia Gemini API Anda, Live API tidak mendukung Count Tokens API.
Kamu bisa apa lagi?
Lihat rangkaian lengkap kemampuan untuk Live API, seperti streaming berbagai modalitas input (audio, teks, atau video + audio).
Sesuaikan penerapan Anda menggunakan berbagai opsi konfigurasi, seperti menambahkan transkripsi atau menyetel suara respons.
Pelajari cara mengelola sesi, termasuk memperbarui konten di tengah sesi, mengompresi jendela konteks, mendeteksi kapan sesi akan berakhir, dan melanjutkan sesi.
Tingkatkan implementasi Anda dengan memberi model akses ke alat, seperti panggilan fungsi dan Grounding dengan
Google Search . Dokumentasi resmi untuk menggunakan alat dengan Live API akan segera hadir.Pelajari batas dan spesifikasi, untuk menggunakan Live API, seperti durasi sesi, pembatasan kapasitas, bahasa yang didukung, dll.