Cartesia | SDK Python de Cartesia v2.0.0

Nous annonçons la version 2.0.0 de notre SDK Python, qui améliore l’expérience des développeurs utilisant les fonctions vocales d’IA de Cartesia avec Python.

Cette annonce décrit le SDK v2.0.0. Pour un guide de configuration avec le SDK v4.2.0, consultez Synthèse vocale en Python : enregistrer l’audio dans un fichier WAV.

Démarrer avec Cartesia en Python

Installez le SDK Python de Cartesia dans votre projet :

pip install cartesia

Initialisez le SDK et authentifiez-vous :

from cartesia import Cartesia
import os

client = Cartesia(api_key=os.getenv("CARTESIA_API_KEY"))

Vous pouvez maintenant envoyer des requêtes. Par exemple, pour générer de l’audio avec le modèle de synthèse vocale de Cartesia :

client.tts.bytes(
    model_id="sonic-2",
    transcript="Hello, world!",
    voice={
        "mode": "id",
        "id": "694f9389-aac1-45b6-b726-9d9369183238",
    },
    language="en",
    output_format={
        "container": "wav",
        "sample_rate": 44100,
        "encoding": "pcm_f32le",
    },
)

Pour d’autres exemples, consultez notre explorateur d’API afin de générer des extraits de code Python pour chacune de nos API.

Le SDK Python en un coup d’œil

Fondée sur des conventions de SDK établies dans le secteur, la version 2 de notre SDK Python propose une expérience de développement structurée autour d’un client Cartesia principal. Celui-ci constitue le point d’entrée vers les différents points de terminaison de l’API.

Encore plus de fonctions

Client de base : instanciez et utilisez le client en seulement 24 lignes de code.
Client asynchrone : le SDK exporte un client async en complément des appels standard en temps réel, pour envoyer des requêtes API non bloquantes.
Diffusion en continu : le SDK prend en charge les réponses en continu et produit un générateur que vous pouvez parcourir.
WebSocket : utilisez les WebSockets pour créer des applications vocales en temps réel à faible latence.
Gestion des exceptions : l’API gère les codes d’état d’échec, réponses 4xx et 5xx.
Nouvelles tentatives : le SDK effectue des tentatives automatiques avec délai d’attente exponentiel.
Délais d’expiration : le délai par défaut du SDK est de 60 secondes. Vous pouvez le configurer au niveau du client ou de la requête.
Client personnalisé : vous pouvez remplacer le client httpx pour l’adapter à votre usage, notamment pour prendre en charge des proxys et des transports.

Et ensuite ?

Nous avons hâte de voir ce que vous créerez avec le SDK Python de Cartesia ! Vos retours nous aident à l’améliorer. Partagez-les en ouvrant des tickets sur GitHub.