Demucs

0.84 credits/second
ae_demucs

Separate a mixed audio file into stems such as vocals, drums, bass, guitar, piano, and other instruments.

Audio
0.84 credits/second

Pricing

0.84 credits per second of input audio processed.

0.84 credits/second

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.modelenum (htdemucs | htdemucs_ft | htdemucs_6s | hdemucs_mmi | mdx | mdx_extra | mdx_q | mdx_extra_q)NoDemucs model to use for separationhtdemucs_6s
request_body.stemsarray | unknownNoSpecific stems to extract. If None, extracts all available stems. Available stems depend on model: vocals, drums, bass, other, guitar, piano (for 6s model)—
request_body.shiftsintegerNoNumber of random shifts for equivariant stabilization. Higher values improve quality but increase processing time.1
request_body.overlapnumberNoOverlap between segments (0.0 to 1.0). Higher values may improve quality but increase processing time.0.25
request_body.audio_urlstringYesURL of the audio file to separate into stems—
request_body.output_formatenum (wav | mp3)NoOutput audio format for the separated stemsmp3
request_body.segment_lengthinteger | unknownNoLength in seconds of each segment for processing. Smaller values use less memory but may reduce quality. Default is model-specific.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_demucs' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "audio_url": "https://litter.catbox.moe/40xbz6.wav",
      "model": "htdemucs_ft",
      "output_format": "wav",
      "overlap": 0.25,
      "shifts": 1,
      "stems": [
        "vocals",
        "drums",
        "bass",
        "other"
      ]
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "5259fbba-e3b2-45ab-a7ff-c1136bb5e554"
}