Custom sex actions

An action is a ready-made sex act: a short reference clip that fixes the camera angle, framing, pose and motion. Send its id as action to POST https://api.spicyapi.com/v1/videos/generations on spicy-motion-3 or spicy-motion-3-fast, together with an image of the woman, and she performs that act second for second in a realistic clip with native sound. No motion prompt, no first frame in position, no prompt engineering.

There are 64 actions across sex, anal, oral, handjob, cumshot, solo and trans (a trans woman: the penis in the clip is hers). GET https://api.spicyapi.com/v1/videos/actions lists them with a preview clip and a poster each, no key needed; from an age-gated region (AWS us-east-1 and us-east-2 included) send your API key, since keyless calls from there get blurred posters and no clips.

How it works

1. The woman: one of your own generated images (GET /v1/images lists them, or make one with POST /v1/images/generations). She does not need to be in position: the action supplies the pose.
2. The action: pick an id from GET /v1/videos/actions or the table below.
3. The scene (optional): a short prompt with the setting, outfit and lighting. Without one she is in a plain light bedroom.
4. Generate: POST /v1/videos/generations returns a task; poll GET /v1/videos/tasks/{id} every 10 to 15 seconds (or set a webhook) and keep output.video_url.

Every input image must be one of your own outputs from this API; uploads and third-party URLs are rejected before any charge.

Step 1: the woman

A clear, well-lit image of her face and body works best: the model takes her face, hair, skin and figure from it. A three-quarter or full-body shot is better than a tight headshot.

{
  "model": "spicy-image-1-pro",
  "size": "832*1216",
  "prompt": "A photo of a beautiful woman in her late twenties with long wavy dark brown hair, brown eyes and a slim figure, standing in a bedroom in black lace lingerie, looking at the camera with a soft smile, warm window light, three-quarter shot."
}

The image URL is in data[0].url. Keep it: it is the image_url for step 2. reference_image_urls (up to 10 of your images) or a saved character work in its place.

Step 2: the clip

{
  "model": "spicy-motion-3",
  "action": "pov-doggystyle",
  "image_url": "<data[0].url from step 1>",
  "prompt": "hotel room at night, warm lamp light, white sheets, she keeps the black lace stockings on",
  "resolution": "720P"
}

With no prompt at all the same request renders the act in a plain light bedroom:

{
  "model": "spicy-motion-3",
  "action": "pov-blowjob-deepthroat",
  "image_url": "<data[0].url from step 1>",
  "resolution": "1080P"
}

The response is a task with cost_usd already debited. A blocked or failed task is refunded.

Writing the scene prompt

• Describe the scene, not the motion: where they are, what she wears, the light, the mood. The action already fixes the camera, the pose and the rhythm.
• Keep it consistent with the act. A prompt that asks for another position fights the reference clip.
• The prompt is screened like any other before anything is charged.

Options

• aspect_ratio: defaults to the action's own shape (3:4, 9:16 or 1:1). Any ratio the model supports can be requested (16:9, 9:16, 1:1, 4:3, 3:4, 21:9).
• duration: defaults to 8. The reference clip is 4 seconds (5 on two actions); past it the model carries the same act on as one continuous take, with her expressions, hands and pace changing naturally. The clip's seconds plus duration must stay within 30.
• resolution: 480P, 720P (default) or 1080P.
• spicy-motion-3-fast: the same request with a faster turnaround.
• style: an art style from GET https://api.spicyapi.com/v1/styles. Pass anime or cartoon (or 3d) with an image of a woman in that style and she keeps her style through the whole action; without it the photoreal reference clip pulls her toward realistic. Free, same price.
• Not accepted with an action: video_url and last_frame_url.

The actions

Cost

The reference clip's seconds (duration_s in the list, 4 on most actions) are billed as input seconds on top of the output seconds, at the model's per-second rate. An 8 second video therefore bills 12 seconds:

Plus the image of the woman, once: $0.09 on spicy-image-1-pro, reusable for every action. Check live prices on the pricing page, or send dry_run: true for a quote without generating.

Moving from the retired POV models

spicy-pov-missionary-1, spicy-pov-doggystyle-1 and spicy-pov-blowjob-1 were retired on 23 Sep 2026 and answer with a 410. Use spicy-motion-3 with action pov-missionary, pov-doggystyle or pov-blowjob-deepthroat, and pass your image as image_url as before: it is now who she is rather than the first frame, so it no longer needs to be in position.