Input types: TextOutput: Audio

MireloMirelo SFX 2.0 (Text to Audio)

Generate sound effects and soundscapes from a text prompt with Mirelo SFX 2.0.

Text to AudioSound Effects

Use it in code

Use it with AI

Playground SDK API Advanced Usage Pricing

Authentication

Send your Picsart API key as a bearer token on every request.

Header

Authorization: Bearer <PICSART_API_KEY>

Make a request

One endpoint serves every model: POST to /workflows/v1/models/execute with the model id and its input in the body. The nesting is deliberate — the outer params is the envelope every workflow takes, and the inner one is this model's own input. Those inner names are the same unified ones the SDK takes, so a call translates one-to-one between the two — no per-vendor naming to learn.

cURL

curl -X POST 'https://api.picsart.com/workflows/v1/models/execute' \
  -H 'Authorization: Bearer $PICSART_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "params": {
    "model": "mirelo-sfx-2.0-text-to-audio",
    "params": {
      "prompt": "A serene mountain lake at golden hour, ultra detailed",
      "duration": 30
    }
  }
}'

Async (submit & poll)

This model can run longer than the sync limit (~20s), so send it to /workflows/v1/models/submit, which returns a task id, and poll /workflows/v1/models/{taskId}/result until response.status is COMPLETED or FAILED.

cURL

# 1. Submit the job
curl -X POST 'https://api.picsart.com/workflows/v1/models/submit' \
  -H 'Authorization: Bearer $PICSART_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "params": {
    "model": "mirelo-sfx-2.0-text-to-audio",
    "params": {
      "prompt": "A serene mountain lake at golden hour, ultra detailed",
      "duration": 30
    }
  }
}'
# → { "status": "success", "response": { "id": "task_abc123" } }

# 2. Poll until response.status is COMPLETED
curl 'https://api.picsart.com/workflows/v1/models/task_abc123/result' \
  -H 'Authorization: Bearer $PICSART_API_KEY'

Result body

{
  "status": "success",
  "response": {
    "id": "task_abc123",
    "status": "COMPLETED",
    "result": {
      "url": "https://cdn.picsart.com/…/result",
      "items": [
        {
          "url": "https://cdn.picsart.com/…/result"
        }
      ],
      "model": "mirelo-sfx-2.0-text-to-audio"
    }
  }
}

Parameters

7 parameters, sent inside the inner params object. Identical to the SDK's — one parameter set, whichever transport you use.

Parameter	Type	Required	Default	Details
`prompt` Prompt	`text`	yes	`—`	max 2000 chars
`negativePrompt` Negative Prompt	`text`	no	`—`	max 1000 chars
`duration`	`range`	no	`30`	1–600 (step 1)
`count`	`enum`	no	`2`	1, 2, 3, 4
`format` Format	`enum`	no	`wav`	wav, mp3, aac, flac
`bitrateKbps` Audio Bitrate (kbps)	`range`	no	`—`	32–320 (step 1)
`seed` Seed	`range`	no	`—`	0–2147483647 (step 1)

Response

The body arrives in the gateway's status envelope, so the output is at response.result — alongside the task id, its status and the amount charged. Asset models return url plus an items array; text models return text instead.

Response body