Waveform
Waveform is a procedural ShaderWeave generator: describe the look in JSON, choose a seed, and render png, webp, gif, svg, css. It runs in the browser editor and through the rendering API, so a recipe you tune by hand can be reused in a build step or by a coding agent.
Waveform preview
What it gives you.
- Deterministic output — the same recipe, seed and engine version produce byte-identical frames.
- Exports png, webp, gif, svg, css from one recipe.
- Available in the editor, the REST API, the MCP server and the CLI.
- Tune colors, layers, amplitude, frequency, phaseSpread, speed and more with schema-driven controls.
Parameters.
Waveform exposes these parameters. Every value is validated against the generator’s published JSON schema before a render starts.
- colors
- layers
- amplitude
- frequency
- phaseSpread
- speed
- loopSeconds
- lineWidth
- fill
- background
Formats and credit cost.
- png
- webp
- gif
- svg
- css
Still images cost one credit per output megapixel. Animation costs ten credits per megapixel per second. SVG and CSS output costs one credit.
| Example output | Credits |
|---|---|
| Full HD image · PNG | 3 |
| Full HD loop · MP4 · 6 seconds | 125 |
Call it from an API.
curl -s -H "Authorization: Bearer $SHADERWEAVE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"seed":42,"format":"mp4","size":{"width":1920,"height":1080},"params":{"loopSeconds":6}}' \
https://shaderweave.com/v1/generate/waveform -o waveform.mp4The same recipe works through the MCP server and the CLI on paid plans.
Where it works.
Marks and decorative forms
Vector-friendly shapes scale cleanly from favicons to billboards without resampling artifacts.
Layout accents
Use the shape as a masked accent behind headings, quotes or statistics.
Deterministic series
Re-run the same recipe later and get the identical form, which keeps a design system stable over time.
Questions.
- How many credits does a Waveform render cost?
- Stills cost one credit per output megapixel and animations cost ten credits per megapixel per second. Full HD image · PNG is 3 credits; Full HD loop · MP4 · 6 seconds is 125 credits.
- Can I use Waveform output commercially?
- Yes, on a paid plan. Free-plan exports are for evaluation and non-commercial use, and the free plan does not include API access.
- Can I call Waveform from an API or a coding agent?
- Yes. POST /v1/generate/waveform with a bearer API key renders synchronously, POST /v1/jobs queues an animation, and the MCP server exposes the same generator to coding agents. API access requires a paid plan.
- Is Waveform output reproducible?
- Yes. A render is a pure function of the generator, its parameters, the seed and the engine version, so re-running the same recipe returns the same frames later.