Le Gemini Live API permet des interactions vocales et vidéo bidirectionnelles en temps réel et à faible latence avec un modèle Gemini.
Le Live API et sa famille spéciale de modèles peuvent traiter des flux continus d'audio, de vidéo ou de texte pour fournir des réponses parlées immédiates et naturelles, créant ainsi une expérience conversationnelle naturelle pour vos utilisateurs.
Cette page explique comment commencer à utiliser la fonctionnalité la plus courante : la diffusion en flux continu de l'entrée et de la sortie audio, mais la Live API est compatible avec de nombreuses fonctionnalités et options de configuration différentes.
L'Live API est une API avec état qui crée une connexion WebSocket pour établir une session entre le client et le Gemini serveur. Pour en savoir plus, consultez la documentation de référence Live API (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)).
Consulter des ressources utiles
Swift : application de démarrage rapide | Android : application de démarrage rapide | Web : application de démarrage rapide | Flutter : application de démarrage rapide | Unity : bientôt disponible
Découvrez l'Gemini Live API dans une application déployée réelle. Consultez l' application Flutter AI Playground accessible via la console Firebase.
Avant de commencer
Si ce n'est pas déjà fait, suivez le
guide de démarrage,
qui explique comment configurer votre projet Firebase,
connecter votre application à Firebase, ajouter le SDK,
initialiser le service de backend pour le fournisseur Gemini API de votre choix et
créer une instance LiveModel.
Vous pouvez créer un prototype avec des prompts et le Live API dans Google AI Studio ou Agent Studio.
Modèles compatibles avec cette fonctionnalité
Modèles 3.x
Gemini Developer API
gemini-3.1-flash-live-preview
Bien qu'il s'agisse d'un modèle en version preview, il est disponible dans le niveau sans frais de l'API Gemini Developer API.
Agent Platform Gemini API (formerly Vertex AI)
Aucune compatibilité avec les modèles Gemini Live 3.x
Modèles 2.5
Bien que le modèle ait des noms différents selon le Gemini fournisseur d'API, ses fonctionnalités sont identiques.
Gemini Developer API
gemini-2.5-flash-native-audio-preview-12-2025gemini-2.5-flash-native-audio-preview-09-2025
Bien qu'il s'agisse de modèles en version preview, ils sont disponibles dans le niveau sans frais de l'Gemini Developer API.
Agent Platform Gemini API (formerly Vertex AI)
gemini-live-2.5-flash-native-audio(publié en décembre 2025)gemini-live-2.5-flash-preview-native-audio-09-2025
Lorsque vous utilisez les Agent Platform Gemini API (formerly Vertex AI), les modèles Live API ne sont pas compatibles avec la région
global.
Diffuser en flux continu l'entrée et la sortie audio
|
Cliquez sur votre fournisseur Gemini API pour afficher le contenu spécifique au fournisseur et le code sur cette page. |
L'exemple suivant montre l'implémentation de base pour envoyer une entrée audio diffusée en flux continu et recevoir une sortie audio diffusée en flux continu.
Pour obtenir des options et des fonctionnalités supplémentaires pour le Live API, consultez la section "Que pouvez-vous faire d'autre ?" plus loin sur cette page.
Swift
Pour utiliser le Live API, créez une
LiveModel
instance et définissez la
modalité de réponse
sur 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-2.5-flash-native-audio-preview-12-2025",
// 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
Pour utiliser le Live API, créez une
LiveModel
instance et définissez la
modalité de réponse
sur 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-2.5-flash-native-audio-preview-12-2025",
// 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
Pour utiliser le Live API, créez une
LiveModel
instance et définissez la
modalité de réponse
sur 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-2.5-flash-native-audio-preview-12-2025",
// 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
Pour utiliser le Live API, créez une
LiveGenerativeModel
instance et définissez la
modalité de réponse
sur 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-2.5-flash-native-audio-preview-12-2025",
// 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
Pour utiliser le Live API, créez une
LiveGenerativeModel instance
et définissez la
modalité de réponse
sur 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 LiveModelSession _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-2.5-flash-native-audio-preview-12-2025',
// 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 _session.startMediaStream(mediaChunkStream);
// In a separate thread, receive the audio response from the model.
await for (final message in _session.receive()) {
// Process the received message.
}
Unity
Pour utiliser le Live API, créez une
LiveModel
instance et définissez la
modalité de réponse
sur 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-2.5-flash-native-audio-preview-12-2025",
// 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 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.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++;
}
}
Tarifs et comptage des jetons
Vous trouverez des informations sur les tarifs des modèles Live API dans la documentation du fournisseur Gemini API de votre choix : Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI).
Quel que soit votre Gemini API fournisseur, l'Live API n'est pas compatible avec l'API Count Tokens.
Que pouvez-vous faire d'autre ?
Découvrez la suite complète de fonctionnalités pour l'Live API, comme la diffusion en flux continu de différentes modalités d'entrée (audio, texte ou vidéo + audio).
Personnalisez votre implémentation à l'aide de différentes options de configuration, comme l'ajout d'une transcription ou la définition de la voix de la réponse.
Découvrez comment gérer les sessions, y compris mettre à jour le contenu en cours de session, compresser la fenêtre de contexte, détecter quand une session est sur le point de se terminer et reprendre une session.
Améliorez votre implémentation en donnant au modèle accès à des outils, tels que l'appel de fonction et l'ancrage avec
Google Search . La documentation officielle sur l'utilisation des outils avec le Live API sera bientôt disponible.Découvrez les limites et les spécifications, d'utilisation de la Live API, telles que la durée de la session, les limites de débit, les langues compatibles, etc.