Blog / Engenharia

SDK Python da Cartesia v2.0.0

Arjun Desai 
SDK Python da Cartesia v2.0.0

Lançamos a versão 2.0.0 do nosso SDK Python, aprimorando a experiência de desenvolvimento com os recursos de voz por IA da Cartesia em Python.

Este anúncio descreve o SDK v2.0.0. Para configurar a versão 4.2.0, consulte Texto para fala em Python: salvar áudio em um arquivo WAV.

Começar a usar a Cartesia com Python

Instale o SDK Python no projeto:

pip install cartesia

Inicialize o SDK e faça a autenticação:

from cartesia import Cartesia
import os

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

Agora você pode fazer requisições. Por exemplo, para gerar áudio com o modelo de texto para fala da 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",
    },
)

Para mais exemplos, use o API Explorer para gerar trechos Python de qualquer uma das nossas APIs.

Visão geral do SDK Python

Seguindo padrões de SDK consolidados no setor, a versão 2 oferece uma experiência organizada em torno de um cliente Cartesia principal, o ponto de entrada para os diferentes endpoints da API.

Mais recursos

  • Cliente básico: instancie e use o cliente com apenas 24 linhas de código.
  • Cliente assíncrono: além das chamadas padrão em tempo real, o SDK exporta um cliente async para requisições não bloqueantes.
  • Transmissão em tempo real: o SDK aceita respostas em streaming e retorna um gerador que você pode percorrer.
  • WebSocket: integre por WebSockets para criar aplicações de voz em tempo real com baixa latência.
  • Tratamento de exceções: a API trata códigos de falha, como respostas 4xx e 5xx.
  • Novas tentativas: o SDK inclui repetição automática com espera exponencial.
  • Tempo limite: o padrão é 60 segundos, configurável no cliente ou na requisição.
  • Cliente personalizado: substitua o cliente httpx para atender ao seu caso, por exemplo com proxies e transportes personalizados.

O que vem a seguir?

Queremos ver o que você vai criar com o SDK Python da Cartesia. Seu feedback nos ajuda a melhorar. Envie sugestões e problemas pelo GitHub.