{"uid":"cap_iKre_1Q2SO3zNVmSHopOh","slug":"halowerk-waveform-image-generator-5571da88","name":"HALOWERK Waveform Image Generator","description":"Takes an audio or video file (up to 24 MB) and returns its waveform as a PNG image with chosen width, height, wave colour and background colour, mono or one lane per channel, optionally on a logarithmic scale that makes quiet speech visible. Rendered locally with ffmpeg; the image comes back inline as base64 along with duration and size. Nothing leaves this machine. Fixed price per call.","url":"https://medien.halowerk.com/v1/waveform-image?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"color":{"type":"string","default":"#3b82f6","pattern":"^#[0-9a-fA-F]{6}$"},"width":{"type":"integer","default":1200,"maximum":4000,"minimum":100},"height":{"type":"integer","default":200,"maximum":1000,"minimum":40},"source":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"description":"Public http(s) URL of the file."},"filename":{"type":"string","maxLength":260},"content_base64":{"type":"string","maxLength":12000000,"description":"The file inline, base64. Larger files by url."}},"description":"The recording. Either url or content_base64.","additionalProperties":false},"log_scale":{"type":"boolean","default":false},"background":{"type":"string","default":"#ffffff","pattern":"^#[0-9a-fA-F]{6}$"},"split_channels":{"type":"boolean","default":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vv2ID98TteD2xv8Pu_ZUJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts an audio or video file into a waveform PNG image with configurable dimensions, colors, channel splitting, and optional logarithmic scale.","exampleAgentPrompt":"Turn this podcast MP3 into a waveform image — 1200 pixels wide and 200 pixels tall, blue wave (#3b82f6) on a white background, and use logarithmic scale so the quiet parts are still visible. Here's the file URL: https://example.com/episode42.mp3","exampleUseCases":[{"title":"Podcast episode waveform thumbnail","prompt":"Generate a waveform image for my podcast episode at https://cdn.mypodcast.com/ep10.mp3 — make it 1200 wide by 200 tall, use #e11d48 for the wave color and a black background (#000000), and turn on logarithmic scale so the speech doesn't disappear in quiet sections."},{"title":"Stereo music track channel visualization","prompt":"I have a stereo music file at https://audio.myband.com/track01.wav — can you render a waveform PNG showing each channel in its own lane, 1600 pixels wide and 400 tall, green wave (#22c55e) on a dark grey background (#1f2937)?"},{"title":"Video file audio waveform for editing","prompt":"Extract and visualize the audio waveform from this video: https://media.myvideo.com/interview.mp4 — 1200 by 300 pixels, split channels off, default blue wave, white background, no log scale. I want to use the PNG as a timeline reference in my editor."}],"resultDescription":"Returns a base64-encoded PNG image of the audio/video waveform rendered inline, along with the duration of the source media and the dimensions/size of the output image. No external data transfer occurs — all processing is done server-side with ffmpeg.","failureModes":["File exceeds 24 MB limit — request rejected","Invalid hex color format for wave or background color — schema validation error","Source file URL is unreachable or returns non-media content — rendering fails","Audio/video format unsupported by ffmpeg — conversion error","Width or height outside allowed range (100–4000 / 40–1000) — validation error","Both url and content_base64 omitted from source object — missing input error","base64 payload too large (over ~12 MB encoded) — payload size limit hit"],"whenToPreferThis":"Choose this endpoint when you need a locally rendered, privacy-preserving waveform PNG from an audio or video file with precise control over dimensions, colors, channel layout, and scale. Prefer it over client-side or third-party waveform services when data privacy matters, when you need logarithmic scaling for speech content, or when you want a fixed low-cost per-call pricing model with no data leaving the server.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:51.420Z","isFirstParty":false,"canonicalSlug":"halowerk-waveform-image-generator-5571da88"}