Introduction
Motioness is a drop-in image proxy that returns AI-generated motion graphics. Replace any <img> URL and ship a looping mp4 with the same shape and brand.
Motioness
Replace any <img> URL with a Motioness proxy URL and you get a looping mp4 back — same dimensions, same composition, brand-aware motion. No model selection, no prompt engineering, no asset pipeline.
The shortest path is the React component — it ships with hover effects, lazy loading, fallback handling, and signed-URL support out of the box:
tsximport { MotionessImg } from '@motioness/proxy-client/react';<MotionessImg projectKey="pk_abc" src="https://cdn.acme.com/hero.png" motion="medium"/>
The first request enqueues generation and returns a poster jpg immediately. The mp4 lands in 20–60 seconds, then is permanently cached at the edge.
What you get
Three ways to embed
We recommend the React component — it's the most feature-rich surface (effects, lazy loading, callbacks, SSR-safe).
tsximport { MotionessImg } from '@motioness/proxy-client/react';<MotionessImg projectKey="pk_abc" src="https://cdn.acme.com/hero.png" motion="medium"/>
Includes hover effects, loading="lazy", onReady / onError callbacks, signature + exp props for signed URLs, and progressive enhancement.
html<script type="module" src="https://motioness.com/proxy-client/element.js"></script><motioness-img project-key="pk_abc" src="https://cdn.acme.com/hero.png" motion="medium"/>
Same effects as the React binding without React. Drops into any HTML page.
html<video src="https://motioness.com/v1/pk_abc/cdn.acme.com/hero.png.mp4" poster="https://motioness.com/v1/pk_abc/cdn.acme.com/hero.png.jpg" autoplay muted loop playsinline/>
Lowest level. No effects — you wire hover / lazy / fallback yourself. Useful for OG cards, RSS, MDX.
Where to go next
- Quickstart — sign up, create a project, ship your first mp4.
- Proxy URL — what the URL shape means, how caching keys work.
- Allowlist vs signed URLs — pick the right auth model.
- Webhooks — get notified when assets finalize.
- API overview — REST endpoints, OpenAPI spec, auth.