nsfw-video-generation

Imported from Wayfinity/spicyapi-skills (skills/nsfw-video-generation/SKILL.md). Install upstream with npx skills add Wayfinity/spicyapi-skills --skill nsfw-video-generation. Copyright stays with the author (MIT).

NSFW Video Generation

When to use

The user wants adult video content generated programmatically: from a text prompt, or by animating a still. Spicy API (spicyapi.com) is a paid, pay-per-generation API with moderation before billing; the account owner approves every spend.

Golden path

1. read_acceptable_use once: adults only, no real people (with or without consent), no minors in any form. The user's product must age-gate its users.
2. get_account for the balance, then list_models with kind video. Text-to-video: spicy-motion-3 (480P to 1080P, 2 to 30 seconds, dialogue and sound, aspect_ratio up to 21:9 or model-chosen when omitted), spicy-motion-3-fast, spicy-video-1 (16:9 default), or spicy-cinema-1 (cinematic camera work with native audio, 3 to 15 seconds, nine aspect ratios, the lowest per-second price at 480P). Image-to-video: spicy-motion-3 for the best quality with native sound (first frame via image_url), spicy-motion-3-fast when speed matters, spicy-cinema-1-image, spicy-motion-2 for lip-sync to driving audio, and spicy-motion-draft-1 for cheap silent previews. Sex acts: spicy-motion-3 with action, one of 64 ready-made sex acts from list_actions (missionary, doggystyle, cowgirl, blowjob, anal, cumshots and more); image_url is the woman who performs it (not a first frame), prompt optionally sets the scene, and the action's short reference clip (4 seconds on most) is billed as input seconds on top of the output (an 8 second 720P clip is $2.40). Guide: https://www.spicyapi.com/docs/pov-video. The same person from references: spicy-character-video-1 or spicy-cinema-1-character (up to 9 references named Image 1, Image 2 in the prompt). Input images must be the account's own generated images (list_images or generate_image); uploads and third-party URLs are rejected before any charge. Prompts are capped per model (limits.maxPromptChars).
3. estimate_cost with model, resolution and duration. A five-second 720P clip on spicy-motion-2 is $1.00; the same preview on spicy-motion-draft-1 is $0.25; a ten-second 720P clip on spicy-motion-3 is $2.00, and a video_url clip sent to it is billed on top at the same rate. Say the number. duration: -1 on spicy-motion-3 lets the model pick the length: quote the maximum (30 seconds, less any input clip); the task settles to the rendered length and refunds the rest.
4. generate_video (guarded): without approval_token it returns approval_required with the cost; show it, get the user's yes, call again with the token. The price is debited when the task is accepted and refunded if it fails.
5. get_job every 10 to 15 seconds until status is succeeded (output.video_url, a durable CDN URL) or failed (already refunded). A webhook URL set in the dashboard replaces polling.
6. 402 means the balance ran out: get_topup_link returns a checkout URL for the user to pay in the browser (minimum $50). Never handle payment details.

Without MCP: plain REST

curl https://api.spicyapi.com/v1/videos/generations \
  -H "Authorization: Bearer $SPICYAPI_KEY" -H "Content-Type: application/json" \
  -d '{"model": "spicy-motion-2", "prompt": "slow build, steady rhythm", "image_url": "<a URL from /v1/images/generations>", "resolution": "720P", "duration": 5}'
# 202 {"id": "sj_...", "status": "queued", "cost_usd": 1.00} then poll every 10 to 15 seconds:
curl https://api.spicyapi.com/v1/videos/tasks/sj_... -H "Authorization: Bearer $SPICYAPI_KEY"

Then GET https://api.spicyapi.com/v1/videos/tasks/{id}. Errors are OpenAI-shaped: 401 bad key, 402 balance, 422 prompt blocked (never charged), 429 at capacity.

Prompting

Describe the subject, the setting, the lighting, the movement and the camera; the models are tuned for explicit content between adults and do not need euphemism. Keep clips short (5 to 10 seconds) and chain them from a consistent first frame rather than asking for one long take. Iterate on spicy-motion-draft-1 (silent, a quarter of the price) until the motion is right, then render the keeper on spicy-motion-2 or spicy-motion-3. negative_prompt is ignored on spicy-motion-3 and the spicy-cinema-1 family.

More control over the clip

• last_frame_url (with image_url): a closing frame the clip travels to. spicy-motion-2, spicy-motion-3.
• action (spicy-motion-3, spicy-motion-3-fast): a ready-made sex act from list_actions; the clip supplies camera, pose and motion, image_url (or references or a character) the woman, prompt the scene (optional; a plain light bedroom without it). duration defaults to 8, aspect_ratio to the action's shape; not with video_url or last_frame_url.
• style (every video model): an art style from list_styles (photorealistic, studio, anime, 3d, cartoon) for the whole clip, matched to the first frame or references; with action it keeps an anime or cartoon woman in her style. Free, same price.
• fps: 60 (every video model, default 30): frame interpolation to 60 fps for smoother motion, audio kept, for 20% of the video's price on top (input and action clip seconds included); about a minute longer. If that step fails the 30 fps clip is delivered and the fee refunded (usage.fps says 30). estimate_cost takes fps too.
• reference_image_urls (up to 10, exclusive with image_url): identity and look without fixing the first shot. spicy-character-video-1, spicy-motion-3, spicy-motion-3-fast.
• video_url (one of the account's own finished clips): spicy-motion-2 continues it in place of image_url (2 to 10 s in; duration is the whole output, billed in full). spicy-motion-3 extends or edits it (15 s max; clip plus duration within 30 s).
• audio_url: a clip from upload_audio (guarded, $0.01) or a line from generate_speech (see the nsfw-voice-generation skill); reference the returned url exactly, 2 to 30 seconds. What it does depends on the model, see below.
• A finished clip can be changed afterwards (outfit, style, lighting) or its moves put on another person with edit_video: see the edit-video-and-transfer-motion skill.

Driving audio vs reference audio

audio_url does two different things, and list_models says which under inputs.audio.mode. Driving audio (spicy-motion-2, spicy-video-1): the clip is the soundtrack and the mouth follows it, one clip, alongside a first frame where the model takes one. Reference audio (spicy-motion-3, spicy-motion-3-fast): the model generates its own sound and uses the clip for voice, tone and beat while the words come from the prompt; up to 5 clips (15 s total) in audio_urls, only with a text prompt or references. On spicy-motion-3 a first frame (image_url) pairs only with last_frame_url: no references, clip or audio in the same request; for lip-sync from a first frame use driving audio on spicy-motion-2. spicy-motion-1 and spicy-character-video-1 take no audio. Pass audio_mode (driving or reference) to assert what you expect; a mismatch is rejected naming a model that offers it. Read inputs.combinations before calling; an invalid mix is rejected locally with those sentences quoted, before any spend.

Video models

Tools used by this skill

• list_models: Every model with its kind (image, image-edit, video, video-edit, chat, speech, realtime, transcription, embedding), USD price (per image, per second by resolution or quality, per 1M tokens, per 10,000 characters of speech input, or per minute of audio), limits (image sizes, outputs per call, resolutions, clip lengths, aspect ratios, prompt character caps), whether it needs or accepts an input image or references, and example clips. Video rows carry inputs: which of first frame, last frame, reference images, clip and audio the model takes, inputs.audio.mode (driving: the clip is the soundtrack and the mouth follows it; reference: the model generates sound and uses the clip for voice, tone and beat; none) and inputs.combinations, the valid input combinations in plain sentences. Read those before generate_video. silent: true marks a video model that renders without sound; bills_input_video_seconds: true one that also bills the seconds of an input clip. Video-edit rows carry video_edit (instruction or motion mode, clip lengths, reference images, whether input seconds are billed) for edit_video. Speech rows carry speech: preset voices, whether instructions are accepted, custom voices, languages, inline tags and voice creation fees. Realtime rows (spicy-live-1) are live voice calls over a WebSocket: a server or app opens a session with POST /v1/realtime/sessions and connects the returned ticket URL; they cannot be driven from a tool call. Prices here are exactly what the API bills. Works with a $0 balance. Arguments: kind?: image | image-edit | video | video-edit | chat | speech | realtime | transcription | embedding (Filter by kind.).
• estimate_cost: USD cost of a request before making it, from the same price table the gateway bills: images by count, video by seconds and resolution (plus the input clip or action clip on models that bill it), video edits by clip length (input plus output seconds for instruction edits, output seconds for motion transfer), chat by tokens, speech by characters of input (plus instructions), transcription by seconds of audio, embeddings by tokens, live calls by minutes. Use it to quote the user and to check against get_account before a spend. Works with a $0 balance. Arguments: model: string (A model id from list_models, e.g. spicy-image-1, spicy-image-1-pro, spicy-image-photo-1.); n?: integer (Images per call (image models), clamped to the model's maximum.); resolution?: string (Video or video-edit resolution, e.g. 720P (default) or 1080P.); quality?: standard | pro (Motion transfer tier on spicy-animate-1, default standard.); duration?: integer (Video seconds, default 5; -1 for a model-chosen length where supported.); input_seconds?: number (Length of the input clip in seconds: the clip to edit or motion clip on video-edit models (default 5), or a video_url on video models that bill input seconds.); motion?: string (A library motion id (list_motions) on spicy-animate-1; its length sets the output length.); action?: string (An action id (list_actions) on spicy-motion-3 and -fast: its reference clip seconds (4 on most) are billed as input, and duration defaults to 8.); fps?: any (Video frame rate: 30 (default) or 60. 60 smooths motion with frame interpolation for 20% on top of the video price (input or action clip seconds included); audio is kept. If that step fails the 30 fps clip is delivered and the fee refunded.); tokens?: integer (Chat: total tokens, default 1000. Embeddings: text tokens, default 1000.); image_tokens?: integer (Embeddings on spicy-embed-vision-1: image tokens, default 0.); characters?: integer (Speech models: characters of input plus instructions (CJK ideographs and inline tags count too), default 100.); audio_seconds?: number (Transcription: seconds of audio, default 60.); minutes?: number (Live calls (spicy-live-1): minutes of conversation, default 1.); count?: integer (How many such requests, default 1.).
• get_account: Balance in USD, spend this calendar month, the monthly spend limit if set, whether approvals are skipped for agents, whether the account has ever topped up, the webhook URL, and whether this key is a sandbox key. Call it first and before any spend. Arguments: no arguments.
• list_images: The account's generated images, newest first. These are the only URLs accepted as image inputs by edit_image, generate_video, edit_video and create_embeddings (no uploads, no third-party URLs). Use it to pick a first frame to animate or a performer for motion transfer. Arguments: limit?: integer (Default 20.).
• list_characters: The account's saved characters: reusable identities built from its own generated images. Pass a character id as character to generate_image, edit_image or generate_video to get the same person again across images, edits and video. No uploads are involved; a character can only be made from images this account generated. The exception is imported: true characters: a registered business can apply in the dashboard (Settings, Character import: https://www.spicyapi.com/dashboard/import) to bring its own platform's existing AI-generated characters over with POST /v1/characters/import. There is no tool for importing, and an agent cannot apply for the user. One with status: "under_review" cannot be used until a person approves it. Arguments: no arguments.
• create_character (guarded): Save a reusable identity from 1 to 3 of the account's own generated images of the same person (list_images or a generate_image result). Renders one neutral reference sheet (billed as one image edit) and returns the character id to pass as character elsewhere. Up to 50 per account. Guarded: without approval_token it returns {error: "approval_required", summary, approval_token}; show the summary (it carries the cost), get the user's yes, call again with the token. Arguments: name: string (A label, e.g. Mara.); image_urls: array (Generated images of the same person, from this account.); approval_token?: string (Approval token from a previous approval_required response, after the user said yes.).
• generate_image (guarded): Text to image, synchronous (10 to 30 seconds), returns durable CDN URLs reusable as image_url for edits and video. Or an image action: model spicy-image-action-1 with an action from list_image_actions and image_url of the woman (one of list_images) puts her face, hair and skin tone into that ready-made explicit scene, no prompt (a minute or two); style studio gives the finished picture a warm glamour colour grade, and anime, 3d or cartoon put her into the drawn version of the scene, for a drawn woman. Or a reference: model spicy-image-reference-1 (businesses approved for character import only) with reference_image (a picture the user supplies, https or data URL) recreates it as new people, every face replaced, body and outfit changed a little, room redesigned, and returns its description to reuse as a prompt (30 to 60 seconds, one image). One to six images per call, billed per image at the model's rate; the exact amount is cost_usd in the result. Prompts are screened first and outputs after (withheld images are refunded and counted in withheld); blocked prompts cost nothing. Every request depicts adults only. Guarded: without approval_token it returns {error: "approval_required", summary, approval_token}; show the summary (it carries the cost), get the user's yes, call again with the token. Arguments: model: string (An image model id: spicy-image-1 (fast), spicy-image-1-pro (best prompt adherence), spicy-image-photo-1 (candid natural-light photo look), spicy-image-action-1 (image actions only) or spicy-image-reference-1 (reference_image only; businesses approved for character import).); prompt?: string (What to generate, up to 2000 characters. Required, except with action or reference_image where it is not accepted.); reference_image?: string (On spicy-image-reference-1 only, and required there: the picture to recreate as new people, a public https URL or a data URL (JPEG, PNG or WebP). No prompt, size, style, character or enhance_prompt; n is 1. Pictures of anyone who may be under 18 or of known people are refused at no charge.); action?: string (An image action id from list_image_actions, on spicy-image-action-1 only, e.g. pov-missionary: the still sets the act, pose, room and shape; image_url (or character) supplies the woman's face, hair and skin tone. No prompt, negative_prompt, size or enhance_prompt. Her body stays the still's. style studio adds a warm glamour colour grade to the result; anime, 3d or cartoon picks the drawn version of the still (see styles in list_image_actions); match it to her image.); image_url?: string (With action: the woman, one of this account's own generated images (list_images). Photo women take no style (or studio); anime, 3D or cartoon women take the matching style.); negative_prompt?: string; size?: string (widthheight from the model's limits.sizes, one price per model whatever the size: 10241024, 8321216, 1216832, 12801280, 14401440, 10241536, 15361024, 10801920, 19201080, 11522048, 20481152. Default 1024*1024.); n?: integer (Images to return, 1 to 6, default 1. Billed per image delivered.); seed?: integer; enhance_prompt?: boolean (Let the model expand the prompt with lighting, camera and detail cues. Default false: the prompt goes as written.); enhance_mode?: direct | agent (With enhance_prompt: direct (default) rewrites once, agent plans the shot then writes.); character?: string (A saved character id (list_characters): the same person is rendered in the new scene, billed at the image-edit rate.); style?: photorealistic | studio | anime | 3d | cartoon (Art style (list_styles): photorealistic, studio (glossy glamour), anime, 3d (animated-film CGI) or cartoon (2D adult cartoon). Prompt text only, same price.); approval_token?: string (Approval token from a previous approval_required response, after the user said yes.).
• generate_video (guarded): Image to video, text to video or references to video. Asynchronous: returns a task id at once with the price already debited; poll get_job every 10 to 15 seconds until succeeded (output.video_url, usage.output_seconds) or failed (refunded). Every input must be the account's own: images from list_images, clips from its own finished tasks (video_url), audio from upload_audio or generate_speech. Price = seconds x the per-second rate for the resolution; models with bills_input_video_seconds (spicy-motion-3, -fast) also bill the seconds of a video_url clip or of an action clip. duration -1 on spicy-motion-3 lets the model pick the length, debited at the maximum and refunded down to what is rendered. Text to video: spicy-motion-3, -fast, spicy-video-1, spicy-cinema-1. Image to video: spicy-motion-2, spicy-cinema-1-image, spicy-motion-3. Character or references to video: spicy-character-video-1, spicy-cinema-1-character (up to 9 references named Image 1, Image 2 in the prompt), spicy-motion-3. Cheap previews: spicy-motion-draft-1 is a silent draft tier from a first frame; render the keeper on spicy-motion-2 or 3. The spicy-cinema-1 family runs 3 to 15 seconds at 480P to 1080P with native audio always on, no negative_prompt, no enhance_prompt and no audio inputs. Which inputs may travel together differs per model: read list_models inputs.combinations first. Audio comes in two modes (inputs.audio.mode): driving (spicy-motion-2, spicy-video-1: the clip is the soundtrack, the mouth follows it, works with a first frame) and reference (spicy-motion-3, spicy-motion-3-fast: the model generates sound and uses the clip for voice, tone and beat; only with a text prompt or references, never with a first frame). An invalid combination is rejected here before any spend with the valid combinations spelled out. Actions (spicy-motion-3, -fast): pass an action id from list_actions and its reference clip of that sex act supplies the camera, pose and motion second for second while image_url supplies the woman, e.g. {model: "spicy-motion-3", action: "pov-missionary", image_url: , prompt: "hotel room at night, red lingerie"}. To change a finished clip or transfer motion onto a person, use edit_video. Guarded: without approval_token it returns {error: "approval_required", summary, approval_token}; show the summary (it carries the cost), get the user's yes, call again with the token. Arguments: model: string (A video model id, e.g. spicy-motion-2, spicy-motion-3, spicy-cinema-1, spicy-motion-draft-1.); prompt?: string (What should happen in the clip; required unless image_url or action is sent. With action it is only the scene (setting, outfit, lighting, extra direction). Capped per model (limits.maxPromptChars: 1500 on spicy-motion-1 and spicy-motion-draft-1, 20000 on spicy-motion-3 and -fast, 5000 on the rest).); image_url?: string (First frame, from list_images or a generate_image result. list_models inputs.first_frame says whether it is required, optional or not taken. Not with reference_image_urls; on spicy-motion-3 a first frame pairs only with last_frame_url.); last_frame_url?: string (Closing frame (one of the account's images); the clip travels from image_url to it. Models with inputs.last_frame true; needs image_url (or a continuation video_url).); reference_image_urls?: array (Up to inputs.reference_images of the account's images guiding identity and look without fixing the first shot (a character counts as one). Exclusive with image_url. See inputs.combinations.); video_url?: string (output.video_url of one of the account's own finished tasks. inputs.continuation_clip (spicy-motion-2): continues the clip in place of image_url (2 to 10 s in; duration is the whole output incl. the clip, billed in full). inputs.reference_video (spicy-motion-3, -fast): reference clip to extend or edit (15 s max; clip plus duration within 30 s), never with image_url.); audio_url?: string (A clip from upload_audio or generate_speech (its url, exact; 2 to 30 seconds). What it does depends on inputs.audio.mode: driving (spicy-motion-2, spicy-video-1) makes it the soundtrack with the mouth following it, and works with a first frame; reference (spicy-motion-3, -fast) guides voice, tone and beat while the model generates the sound, and only goes with a text prompt or references, never with image_url. Rejected on models with mode none (spicy-motion-1, spicy-character-video-1).); audio_urls?: array (Several upload_audio clips, up to inputs.audio.max_clips (5 on spicy-motion-3 and -fast, 15 s total); other models take a single audio_url.); audio_mode?: driving | reference (Optional guard: what you expect the audio to do. Must equal the model's inputs.audio.mode or the call is rejected naming a model that offers it. Omit to use the model's mode.); resolution?: string (480P, 720P (default) or 1080P, within the model's limits.resolutions.); duration?: integer (Seconds, default 5 (8 with action), within the model's limits (2 to 30; 3 to 15 on the spicy-cinema-1 family). -1 where inputs.smart_duration is true (spicy-motion-3, -fast): the model chooses; debited at the maximum, settled to the rendered length.); aspect_ratio?: string (Text-to-video, references and action only (no first frame or video_url), where inputs.aspect_ratio is true; values in limits.aspectRatios. 16:9, 9:16, 1:1, 4:3, 3:4 on spicy-video-1 (default 16:9); plus 21:9 on spicy-motion-3 and -fast, where omitting it lets the model choose; plus 4:5, 5:4 and 9:21 on spicy-cinema-1 and spicy-cinema-1-character.); negative_prompt?: string (What to avoid. Ignored on spicy-motion-3, spicy-motion-3-fast and the spicy-cinema-1 family.); enhance_prompt?: boolean (Let the model expand the prompt with lighting, camera and detail cues. Default false. Not on the spicy-cinema-1 family.); audio?: boolean (Generate audio where the model supports it. spicy-motion-draft-1 is always silent; the spicy-cinema-1 family always has audio.); seed?: integer; character?: string (A saved character id (list_characters). Only on models that take references: spicy-character-video-1 (no first frame needed), spicy-cinema-1-character, spicy-motion-3, spicy-motion-3-fast.); action?: string (An action id from list_actions, e.g. pov-missionary. Runs on spicy-motion-3 and spicy-motion-3-fast: the action's reference clip sets camera, pose and motion; image_url becomes the woman (her identity, not a first frame) and prompt is optional, only the scene. Not with video_url or last_frame_url. duration defaults to 8 and aspect_ratio to the action's own (any supported ratio may be requested); clip plus duration within 30 s. The clip's seconds are billed as input seconds on top of the output.); style?: photorealistic | studio | anime | 3d | cartoon (Art style (list_styles): photorealistic, studio (glossy glamour), anime, 3d (animated-film CGI) or cartoon (2D adult cartoon). Prompt text only, same price.); fps?: any (Video frame rate: 30 (default) or 60. 60 smooths motion with frame interpolation for 20% on top of the video price (input or action clip seconds included); audio is kept. If that step fails the 30 fps clip is delivered and the fee refunded.); approval_token?: string (Approval token from a previous approval_required response, after the user said yes.).
• edit_video (guarded): Change a finished clip, or make a person perform a motion. Asynchronous like generate_video: returns a task with the price debited; poll get_job every 10 to 15 seconds (refunded if it fails). Instruction edits (spicy-video-edit-1: 2 to 10 second clips, output the clip's length; spicy-cinema-1-edit: 3 to 30 second clips, the first 15 seconds are edited and returned): video_url (one of the account's finished video outputs) plus a prompt describing the change, optionally reference_image_urls for an outfit, prop or style (the account's own images), keep_audio to keep the soundtrack. Billed per second of input plus output at the resolution's rate, debited at the clip's length and settled to what is rendered. Motion transfer (spicy-animate-1): image_url (the performer, one of the account's images, full body and dressed works best) plus a motion id from list_motions or a video_url of the account's own clip (2 to 30 s); the output is as long as the motion clip, billed per output second by quality. Motion transfer refuses explicit or nude images and clips (refunded, error_code blocked). Guarded: without approval_token it returns {error: "approval_required", summary, approval_token}; show the summary (it carries the cost), get the user's yes, call again with the token. Arguments: model: string (A video-edit model id: spicy-video-edit-1, spicy-cinema-1-edit or spicy-animate-1.); video_url?: string (The clip: output.video_url of one of the account's finished video tasks. Required for instruction edits; on spicy-animate-1 an alternative to motion.); prompt?: string (Instruction edits (required): the change to make, up to 5000 characters. Not needed for motion transfer.); reference_image_urls?: array (Instruction edits: outfit, prop or style images from list_images, up to 4 on spicy-video-edit-1 and 5 on spicy-cinema-1-edit.); resolution?: 720P | 1080P (Instruction edits: 720P (default) or 1080P.); aspect_ratio?: string (spicy-video-edit-1 only: reshape to 16:9, 9:16, 1:1, 4:3 or 3:4.); keep_audio?: boolean (Instruction edits: true keeps the clip's original soundtrack.); negative_prompt?: string; seed?: integer; enhance_prompt?: boolean (spicy-video-edit-1 only: let the model expand the prompt.); image_url?: string (spicy-animate-1 (required): the person who performs the motion, one of the account's images.); motion?: string (spicy-animate-1: a library motion id from list_motions, e.g. mo_hip_dance. Send this or video_url.); quality?: standard | pro (spicy-animate-1: standard (default) or pro, priced separately.); user?: string (Your own id for the end user making this request.); approval_token?: string (Approval token from a previous approval_required response, after the user said yes.).
• list_actions: The action library for generate_video with action (spicy-motion-3 and spicy-motion-3-fast): id, label, category (sex, anal, oral, handjob, cumshot, solo, trans), url (the reference clip, 4 to 6 seconds), preview_url (the full 8 second action), poster_url, duration_s (the reference clip's length) and aspect_ratio. The clip supplies the camera, pose and motion of one sex act; the output runs 8 seconds by default and carries the act on past the clip. The caller's image supplies the woman. Every clip was generated with SpicyAPI video models (no real performer footage). Its seconds are billed as input seconds. Works with a $0 balance. Arguments: no arguments.
• list_styles: The art styles for style on generate_image and generate_video: id, label, description and preview_url (a sample image). photorealistic, studio (glossy glamour), anime, 3d (animated-film CGI) and cartoon (2D adult cartoon). A style only adds prompt text, so the model, seed and price are unchanged. Works with a $0 balance. Arguments: no arguments.
• upload_audio (guarded): Bring in a WAV or MP3 (2 to 30 seconds, 15 MB max) from a public https URL for lip-sync and audio-driven video. The clip is transcribed and the transcript screened like a prompt; flat $0.01 for that screening. A clip that fails the screen is discarded with the same 422 shape as a blocked prompt; a 503 means screening was unavailable and nothing was charged. The returned url is what audio_url and audio_urls on generate_video accept; external audio URLs are rejected there. Guarded: without approval_token it returns {error: "approval_required", summary, approval_token}; show the summary (it carries the cost), get the user's yes, call again with the token. Arguments: url: string (Public https URL of the WAV or MP3 to fetch (private and plain-IP hosts are refused).); approval_token?: string (Approval token from a previous approval_required response, after the user said yes.).
• list_audio: The account's audio clips, newest first: uploads and generated speech (source upload or speech), with id, url, duration_s, mime and transcript. These urls are the only values generate_video accepts as audio_url or in audio_urls. Arguments: limit?: integer (Default 20.).
• get_job: Status of a video task from generate_video or edit_video (queued, processing, finalizing, succeeded with output.video_url and usage, or failed and refunded) or of a logged image, chat, speech, transcription or embedding request by id. Arguments: id: string (Task or request id, e.g. sj_...).
• get_topup_link: Checkout URL to add funds by card (hosted checkout) or crypto for a preset amount ($50, $100, $250, $500, $1000; minimum $50). The USER opens it and pays in the browser; never enter payment details yourself. The balance is credited by the payment webhook; call get_account afterwards. If it returns commitment_required, the user must first sign the one-page Customer Commitment Letter on the Billing page; an agent cannot sign it. Works with a $0 balance. Arguments: amount_usd?: integer (One of 50, 100, 250, 500, 1000. Default 50.); method?: card | crypto (Default card.).
• read_acceptable_use: The acceptable use policy as markdown: prohibited content (minors in any form, images or video of real people with or without consent, non-consensual scenarios and the rest), age-verification duties for the customer's product, enforcement. Read it before the first generation and tell the user what their product must do. Works with a $0 balance. Arguments: no arguments.

Setup (once per user)

1. Key: the user signs in once at https://www.spicyapi.com/auth (Google or email). The account is live at once with a $0 balance and a Default key shown once at https://www.spicyapi.com/dashboard/api-keys. Keep the key in an environment variable (SPICYAPI_KEY), never in chat, never in client-side code. With one key you can mint more with create_api_key.
2. Connect. MCP (Streamable HTTP): https://www.spicyapi.com/api/mcp with header Authorization: Bearer <key>. Claude Code: claude mcp add --transport http spicyapi https://www.spicyapi.com/api/mcp --header "Authorization: Bearer sk-spicy-...". Cursor, Codex and any URL-plus-headers client: same URL and header. REST instead of MCP: POST https://www.spicyapi.com/api/v1/tools/<tool_name> with the same header and a JSON body of arguments; GET https://www.spicyapi.com/api/v1/tools lists them; OpenAPI 3.1 at https://www.spicyapi.com/openapi.json. OAuth 2.1 clients (Claude custom connectors, ChatGPT, directory scanners) need only the URL: the endpoint advertises its authorization server, the user signs in and consents in the browser, and the token it returns is an API key they can revoke in the dashboard.
3. Dry run first: a key created with Sandbox ticked (or create_api_key with sandbox: true) answers every endpoint and every tool from fixture output flagged sandbox: true, needs no balance and bills nothing. Build against it, then swap the key. Never present sandbox output to the user as a real generation.
4. Money: get_account shows the balance; estimate_cost prices a request from the same table the API bills; get_topup_link returns a card or crypto checkout URL (presets $50, $100, $250, $500, $1000, minimum $50) that the USER opens and pays in the browser. Never enter card details yourself. A 402 means the balance ran out or the monthly limit was hit.
5. Rate limit: 60 requests per minute per key on the agent surfaces.

Rules that always apply

• Guarded tools (generate_image, edit_image, generate_video, edit_video, transcribe_audio, create_embeddings, upload_audio, delete_audio, generate_speech, create_voice, delete_voice, create_character, delete_character, create_api_key, revoke_api_key, and set_spend_limit when raising or removing a limit) first return {error: "approval_required", summary, approval_token}. Show the summary to the user verbatim (it carries the cost), get an explicit yes in the conversation, then call the tool again with the same arguments plus approval_token (15-minute expiry, bound to those exact arguments). Never approve in bulk or reuse a token for a different action. The account can turn approvals off in the dashboard; moderation, provenance and the spend limit still apply.
• Input images for edit_image, generate_video, edit_video and create_embeddings must be images this account generated (list_images); input clips (video_url) must be the account's own finished tasks. Uploads and third-party URLs are rejected before any charge; do not try to work around it. The external inputs are audio: upload_audio takes a WAV or MP3 (2 to 30 seconds) from a public URL, transcribes and screens it for $0.01, and its returned url, or the url of a generate_speech clip, is what audio_url accepts; transcribe_audio reads any public audio URL into text.
• The same person across many outputs: create_character from 1 to 3 generated images of them, then pass the returned id as character to generate_image, edit_image or generate_video (spicy-character-video-1 needs no first frame). This is the supported way to get consistency; never ask the user for a photo.
• Read read_acceptable_use before the first generation: adults only, no minors in any form (including "young-looking" or youth-coded content), no images or video of real people (with or without consent; voice clones need the speaker's written consent), no non-consensual scenarios. Blocked prompts return 422 and cost nothing; repeated attempts terminate the account. Tell the user their product must age-verify its end users and disclose that content is AI-generated.
• When the user's product serves other people, pass each person's own stable id as user on every call. Screening history, strikes and suspensions then apply to that one person (403 end_user_suspended) instead of the whole account, and the id is kept with each generation's record, so a report about one person's output is traced to them and not to everyone on the account.
• Everything is scoped to the account behind the key; there is no way to read another account's data.
• Spicy API is spicyapi.com. spicyapi.ai is an unrelated aggregator; do not mix their prices or models.

Prices (USD, for when the user asks)

Public docs: https://www.spicyapi.com/docs (every page is also available as markdown by appending .md). Product overview for agents: https://www.spicyapi.com/llms.txt