Skip to main content
Learn how to create an account, generate an API key, and make your first API call.
1

Create your account

Sign up for a free account at dashboard.pyannote.ai to access the pyannoteAI platform.
  1. Go to dashboard.pyannote.ai
  2. Signup with your work email or use your GitHub account to register
  3. Complete your account setup
Once registered, you’ll have access to your team dashboard where you can manage API keys, view usage statistics, and more.
2

Generate an API key

Generate an API key to authenticate your requests to the pyannoteAI API.
  1. In your dashboard, navigate to the API Keys section
  2. Click “Create new key”
  3. Give your key a descriptive name (e.g., “Development key”)
  4. Copy the key and store it securely (you won’t be able to see it again after you leave the page) API Keys Page
Keep your API key secure and never expose it in client-side code or public repositories.
3

Test your API connection

Verify your API key is working by making a test request to our test endpoint.
Test API Call
# Set your API key as an environment variable in production
# export PYANNOTE_API_KEY="your_api_key_here"
curl --request GET \
  --url https://api.pyannote.ai/v1/test \
  --header 'Authorization: Bearer YOUR_API_KEY_HERE' \
  --header 'Content-Type: application/json'
If successful, you’ll receive a response like:
{
  "message": "API key is valid",
  "status": "success"
}

​
What’s next?

Now that you have a working API key, you can start building with pyannoteAI:

Diarize audio files

Learn how to submit audio files for speaker diarization and process the results.

API reference

Explore the complete API documentation for all available endpoints.

​
Need help?