​
Create your Waystone account

Create a Waystone account by logging in at waystone.run. Get yourself set up with your first organization, then create a project.

​
Projects

Almost everything in Waystone is scoped to a project. How you choose to use projects is totally up to you, but we generally recommend having one project for each of your environments (dev, stag, prod, etc.). Each project will have a slug unique to your organization that you can use to reference the project via the API.

​
Create an API key

Head to your project ‘Settings’ to create your first API key. The key will start with wsak-, and you can use it with the API when making requests via the Waystone gateway, in place of your model provider-specific API key, allowing you to easily switch models at-will.

​
Set up model providers

On the project ‘Settings’ page, configure the model providers (OpenAI, Anthropic, etc.) that you wish to use through Waystone. Your API keys will be encrypted and stored securely in Waystone. Once you’ve configured providers, the ‘Models’ page will show you the models available to you. You can still use models that aren’t listed, but traces and observations (coming soon) may be missing cost information.

​
Send your first request

Send your first request to Waystone using any OpenAI compatible client! You only have to change two lines of code. 
  const client = new OpenAI({
-   apiKey: process.env['OPENAI_API_KEY'],
+   apiKey: process.env['WAYSTONE_API_KEY'],
+   baseURL: 'https://waystone.run/api/gateway/v1',
  });

  const response = await client.responses.create({
    model: 'gpt-4o',
    instructions: 'You are a coding assistant that talks like a pirate',
    input: 'Are semicolons optional in JavaScript?',
  });

​
Walkthrough example

Create your Waystone account

It takes less than two minutes!

API reference

Check out our REST API reference. Our gateway API is a super-powered superset of the OpenAI API, and is fully compatible!

Cookbook: Manage model access

Follow this recipe for managing which models your different tiers of users can access.

Cookbook: Model fallback

Follow this recipe to set up fallbacks for your requests in case a model becomes unavailable.