🚀 Getting started

Install the Tonic Textual SDK

Before you get started, you must install the Textual Python SDK:

pip install tonic-textual

Set up a Textual API key

To authenticate with Tonic Textual, you must set up an API key. After creating your account, to obtain an API key, go to the User API Keys page.

After, you obtain the key, you can optionally set it as an environment variable:

export TONIC_TEXTUAL_API_KEY="<API-KEY>""

You can can also pass the API key as a parameter when you create your Textual client.

Creating a Textual client

To redact text or files, use our TextualNer client. To parse files, which is useful for extracting information from files such as PDF and DOCX, use our TextualParse client.

from tonic_textual.redact_api import TextualNer
from tonic_textual.parse_api import TextualParse

textual = TextualNer()
textual = TextualParse()

Both client support several optional arguments:

  • base_url - The URL of the server that hosts Tonic Textual. Defaults to https://textual.tonic.ai

  • api_key - Your API key. If not specified, you must set TONIC_TEXTUAL_API_KEY in your environment.

  • verify - Whether to verify SSL certification. Default is true.