decode_sstv
Demodulate a presented slow-scan-television (SSTV) audio recording, anchor the audio fingerprint and the decoded image hash to the Knox event chain, and return a self-authenticating receipt bundle (Knox anchor + C2PA-aligned envelope + FRE 902(13)/(14)-shape affidavit). Audio bytes are NOT retained — only the SHA-256 fingerprint and the decoded image are anchored. Bonis Systems does not capture audio on its own; the audio must be presented by the caller (a public WebSDR recording, a customer-controlled SDR capture they consent to submit, or audio they own). Phase 1 supports Martin M1 (VIS code 0x2C, 320×256 RGB). Other VIS codes return mode = 'unsupported' with detected hex. Requires a Knox Bearer API key on the Authorization header — unauthenticated calls are rejected.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Display name for the recording (max 256 chars). | |
| capture | No | Optional capture-context metadata. | |
| sampleRate | No | Required when audioFormat = 'pcm16-mono'. | |
| audioBase64 | Yes | Base64-encoded audio. Either a complete WAV file (RIFF/WAVE, 8/16/24-bit PCM or 32-bit IEEE float, mono or stereo, 4-192 kHz) or raw 16-bit signed little-endian mono PCM samples. | |
| audioFormat | No | Audio container ('wav' default, or 'pcm16-mono'). |