Sample report

A real report, start to finish

This is the exact shape the API returns for every finished job. Measured fields, best-effort estimates with their confidence, the provenance, and the delivery trail. The values are from a representative track; the structure is the real one.

succeededjob_3f7a91c2
schema analysis_result_v0_1
Report stored atreports/job_3f7a91c2.json
Source file deleted after the report was written

Measured

The numbers that don’t move

Computed directly from the audio. Run the same track twice and you get the same figures.

Measured directly
Duration
123.4seconds
duration_seconds
Integrated loudness
−14.1LUFS
integrated_loudness_lufs
Sample peak
−1.2dBFS
sample_peak_dbfs
RMS level
−18.7dB
rms_loudness
Spectral centroid
1,800Hz
spectral.spectral_centroid

Best effort

Estimates that show their confidence

Each one comes with a confidence score. Read a high number as “probably” and a low one as “worth checking yourself.”

Confidence attached
Tempo128 BPM
71%
bpm
Musical keyA minor
64%
key_notation
Time signature4 / 4
80%
time_signature
First section boundary0:00 → 0:32
50%
sections[0]

Provenance

Where every field came from

This report is entirely local SonicCore. Nothing was sent to an external provider, and the report says so.

  • EngineSonicCore
  • Provenancelocal
  • Capabilitiescore · best_effort_music
  • Analysis time42 ms
  • Provider calls0 (€0.00)

Delivery trail

Four events, in order

The same lifecycle events you can subscribe to. The last one is the signed webhook telling you it landed.

analysis.soniccore.completedAnalysis finished, 42 ms
analysis.report.storedreports/job_3f7a91c2.json
analysis.audio.deletedSource removed
webhook.deliveredHTTP 204

The raw payload

All of it is just this JSON

The exact payload the result endpoint returns. Everything on this page is only a friendlier read of what’s below.

GET /v1/analyses/job_3f7a91c2/result
{
  "job_id": "job_3f7a91c2",
  "status": "succeeded",
  "report_artifact": {
    "key": "reports/job_3f7a91c2.json",
    "bytes": 2417
  },
  "result": {
    "duration_seconds": 123.4,
    "sample_peak_dbfs": -1.2,
    "integrated_loudness_lufs": -14.1,
    "rms_loudness": -18.7,
    "spectral": {
      "spectral_centroid": 1800
    },
    "bpm": 128,
    "bpm_confidence": 0.71,
    "key_notation": "A minor",
    "key_confidence": 0.64,
    "time_signature": 4,
    "time_signature_confidence": 0.8,
    "sections": [
      {
        "start_time": 0,
        "duration": 32,
        "confidence": 0.5
      }
    ],
    "provider_results": {
      "soniccore": {
        "status": "ok",
        "provenance": "local",
        "capabilities": [
          "core",
          "best_effort_music"
        ]
      }
    },
    "semantic": {},
    "timing_ms": {
      "total": 42
    },
    "soniccore_api_schema_version": "analysis_result_v0_1",
    "soniccore_api_analysis_id": "sha256:9f2c…e41"
  }
}