# List Actions

`GET /v1/videos/actions`

The ready-made sex acts for `action` on `spicy-motion-3` and `spicy-motion-3-fast`. No key needed.

64 reference clips, 4 seconds each (5 on two actions), in the categories sex, anal, oral, handjob, cumshot and solo. Every clip was generated with SpicyAPI video models (no real performer footage). Pass the `id` as `action` on `POST /v1/videos/generations` together with an `image_url` of the woman: the clip supplies camera angle, framing, pose and motion, your image supplies who she is, and an optional `prompt` sets the scene.
The clip's seconds (`duration_s`) are billed as input seconds on top of the output seconds at the model's per-second rate; the output defaults to 8 seconds. `preview_url` is the full 8 second act for showing it, `poster_url` a still for pickers.

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

## Request

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

## Response: 200 application/json

Successful Response

- `data` (Action · object[], required): The library.
  - `id` (string, required): What you pass as `action`.
  - `object` (string, required): Always `action`.
  - `label` (string, required): Display name.
  - `category` (string, required): `sex`, `anal`, `oral`, `handjob`, `cumshot` or `solo`.
  - `url` (string, required): Preview of the reference clip.
  - `poster_url` (string, required): A still of the clip.
  - `duration_s` (number, required): Length of the reference clip (`url`), billed as input seconds. The output defaults to 8 seconds.
  - `preview_url` (string, required): The full 8 second act, for showing the action. Never sent upstream or billed.
  - `aspect_ratio` (string, required): Shape of the clip (`3:4`, `9:16` or `1:1`), the default output shape.

```json
{
  "object": "list",
  "data": [
    {
      "object": "action",
      "id": "pov-missionary",
      "label": "POV missionary",
      "category": "sex",
      "url": "https://cdn.spicyapi.com/actions/pov-missionary-ref4-cccec46a.mp4",
      "preview_url": "https://cdn.spicyapi.com/actions/pov-missionary-88bb7889.mp4",
      "poster_url": "https://cdn.spicyapi.com/actions/pov-missionary-3a8b5ca1.webp",
      "duration_s": 4,
      "aspect_ratio": "3:4"
    },
    {
      "object": "action",
      "id": "pov-missionary-legs-wide",
      "label": "POV missionary, legs wide",
      "category": "sex",
      "url": "https://cdn.spicyapi.com/actions/pov-missionary-legs-wide-ref4-88d9b0e7.mp4",
      "preview_url": "https://cdn.spicyapi.com/actions/pov-missionary-legs-wide-b2020f7c.mp4",
      "poster_url": "https://cdn.spicyapi.com/actions/pov-missionary-legs-wide-43aa1d53.webp",
      "duration_s": 4,
      "aspect_ratio": "9:16"
    }
  ]
}
```