Gemini Live API מאפשר אינטראקציות קוליות ווידאו בזמן אמת עם השהיה נמוכה עם מודל Gemini שהוא דו-כיווני.
Live API ומשפחת המודלים המיוחדת שלו יכולים לעבד סטרימינג רציף של אודיו, וידאו או טקסט כדי לספק תשובות מיידיות בדיבור שנשמע טבעי, וכך ליצור חוויה טבעית של שיחה עם המשתמשים.
בדף הזה מוסבר איך להתחיל להשתמש ביכולת הנפוצה ביותר – סטרימינג של קלט ופלט אודיו, אבל Live API תומך בהרבה יכולות שונות ואפשרויות הגדרה.
Live API הוא API עם שמירת מצב שיוצר חיבור WebSocket כדי ליצור סשן בין הלקוח לבין שרת Gemini. פרטים נוספים זמינים במאמרי העזרה בנושא Live API (Gemini Developer API | Vertex AI Gemini API).
מקורות מידע שימושיים
Swift – בקרוב! | Android – אפליקציית התחלה מהירה | אינטרנט – אפליקציית התחלה מהירה | Flutter – אפליקציית התחלה מהירה | Unity – בקרוב!
כדי לנסות את Gemini Live API באפליקציה אמיתית שפועלת, אפשר להיכנס לאפליקציית Flutter AI Playground דרך מסוף Firebase
לפני שמתחילים
אם עדיין לא עשיתם את זה, כדאי לעיין במדריך לתחילת העבודה. במדריך הזה מוסבר איך להגדיר את פרויקט Firebase, לקשר את האפליקציה ל-Firebase, להוסיף את ה-SDK, לאתחל את שירות ה-Backend עבור ספק Gemini API שבחרתם וליצור מופע LiveModel.
אפשר ליצור אב טיפוס באמצעות הנחיות והדגל Live API ב-Google AI Studio או ב-Vertex AI Studio.
מודלים שתומכים ביכולת הזו
מודלים של Gemini 2.5 Flash Live הם מודלים של אודיו מקורי שתומכים ב-Gemini Live API. למרות שלדגם יש שמות שונים בהתאם לספק ה-API של Gemini, ההתנהגות והתכונות של הדגם זהות.
Gemini Developer API
gemini-2.5-flash-native-audio-preview-12-2025gemini-2.5-flash-native-audio-preview-09-2025
למרות שמדובר במודלים בגרסת טרום-השקה, הם זמינים ב'חבילה ללא תשלום' של Gemini Developer API.
Vertex AI Gemini API
gemini-live-2.5-flash-native-audio(פורסם בדצמבר 2025)gemini-live-2.5-flash-preview-native-audio-09-2025
כשמשתמשים ב-Vertex AI Gemini API, מודלים של Live API לא נתמכים במיקום
global.
הזרמת קלט ופלט אודיו
|
לוחצים על הספק Gemini API כדי לראות בדף הזה תוכן וקוד שספציפיים לספק. |
בדוגמה הבאה מוצגת הטמעה בסיסית של שליחת קלט של אודיו בסטרימינג וקבלת פלט של אודיו בסטרימינג.
אפשרויות ויכולות נוספות של Live API מפורטות בקטע "מה עוד אפשר לעשות?" בהמשך הדף.
Swift
כדי להשתמש ב-Live API, צריך ליצור מופע של LiveModel ולהגדיר את אופן התגובה ל-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 require to send more requests.
if content.isTurnComplete {
await session.close()
}
}
}
} catch {
fatalError(error.localizedDescription)
}
Kotlin
כדי להשתמש ב-Live API, צריך ליצור מופע של LiveModel ולהגדיר את אופן התגובה ל-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
כדי להשתמש ב-Live API, צריך ליצור מופע של LiveModel ולהגדיר את אופן התגובה ל-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
כדי להשתמש ב-Live API, צריך ליצור מופע של LiveGenerativeModel ולהגדיר את אופן התגובה ל-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
כדי להשתמש ב-Live API, צריך ליצור מכונת LiveGenerativeModel ולהגדיר את אופן התגובה ל-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
כדי להשתמש ב-Live API, צריך ליצור מופע של LiveModel ולהגדיר את אופן התגובה ל-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++;
}
}
תמחור וספירת טוקנים
אפשר למצוא מידע על התמחור של מודלים של Live API במסמכי התיעוד של ספק Gemini API שבחרתם: Gemini Developer API | Vertex AI Gemini API.
לא משנה איזה ספק Gemini API יש לכם, Live API לא תומך ב-Count Tokens API.
מה עוד אפשר לעשות?
כדאי לעיין בחבילה המלאה של היכולות של Live API, כמו סטרימינג של מגוון אמצעי קלט (אודיו, טקסט או וידאו + אודיו).
אפשר להתאים אישית את ההטמעה באמצעות מגוון אפשרויות הגדרה, כמו הוספת תמלול או הגדרת הקול של התשובה.
כדי לשפר את ההטמעה, אפשר לתת למודל גישה לכלים כמו קריאה לפונקציות ועיגון באמצעות חיפוש Google. בקרוב נפרסם מסמכים רשמיים בנושא השימוש בכלים עם Live API.
מידע על מגבלות ומפרטים לשימוש ב-Live API, כמו משך הפגישה, מגבלות קצב, שפות נתמכות וכו'.