Getting Started

Overview

The Precital API enables programmatic access to:

• Audio Analysis: Analyze tracks to extract genre, mood, BPM, key, instruments, and more

• Lyric Analysis: Analyze song lyrics for themes, moods, explicit content, and keywords

• Press Release Generation: Generate professional press releases for music releases

Authentication

All API requests (except

/health

) require authentication using an API key. API keys are workspace-scoped and can be generated from your account settings in the Precital app.

Include your API key in the

X-API-Key

header:

X-API-Key: your-api-key-here

The workspace associated with your API key is automatically inferred - you don't need to specify it in requests.

Credits

All API operations consume credits from your workspace's credit balance. Each endpoint description includes information about credit costs. If your workspace has insufficient credits, the API will return a

CREDITS_EXHAUSTED

error.

Rate Limits

API requests are subject to rate limiting. If you exceed the rate limit, you'll receive a

RATE_LIMITED

error with a

Retry-After

header indicating when you can retry.

Future Authentication

In the future, we may support Supabase JWT authentication for first-party users. The API is designed to support multiple authentication schemes.