Music Intelligence
Audio analysis engine for full-dimensional music intelligence JSON.
음원 분석 결과를 v1 계약으로 감싸 제공하는 분석 엔진입니다.
Overview
The analyzer engine is live at analyzer.thegreit.com and is used for upload analysis, reanalysis, and embeddings. The clap_ready analysis path is already part of production workflows.
The v1 wrapper is what remains in progress. It is additive and preserves the current analyzer behavior while exposing a cleaner public contract.
All responses are JSON. Operational endpoints expose health and version data, and v1 responses include the X-Engine-Version response header.
The stored analysis endpoint returns analysis for a known track id once ingestion has completed.
API Reference
Submit an audio URL or file reference for full analysis JSON.
| Name | Type | Required | Description |
|---|---|---|---|
| audio_url | string | Yes | Public or policy-accepted audio URL used as the analyzer input. |
| track_id | string | No | Optional caller track id to associate with the analysis. |
Response
Full analysis JSON across analyzer dimensions. v1 wrapping is in progress, so the wrapper preserves current analyzer behavior.
Read stored analysis for a track.
| Name | Type | Required | Description |
|---|---|---|---|
| track_id | string | Yes | Stored track identifier. |
Response
Stored analysis JSON for the requested track.
Read analyzer health status.
Response
Operational health JSON.
Read analyzer version metadata.
Response
Version JSON plus X-Engine-Version.
Quickstart
curl -X POST "https://analyzer.thegreit.com/v1/analyze" \
-H "Authorization: Bearer $GREIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"audio_url":"https://cdn.example.com/audio/track.wav"}' \
-iVersion log