Using Ai Music API Sounds in your workflow

Sorceress brings Suno models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

Add sound or speech to a creative workflow.
Integrate audio generation with your application using the model-specific parameters.

Pricing and availability

Sorceress pricing is awaiting activation. The reference catalog lists 3 credits per track; that reference is not a Sorceress quote. This entry cannot currently be invoked through Sorceress.

Inputs and supported options

{
  "type": "object",
  "required": [
    "prompt",
    "model"
  ],
  "properties": {
    "model": {
      "enum": [
        "V5",
        "V5_5",
        "V6",
        "V6_WILD",
        "V6_MINI"
      ],
      "type": "string",
      "title": "Model",
      "description": "Required. Use V6, V6_MINI or V6_WILD. `V6_WILD`**: Pushes creative boundaries for bolder, more distinctive musical expression. `V6_MINI`**: Lightweight and fast, balancing quality and speed for effortless creation. `V6`**: Greater musical expression with more natural vocals and richer details."
    },
    "prompt": {
      "type": "string",
      "title": "Prompt",
      "description": "Description of the sound (max 500 characters)."
    },
    "sound_key": {
      "enum": [
        "Any",
        "Cm",
        "C#m",
        "Dm",
        "D#m",
        "Em",
        "Fm",
        "F#m",
        "Gm",
        "G#m",
        "Am",
        "A#m",
        "Bm",
        "C",
        "C#",
        "D",
        "D#",
        "E",
        "F",
        "F#",
        "G",
        "G#",
        "A",
        "A#",
        "B"
      ],
      "type": "string",
      "title": "Sound key",
      "default": "Any",
      "description": "Musical key. Default \"Any\" (automatic)."
    },
    "sound_loop": {
      "type": "boolean",
      "title": "Sound loop",
      "default": false,
      "description": "Whether the generated sound loops seamlessly."
    },
    "grab_lyrics": {
      "type": "boolean",
      "title": "Grab lyrics",
      "default": false,
      "description": "Whether to capture the lyrics subtitles Will the interface be called after completion to obtain the lyrics subtitles?"
    },
    "sound_tempo": {
      "type": "integer",
      "title": "Sound tempo",
      "maximum": 300,
      "minimum": 1,
      "description": "Tempo in BPM (1–300). Omit for automatic tempo."
    }
  }
}

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.