
Conversation vocale à faible latence sur un seul socket, avec 30 voix, entrée vidéo en direct, appels d’outils et réponses que vous pouvez interrompre en parlant.
Conversation vocale à faible latence sur un seul socket, avec 30 voix, entrée vidéo en direct, appels d’outils et réponses que vous pouvez interrompre en parlant.
La session est configurée avec les événements session.update via le socket plutôt que les paramètres de requête. Les jetons texte et audio facturent à des débits séparés.
Aussi connu sous le nom Gemini Live, Google Gemini 3.8 Live
gemini-3-8-live/v1/realtimegemini-3.8-livegoogle/gemini-3.8-liveTarifs à l'usage en direct du catalogue EmpirioLabs. Vous ne payez que ce que vous utilisez, sans minimum mensuel.
Gemini 3.8 Live tient une conversation en direct via un WebSocket sur wss://api.empiriolabs.ai/v1/realtime?model=gemini-3-8-live, et non via les endpoints HTTP. Connectez-vous avec l'id de modèle gemini-3-8-live et envoyez votre clé API EmpirioLabs dans un en-tête Authorization: Bearer lors du handshake. L'audio circule dans les deux sens en PCM 16 bits encodé en base64. Un navigateur ne peut pas définir d'en-têtes sur un WebSocket : ouvrez donc cette connexion depuis votre serveur et relayez l'audio vers le navigateur via votre propre socket. Obtenez une clé API depuis le tableau de bord EmpirioLabs.
import asyncio, json, os, websockets
async def main():
async with websockets.connect(
"wss://api.empiriolabs.ai/v1/realtime?model=gemini-3-8-live",
additional_headers=[
("Authorization", f"Bearer {os.environ['EMPIRIOLABS_API_KEY']}"),
],
max_size=None,
) as ws:
print(json.loads(await ws.recv())["type"]) # session.created
await ws.send(json.dumps({
"type": "conversation.item.create",
"item": {
"type": "message",
"role": "user",
"content": [{"type": "input_text", "text": "Say hello."}],
},
}))
await ws.send(json.dumps({"type": "response.create"}))
async for raw in ws:
event = json.loads(raw)
if event["type"] == "response.audio.delta":
... # base64 audio chunk, append to your playback buffer
elif event["type"] == "response.done":
break
asyncio.run(main())Paramètres de requête pris en charge par l'API Gemini 3.8 Live sur EmpirioLabs. Les valeurs par défaut s'appliquent quand un champ est omis.
| Paramètre | Type | Par défaut | Plage / valeurs | Description |
|---|---|---|---|---|
| voice | enum | Puck | Zephyr, Puck, Charon, Kore, Fenrir, Leda, Orus, Aoede, Callir... | Voix parlée pour la session. Configurez-le avec session.update avant que la conversation ne commence; cela ne peut pas changer après. |
| instructions | string | - | - | Conseils système sur le comportement et la communication du modèle. Configurez-le avec session.update avant que la conversation ne commence. |
| temperature | number | - | 0 à 2 | Température d’échantillonnage de 0 à 2. Des valeurs plus basses rendent les réponses plus cohérentes. Définissez-la avant que la conversation ne commence. |
| input_audio_format | enum | pcm16 | pcm16, pcm24 | Encodage de l’audio que vous ajoutez au tampon d’entrée: pcm16 est un PCM base64 16 bits à 16 kHz, et pcm24 est le même à 24 kHz. |
| output_audio_format | enum | pcm24 | pcm24 | Encodage de l’audio que le modèle diffuse en retour: PCM 16 bits à 24 kHz. |
| turn_detection | string | {"type":"server_vad"} | - | Détection d’activité vocale côté serveur. Détermine quand vous avez arrêté de parler et le modèle doit répondre. C’est activé par défaut; réglez-le sur nul pour... |
Connexion Voix full-duplex via un WebSocket à wss://api.empiriolabs.ai/v1/realtime?model=gemini-3-8-live, authentifié avec l’en-tête Authorization Bearer classique. Configurez la session avec session.update avant d’envoyer le premier audio: voix, instructions, détection de virage et outils. Ces réglages sont corrigés une fois la conversation commencée. Envoi audio et vidéo - Ajoutez l’audio du microphone en tant qu’événements input_audio_buffer.append: PCM 16 bits à 16 kHz, ou à 24 kHz avec input_audio_format réglé sur pcm24. - Ajoutez des images vidéo en direct comme événements input_image_buffer.append, sous forme d’images base64 JPEG ou PNG. - La détection de l’activité vocale est activée par défaut, donc continuez à diffuser environ une seconde après la fin de la voix. Réglez turn_detection sur nul pour terminer chaque tour vous-même avec input_audio_buffer.commit. Voix et langue - Utilisez l’une des 30 voix de la liste voice, par exemple Puck, Kore ou Charon. Toute autre valeur est refusée. - Le modèle répond dans la langue que vous parlez. Réponds - Les flux de voix en tant qu’événements response.audio.delta, PCM 16 bits à 24 kHz, avec les mots comme événements session.update 0__. Votre propre voix est également transcrite. - Parler pendant que le modèle répond l’interrompt. Outils - Appel de fonction avec les paramètres du schéma JSON. Retournez chaque résultat comme un élément session.update 1__ avec son session.update 2__. Facturation Les jetons audio et texte sont tarifés séparément dans les deux directions, les images vidéo facturent comme jetons d’entrée, et les jetons de raisonnement facturent comme jetons de sortie. Chaque tour complété est facturé de manière autonome selon l’utilisation indiquée par le modèle, y compris une réponse que vous interrompez.
Sur EmpirioLabs, Gemini 3.8 Live est facturé à l'usage : Entrée: audio $7.80 par 1M de jetons d’entrée audio; Entrée $2.60 par 1M de jetons d’invite; Produit $11.70 par 1M de jetons générés; Sortie: audio $31.20 par 1M de jetons audio générés. La grille tarifaire en direct de cette page correspond toujours à ce que l'API facture.
Gemini 3.8 Live prend en charge une fenêtre de contexte de 128K tokens avec jusqu'à 65 536 tokens de sortie par réponse.
Gemini 3.8 Live est servi via WEBSOCKET /v1/realtime sur api.empiriolabs.ai avec une authentification standard par token Bearer.
Ouvrez le playground EmpirioLabs et appuyez sur Start session pour l'essayer dans votre navigateur. Gemini 3.8 Live fonctionne sur un WebSocket plutôt qu'en requête et réponse, donc pour l'intégrer commencez par le guide de démarrage voix en temps réel. Connectez-vous depuis votre serveur avec votre clé API EmpirioLabs et l'id de modèle gemini-3-8-live, puis diffusez l'audio dans les deux sens.
Créez un compte EmpirioLabs, puis générez une clé sous API Keys dans le tableau de bord. La facturation utilise des crédits à l'usage : vous ne payez que vos requêtes.
Consultez nos tarifs ou contactez-nous si vous souhaitez que votre propre modèle soit déployé sur notre stack.