# List Motions

`GET /v1/videos/motions`

The curated motion clips for motion transfer on `spicy-animate-1`. No key needed.

Every clip was generated with SpicyAPI video models (no real performer footage): full body, fixed camera, plain studio background, 9:16. Match your performer image to the clip's framing for the best result, then pass the `id` as `motion` on `POST /v1/videos/edits`.

Base URL: `https://api.spicyapi.com`

## Request

```bash
curl --request GET \
  --url https://api.spicyapi.com/v1/videos/motions
```

## Response: 200 application/json

Successful Response

- `data` (Motion · object[], required): The library.
  - `id` (string, required): What you pass as `motion`, `mo_...`.
  - `object` (string, required): Always `motion`.
  - `label` (string, required): Display name.
  - `description` (string, required): What the performer does.
  - `url` (string, required): Preview of the clip.
  - `duration_s` (number, required): Length, which is also the output length.
  - `aspect_ratio` (string, required): Shape of the clip, `9:16`.

```json
{
  "object": "list",
  "data": [
    {
      "object": "motion",
      "id": "mo_slow_sway",
      "label": "Slow sway",
      "description": "A slow, sensual side-to-side sway with the arms loose.",
      "url": "https://cdn.spicyapi.com/examples/motions/mo_slow_sway.mp4",
      "duration_s": 6,
      "aspect_ratio": "9:16"
    },
    {
      "object": "motion",
      "id": "mo_hip_dance",
      "label": "Hip dance",
      "description": "An upbeat dance led by the hips, arms moving with the beat.",
      "url": "https://cdn.spicyapi.com/examples/motions/mo_hip_dance.mp4?v=2",
      "duration_s": 6,
      "aspect_ratio": "9:16"
    }
  ]
}
```