Animate an Image

Browse image-to-video effects. Open one to preview the motion and see how to use it with effectId.

Using an effect

The motion does not come from a prompt you write: it comes from a named effect. Same endpoint, different effectId, different motion.

# 1. upload an image — the same three calls as transforming one
#    https://app.piernode.com/uploads/images

# 2. animate it
curl -X POST https://app.piernode.com/api/v1/videos/transformations \
  -H "Authorization: Bearer $PIERNODE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "assetId": "c8f2a1d4e5b64c9a8f3d2e1b0a9c8d7e",
    "effectId": "<effect-id>",
    "durationSeconds": 5
  }'

That returns a task. Video takes minutes rather than seconds — poll it and back off rather than hammering it.

Field	Role
`assetId`	Which image. Reuse one across as many effects as you like.
`effectId`	What happens. Required — see the catalogue.
`resolution`	`hd` or `fhd`. Part of the price.
`durationSeconds`	`5` or `8`. The other part of the price.

An effect may preset any of the last three, and anything you send yourself wins over it. A prompt is optional and is added to the effect's instruction rather than replacing it; if you find yourself writing the whole motion into it, the effect you want is probably a different one.

What a clip costs

Per second of finished video, at one rate per tier — an eight-second clip costs eight times what a second of it does. Ask GET /api/v1/pricing or see pricing.

Using an effect

What a clip costs

See also