Blog / Ingegneria

SDK Python Cartesia v2.0.0

Arjun Desai 
SDK Python Cartesia v2.0.0

Annunciamo la versione v2.0.0 del nostro SDK Python, che migliora l’esperienza di sviluppo per chi usa le funzionalità di IA vocale di Cartesia con Python.

Questo annuncio descrive l’SDK v2.0.0. Per una guida alla configurazione con l’SDK v4.2.0, consulta Sintesi vocale in Python: salvare l’audio come file WAV.

Iniziare con Cartesia in Python

Installa l’SDK Python Cartesia nel tuo progetto:

pip install cartesia

Inizializza l’SDK ed esegui l’autenticazione:

from cartesia import Cartesia
import os

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

Ora puoi iniziare a inviare richieste. Per esempio, per generare audio con il modello di sintesi vocale di 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",
    },
)

Per altri esempi, usa il nostro API Explorer per generare frammenti di codice Python per qualsiasi nostra API.

L’SDK Python in breve

Basata su schemi consolidati nel settore, la v2 del nostro SDK Python organizza l’esperienza di sviluppo intorno a un client Cartesia principale, il punto di ingresso per accedere ai diversi endpoint API.

Altre funzionalità

  • Client di base: crea e usa il client con sole 24 righe di codice.
  • Client asincrono: l’SDK esporta un client async oltre alle chiamate standard in tempo reale, per inviare richieste API non bloccanti.
  • Streaming: l’SDK supporta risposte in streaming e restituisce un generatore su cui puoi iterare.
  • WebSocket: integra tramite WebSocket per costruire applicazioni vocali in tempo reale a bassa latenza.
  • Gestione delle eccezioni: l’API gestisce i codici di stato non riusciti, risposte 4xx e 5xx.
  • Tentativi automatici: l’SDK include nuovi tentativi automatici con attesa esponenziale.
  • Timeout: il timeout predefinito dell’SDK è di 60 secondi. Puoi configurarlo a livello di client o di singola richiesta.
  • Client personalizzato: puoi sostituire il client httpx per adattarlo al tuo caso d’uso, per esempio per supportare proxy e trasporti specifici.

E adesso?

Vogliamo vedere cosa costruirai con l’SDK Python Cartesia. Il tuo feedback ci aiuta a migliorare: condividi le tue osservazioni aprendo segnalazioni su GitHub.