Skip to main content
POST
/
v1
/
audio
/
waveform
{
  "input": "https://example.com/audio.wav",
  "width": 1920,
  "height": 200,
  "color": "0x00ff00"
}

curl -X POST https://api.ringbee.dev/v1/audio/waveform \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@audio.mp3" \
  -F "width=1920" \
  -F "height=200" \
  -F "color=0x00ff00"

{
  "id": "job_abc123",
  "status": "pending"
}
{
  "error": "<string>"
}
{
  "error": "<string>"
}
{
  "input": "https://example.com/audio.wav",
  "width": 1920,
  "height": 200,
  "color": "0x00ff00"
}

curl -X POST https://api.ringbee.dev/v1/audio/waveform \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@audio.mp3" \
  -F "width=1920" \
  -F "height=200" \
  -F "color=0x00ff00"
ParamTypeDescription
widthnumberWaveform image width in pixels
heightnumberWaveform image height in pixels
colorstringWaveform color as hex (e.g., “0x00ff00”)

Authorizations

​
X-API-Key
string
header
required

Body

​
input
string
required

Input file URL

​
width
number

Waveform image width in pixels

​
height
number

Waveform image height in pixels

​
color
string

Waveform color as hex (e.g., "0x00ff00")

​
webhook_url
string

URL to receive job completion notification

Response

Job accepted

​
id
string
Example:

"job_abc123"

​
status
enum<string>
Available options:
pending,
processing,
completed,
failed,
cancelled
Example:

"pending"