Skip to content
Introducing STTv6See what's new
Console

Projects and regions

Use projects to separate API keys, usage, and data, and choose the region where each project processes and stores data.

A project is a workspace inside your organization. Each project has its own API keys, usage reports, limits, and stored files and transcripts.

Use projects to keep things apart. Common setups:

  • One project for development and one for production, so test traffic never touches production keys or limits.
  • One project per product or customer, so you can see the cost of each one.
  • A project in another region, to keep data in a certain part of the world or to lower latency for users near it.

Create a project

Open the project switcher at the top of the page and select Create project.

Enter a name and, if you like, a description.

Choose a region. Regions your organization can't use yet are grayed out. To use one, select Request access next to it. See Request a region.

Select Create project, then create an API key for it under Project > API keys.

Regions

The region decides where Soniox processes and stores the project's audio and transcripts. For example, a project in the European Union region keeps that data in the EU.

  • You can't change a project's region later. To use another region, create a new project in that region.
  • Use the region's API domain. An API key from an EU project must call api.eu.soniox.com, not api.soniox.com. Data residency lists the domains for each region.
  • Some regions need approval. See Request a region.

For what stays in the region and what doesn't, see Data residency.

Request a region

To use a region your organization doesn't have yet, ask Soniox for access. You need funds in your organization and a role that allows it. See Members and roles.

Go to Organization > Security & compliance and select Request access. You can also start a request from the region list when you create a project.

Explain why you need the region, and send the request.

The region shows as Pending until Soniox approves it.

Delete a project

Go to Project > Settings and select Delete this project. To confirm, type the project's name.

Deleting a project can't be undone

All API keys in the project stop working at once, and all of its files and transcripts are deleted.

On this page