List available models

gethttps://api.netflix.developers.gaudiolab.io/v1/models

Returns every separation model your project can use, identified by a stable, human-readable alias. Pass an alias as the model field when creating a job target. Public aliases include a family prefix and version suffix, so similarly named tracks from different model families remain distinct.

get/models

curl -X GET "https://api.netflix.developers.gaudiolab.io/v1/models" \
  -H "x-api-key: $API_KEY"

Response200

{
  "models": [
    {
      "alias": "dme_dialogue_v1",
      "category": "dme_separation",
      "description": "Extracts all voices, including dialogue and vocals, while removing background music and effects.",
      "outputs": [
        "dialogue"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "dme_music_v1",
      "category": "dme_separation",
      "description": "Extracts music, including vocals, while removing dialogue and effects.",
      "outputs": [
        "music"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "dme_music_effects_remove_vocals_v2",
      "category": "dme_separation",
      "description": "Preserves music and effects only, removing both dialogue and vocals, with cleaner separation and higher fidelity than v1.",
      "outputs": [
        "music_effects_remove_vocals"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "stem_bass_v1",
      "category": "stem_separation",
      "description": "Extracts the bass stem from music.",
      "outputs": [
        "bass"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "stem_vocal_v1",
      "category": "stem_separation",
      "description": "Extracts the vocal stem from the multi-stem separation family.",
      "outputs": [
        "vocal"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "karaoke_vocal_v1",
      "category": "karaoke_separation",
      "description": "Extracts the vocal track from the karaoke-style vocal/accompaniment split.",
      "outputs": [
        "vocal"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "denoise_speech_v1",
      "category": "denoise",
      "description": "Isolates clean speech from background noise.",
      "outputs": [
        "speech"
      ],
      "formats": [
        "wav"
      ]
    },
    {
      "alias": "dme_dialogue_remove_vocals_v1",
      "category": "dme_separation",
      "description": "Dialogue-only extraction that removes vocals, music, and effects.",
      "outputs": [
        "dialogue_remove_vocals"
      ],
      "tiers": [
        "premium",
        "standard",
        "live"
      ],
      "formats": [
        "wav"
      ],
      "input_channel_layouts": [
        "mono",
        "stereo",
        "5.1"
      ],
      "tier_overrides": {
        "live": {
          "input_channel_layouts": [
            "mono",
            "stereo"
          ]
        }
      }
    }
  ]
}

Headers

x-api-keyRequired

Your project API key, sent on every request. Create and manage keys in the dashboard under Settings → API Keys.

Response

200The list of models. The catalog is defined in spec/models.yaml (the same source the Models reference page renders), so this response and that page never drift apart.

modelsModel[]Optional

aliasstringRequired

Stable identifier to pass as model when creating a target. Public aliases include a family prefix and version suffix, such as dme_dialogue_v1, stem_vocal_v1, or karaoke_vocal_v1.

categoryenumRequired

High-level family the model belongs to.

Allowed values: dme_separationstem_separationkaraoke_separationdenoise

descriptionstringOptional

A short, human-readable summary of what the model extracts.

outputsstring[]Required

The stem keys this model produces. These appear as the first level of keys in a completed target's output object.

tiersenum[]Optional

DME processing tiers this model supports. Present for DME models only; use one of these values as the target tier.

tier_overridesmap<string, object>Optional

Capabilities that differ for one tier of this model, keyed by tier id. A tier runs its own model, so it can accept less than the model-level fields advertise — a listed field REPLACES the model-level value for that tier only. Present only where a tier actually differs; absent tiers use the model-level values. Today the only overridden field is input_channel_layouts.

formatsenum[]Required

Audio formats this model can render.

input_channel_layoutsenum[]Optional

Input channel layouts this model accepts. Omitted for models that accept only mono and stereo; DME models also list 5.1. A 5.1 input is accepted only when every target in the job accepts 5.1, and the separated tracks are returned as 5.1.

creditsPerMinutenumberOptional

Credits consumed per minute of input audio.