API Overview

The Amplifier Health API analyzes acoustic properties of a speaker's voice to produce structured health signals — numerical scores and categorical levels — across behavioral, cognitive, and metabolic conditions. The API provides two analysis interfaces:

Model API (POST /v2/models/{model_name}/analyze) — Submit audio against a named multi-sign model bundle. Returns a summary, signals[] array, and audio_quality. See Model API.
Sign API (POST /v2/signs/{sign_name}/analyze) — Analyze a single sign. Returns a single signal object and audio_quality. See Sign API.

All endpoints return JSON. Successful v2 analyze and job responses return HTTP 200 with a job object in the body (see Response Schema). Error responses return the appropriate HTTP status and a JSON object with code, message, and status — see Error Reference.

Authentication

All requests require X-Account-ID. The second required header depends on your API version:

Header	Description
`X-Account-ID`	Your account identifier
`X-Secret-Key`	Your secret key (V1 only)
`X-API-Key`	Your API key (V2 only)

Sign up at console.amplifierhealth.com, open the console, and create an API key under API Keys — enter a label in the New Key field and click Create key. Your account ID is shown in the console. See Getting Started for the full walkthrough.

The examples below call v2 GET /v2/account/credits with X-API-Key. V1 uses the same X-Account-ID header but X-Secret-Key instead of X-API-Key, and paths under /api/v1/... (for example GET https://api.amplifierhealth.com/api/v1/account/credits) — see Legacy API (v1).

curl -X GET "https://api.amplifierhealth.com/v2/account/credits" \
-H "X-Account-ID: your-account-id" \
-H "X-API-Key: your-api-key"

Limits

Limit	Value
Maximum audio file size	32 MB per upload
Maximum audio duration	20 minutes (1200 seconds)
Minimum audio duration	15 seconds
Supported formats	WAV, FLAC, MP3, M4A

For longer recordings, MP3 or FLAC typically keep file size under the 32 MB limit. See Audio Requirements.

Rate Limits

The API enforces per-account rate limits using a sliding 60-second window. Limits vary by rate limit plan:

Plan	General Endpoints	Upload / Analyze Endpoints
Standard (default)	10 requests/min	5 requests/min
Enterprise	1,000 requests/min	500 requests/min

Upload / Analyze endpoints:

V2: POST /v2/models/{model_name}/analyze, POST /v2/signs/{sign_name}/analyze
V1: POST /api/v1/{condition}/analyze-audio, analyze-audio-url, analyze-and-diarize-audio, analyze-and-diarize-audio-url

General endpoints (all other requests):

V2: GET /v2/account/credits, GET /v2/jobs, GET /v2/jobs/{job_id}, POST /v2/account/webhook
V1: GET /api/v1/account/credits, GET /api/v1/account/jobs, GET /api/v1/account/jobs/{job_id}, POST /api/v1/account/webhook

When a rate limit is exceeded, the API returns 429 Too Many Requests with a Retry-After header indicating seconds until the window resets. See Error Reference for retry guidance.

To request rate limit changes, please contact sales@amplifierhealth.com.