action.yml

name: StemSplit
description: Official StemSplit action — AI stem separation and vocal removal from public audio URLs in CI/CD (HTDemucs API).
author: StemSplit

branding:
  icon: music
  color: green

inputs:
  operation:
    description: Operation to run (create-job or balance).
    required: false
    default: create-job
  api-key:
    description: StemSplit API key (sk_live_...).
    required: true
  source-url:
    description: Public audio URL to process (required for create-job).
    required: false
  output-type:
    description: "Stem output type: VOCALS, INSTRUMENTAL, BOTH, FOUR_STEMS, or SIX_STEMS."
    required: false
    default: BOTH
  quality:
    description: "Processing quality: FAST, BALANCED, or BEST."
    required: false
    default: BEST
  output-format:
    description: "Output format: MP3, WAV, or FLAC."
    required: false
    default: MP3
  denoise-vocals:
    description: Run extracted vocals through the Voice Cleaner after separation.
    required: false
    default: "false"
  wait:
    description: Wait until the job reaches COMPLETED or FAILED.
    required: false
    default: "false"
  timeout-seconds:
    description: Maximum seconds to wait when wait is true.
    required: false
    default: "300"
  api-base-url:
    description: StemSplit API base URL.
    required: false
    default: https://stemsplit.io/api/v1
  metadata:
    description: Optional JSON object stored on the job (stringified object).
    required: false

outputs:
  job-id:
    description: Created or polled job id.
  status:
    description: Current or final job status.
  balance-seconds:
    description: Credit balance in seconds when operation is balance.
  balance-formatted:
    description: Human-readable balance when operation is balance.
  result-json:
    description: Full JSON result from the API.

runs:
  using: node20
  main: src/main.js