AudD

Modern .NET SDK for AudD generated from a locally maintained OpenAPI definition with AutoSDK.

Get started Get support

Generated from the source spec

Built from a local OpenAPI definition derived from AudD's public HTTP docs so the SDK stays close to the upstream API surface.

Auto-updated

Designed for fast regeneration and low-friction updates when the upstream API changes without breaking compatibility.

Modern .NET

Targets current .NET practices including nullability, trimming, NativeAOT awareness, and source-generated serialization.

Docs from examples

Examples stay in sync between the README, MkDocs site, and integration tests through the AutoSDK docs pipeline.

Usage

using AudD;

using var client = new AudDClient(apiToken);

var response = await client.Recognition.RecognizeByUrlAsync(
    url: "https://audd.tech/example.mp3",
    @return: "apple_music,spotify");

CLI

dotnet tool install --global AudD.CLI --prerelease
aud-d api --help

Recognize Audio

Basic example showing how to identify a song from an audio URL.

var apiToken =
    Environment.GetEnvironmentVariable("AUDD_API_TOKEN") is { Length: > 0 } tokenValue ? tokenValue :
    Environment.GetEnvironmentVariable("AUDD_API_KEY") is { Length: > 0 } keyValue ? keyValue :
    throw new AssertInconclusiveException("AUDD_API_TOKEN environment variable is not found.");

using var client = new AudDClient(apiToken);

// Recognize a short audio sample by URL. Additional providers such as
// Apple Music or Spotify can be requested with the return parameter.
var response = await client.Recognition.RecognizeByUrlAsync(
    url: "https://audd.tech/example.mp3",
    @return: "apple_music,spotify");

Support

Bugs

Open an issue in tryAGI/AudD.

Ideas and questions

Use GitHub Discussions for design questions and usage help.

Community

Join the tryAGI Discord for broader discussion across SDKs.

Acknowledgments

This project is supported by JetBrains through the Open Source Support Program.