Skip to Content

Preternatural

Preternatural connects your application to AI providers through a single gateway. It lets you control which models customers can use, authenticate customer requests all on the client side.

Get started

Create a project

Create a project →

Add a provider account

Configure a provider account →

Configure a product

Configure a product →

Integrate the Client SDK

Configure the Client SDK →

Client SDK

Use @preternatural-js/client-sdk to authenticate customers and make model requests from JavaScript or TypeScript applications.

Install the SDK and understand the customer request flow.

Client SDK overview

Create a client and configure its project, environment, and transport.

Configure the Client SDK

Restore sessions and authenticate sandbox customers.

Authentication

Send streaming and non-streaming chat completions.

Chat completions

Read a customer’s usage and limit information.

Customer usage

Configure another SDK to send authenticated requests through the gateway.

Gateway configuration

Provider integrations

Use the Client SDK directly or configure a provider SDK to send requests through the Preternatural gateway.

Send OpenAI chat completions using the Client SDK or the official OpenAI SDK.

OpenAI

Send Anthropic chat completions using the Client SDK or the official Anthropic SDK.

Anthropic

Send Jev System One requests using the TypeSafe AI SDK.

Jev

Develop in sandbox

Learn how sandbox projects and customers work.

Sandbox mode

Create a synthetic customer for testing Client SDK authentication.

Create a sandbox customer