Orbit

OrbitTemplate

Your work wraps a tilted 3D ring that turns slowly through space.

Showreel 3 of 14 · 3 to 18 images or videos

0:00 / 0:00

Settings

Template settings

Specific to this template. Every template also accepts the common settings (aspect ratio, background, corner radius).

Setting	Type	Default	What it does
`scaleIntensity`	number	`1.02`	Overall ring size as a fraction of the canvas.
`tilt`	number	`18`	How far the ring is tipped toward the camera, in degrees (0 = edge-on, 90 = flat circle from above).
`roll`	number	`-17`	Diagonal roll of the whole ring in the frame, in degrees (0 = level).
`perspective`	number	`4`	Perspective strength as a multiple of the ring radius. Lower = more dramatic depth.
`roundness`	number	`10`	How smoothly each image curves along the ring: 1 = flat/faceted, higher bends it into a smooth cylinder. Applies to images in both crop and contain (videos always stay flat).
`gap`	number	`20`	Space between cards around the ring, in pixels (wider = bigger ring, smaller cards).
`spinDuration`	number	`18`	Seconds for one full revolution of the ring.
`revolutions`	number	`1`	How many full turns the ring makes over the clip.
`spinDirection`	enum	`cw`	Which way the ring spins (cw or ccw).One of: `cw`, `ccw`
`depthFade`	number	`0.5`	How much the far/back side of the ring is darkened (0–1).
`mediaFit`	enum	`crop`	How media fills its card: "crop" (cover a fixed slot) or "contain" (letterbox onto the card).One of: `crop`, `contain`
`imagePosition`	number	`0`	Vertical crop anchor 0–100 (0 = top, 50 = center, 100 = bottom). Only applies when mediaFit is "crop".

Request

Example request

A complete, working body for POST /api/v1/render with every default spelled out. Send only the settings you want to change.

POST /api/v1/render — Orbit

{
  "id": "OrbitTemplate",
  "scale": 1,
  "inputProps": {
    "images": [
      "https://picsum.photos/seed/reelfolio1/1280/800",
      "https://picsum.photos/seed/reelfolio2/1280/800",
      "https://picsum.photos/seed/reelfolio3/1280/800"
    ],
    "settings": {
      "backgroundColor": "#06070a",
      "backgroundType": "gradient",
      "backgroundLibraryCategory": "mesh",
      "backgroundLibraryImage": "https://cdn.reelfolio.io/reelfolio-background-library/mesh/mesh-21.webp",
      "blurAmount": 0,
      "backgroundOpacity": 1,
      "backgroundGradientStart": "#111111",
      "backgroundGradientEnd": "#444444",
      "backgroundGradientNoise": 40,
      "borderRadius": 18,
      "aspectRatio": "4:5",
      "cropAspectRatio": "1:1",
      "scaleIntensity": 1.02,
      "tilt": 18,
      "roll": -17,
      "perspective": 4,
      "roundness": 10,
      "gap": 20,
      "spinDuration": 18,
      "revolutions": 1,
      "spinDirection": "cw",
      "depthFade": 0.5,
      "mediaFit": "crop",
      "imagePosition": 0
    }
  }
}