SDK de Python de Cartesia v2.0.0

Presentamos la versión 2.0.0 de nuestro SDK de Python, que mejora la experiencia de desarrollo al usar las funciones de voz con IA de Cartesia en Python.

Este anuncio describe el SDK v2.0.0. Para consultar una guía de configuración con el SDK v4.2.0, lee Texto a voz con Python: guardar audio como archivo WAV.

Primeros pasos con Cartesia en Python

Instala el SDK de Python de Cartesia en tu proyecto con:

pip install cartesia

Inicializa el SDK y autentícate:

from cartesia import Cartesia
import os

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

Ya puedes empezar a enviar solicitudes. Por ejemplo, para generar audio con el modelo de texto a voz 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",
    },
)

Encontrarás más ejemplos en nuestro explorador de API, donde puedes generar fragmentos de código Python para cualquiera de nuestras API.

El SDK de Python de un vistazo

La versión 2 de nuestro SDK de Python sigue patrones establecidos en el sector. Organiza la experiencia de desarrollo en torno a un cliente principal de Cartesia, el punto de entrada para acceder a los distintos endpoints de la API.

Más funciones

• Cliente básico: crea y utiliza el cliente con solo 24 líneas de código.
• Cliente asíncrono: además de las llamadas habituales en tiempo real, el SDK exporta un cliente async para enviar solicitudes a la API sin bloquear la ejecución.
• Transmisión en tiempo real: el SDK admite respuestas en streaming y devuelve un generador que puedes recorrer.
• WebSocket: integra WebSockets para crear aplicaciones de voz en tiempo real con baja latencia.
• Gestión de excepciones: la API gestiona los códigos de estado que indican errores, las respuestas 4xx y 5xx.
• Reintentos: el SDK incorpora reintentos automáticos con espera exponencial.
• Tiempos de espera: el SDK utiliza un tiempo de espera predeterminado de 60 segundos. Puedes configurarlo mediante una opción del cliente o de cada solicitud.
• Cliente personalizado: puedes sustituir el cliente httpx para adaptarlo a tu caso de uso. Entre los usos habituales están la compatibilidad con proxies y transportes.

¿Qué viene después?

¡Queremos ver lo que creas con el SDK de Python de Cartesia! Tus comentarios nos ayudan a mejorar. Comparte tus ideas abriendo incidencias en GitHub.