API & MCP

Everything a person can do on Particle Effect Frame Generator, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

Particle Effect Frame Generator

Set up a seeded particle emitter — shape, rate, burst, lifetime, direction, speed, gravity, wind and drag — and choose how size, color and opacity change over each particle’s life with CSS easing curves. Get a transparent PNG sequence, a contact strip, per-frame particle counts and, for up to 24 drawings, an editable Flipline drawing whose particle layer you can open and draw over.

Inputs of Particle Effect Frame Generator
FieldTypeDefaultDescription
presetselect (custom, embers, snow, burst, smoke, fountain)"embers"Particle preset
widthinteger960Canvas width (px)
heightinteger540Canvas height (px)
fpsinteger12Frame rate (FPS)
framesinteger24Frames
backgroundtext—PNG background HEX (empty = transparent)
shapeselect (point, line, rect, ellipse, ring)"line"Emitter shape
xnumber50Emitter centre X (%)
ynumber92Emitter centre Y (%)
emitterWidthnumber420Emitter width (px)
emitterHeightnumber0Emitter height (px)
anglenumber0Emitter rotation (degrees)
ratenumber30Emission rate (particles per second)
burstinteger0Start burst (particles)
lifenumber1.6Lifetime (seconds)
lifeVarnumber30Lifetime variation (%)
directionnumber90Direction (degrees, 0 = right, 90 = up)
spreadnumber24Spread (degrees)
outwardbooleanfalseThrow particles away from the shape centre
speednumber260Speed (px per second)
speedVarnumber35Speed variation (%)
gravitynumber-60Gravity (px/s², positive = down)
windnumber20Wind (px/s², positive = right)
dragnumber0.6Drag (per second)
sizeStartnumber20Start size (px)
sizeEndnumber4End size (px)
sizeVarnumber30Size variation (%)
sizeEasetext"ease-out"Size easing over life
colorStarttext"#FFD27A"Start color HEX
colorEndtext"#C6452B"End color HEX
colorEasetext"ease-in"Color easing over life
opacityStartnumber95Start opacity (%)
opacityEndnumber0End opacity (%)
opacityEasetext"ease-in"Opacity easing over life
styleselect (dot, glow)"glow"Particle look
seedinteger7Random seed
loopbooleantrueSeamless loop
prewarmnumber0Pre-roll before frame 1 (seconds, no loop)

Example request

Rising embers that loop over 24 drawings

curl -X POST https://fliplineparticleframes.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

{
  "mcpServers": {
    "flipline-particle-frames": { "type": "http", "url": "https://fliplineparticleframes.usefulweb.app/mcp" }
  }
}