Grain Field
Grain Field is a procedural ShaderWeave generator: describe the look in JSON, choose a seed, and render png, webp, gif, svg. 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.
Grain Field preview
What it gives you.
- Deterministic output — the same recipe, seed and engine version produce byte-identical frames.
- Exports png, webp, gif, svg from one recipe.
- Available in the editor, the REST API, the MCP server and the CLI.
- Tune colors, scale, contrast, dither, speed, loopSeconds with schema-driven controls.
Parameters.
Grain Field exposes these parameters. Every value is validated against the generator’s published JSON schema before a render starts.
- colors
- scale
- contrast
- dither
- speed
- loopSeconds
Formats and credit cost.
- png
- webp
- gif
- svg
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/grain-noise -o grain-noise.mp4The same recipe works through the MCP server and the CLI on paid plans.
Where it works.
Grain and finish passes
Overlay a seeded texture to add analog finish to flat artwork and photography.
Material studies
Render the same texture at several densities for print, web and video use.
Pipeline finishing
Add the texture as a deterministic final step so repeated exports of the same asset stay identical.
Questions.
- How many credits does a Grain Field 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 Grain Field 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 Grain Field from an API or a coding agent?
- Yes. POST /v1/generate/grain-noise 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 Grain Field 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.