pip install charactr-api-sdk

from charactr_api import CharactrAPISDK, Credentials

sdk = CharactrAPISDK(Credentials(client_key="xxx", api_key="yyy"))

tts_voices = sdk.tts.get_voices()

result = sdk.tts.convert(tts_voices[0]["id"], "Hello world")

def on_data(data: bytes) -> None:
	# do anything with the incoming binary data

def on_close(code: int, message: str) -> None:
	if code != 1000:
		# stream was closed with an error
	else:
		# stream was ended successfully

stream = sdk.tts.start_simplex_stream(
  voice_id, text, on_data=on_data, on_close=on_close
)

start_duplex_stream(voice_id: int,
                    on_data: (bytes) -> None | None = None,
                    on_close: (int, str) -> None | None = None) -> TTSStreamDuplex

def convert(text: str) -> None:
  """Convert text to speech and receive audio response as stream,
  using the `on_data` callback."""
  
def wait() -> None:
  """Blocks execution until there was 5 seconds of stream inactivity."""
  
def terminate() -> None:
  """Ends the stream immediately. In most cases we advise to use `close()` instead."""
  
def close() -> None:
  """Requests the server to close the connection gracefully."""

def on_data(data: bytes) -> None:
    # do anything with the incoming binary data

def on_close(code: int, message: str) -> None:
    if code != 1000:
        # the stream was closed because of an error
    else:
        # the stream ended successfully

stream = sdk.tts.start_duplex_stream(
    voice_id, on_data=on_data, on_close=on_close
)
stream.convert(text1)
stream.convert(text2)
stream.close()

tts_voices = sdk.vc.get_voices()

result = sdk.vc.convert(vc_voices[0]["id"], audio_input)

{ "cloned_voice": True }