API Image to Video
A clean REST API for image to video: predictable JSON, signed webhooks, sandbox keys and the exact cost_usd on every response. Built for developers, from $0.05 per second.
{
"status": "succeeded",
"output": {"video_url":"…/gen_8f3k2m.mp4"},
"cost_usd": 1
}Request, poll, deliver
curl https://api.spicyapi.com/v1/videos/generations \ -H "Authorization: Bearer $SPICYAPI_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "spicy-motion-3", "prompt": "slow push-in, she turns toward the camera", "image_url": "<a URL from /v1/images/generations>", "resolution": "720P", "duration": 5 }'# 202 returns a task id: poll it every 10 to 15 seconds, or take the webhookcurl https://api.spicyapi.com/v1/videos/tasks/<id> \ -H "Authorization: Bearer $SPICYAPI_KEY"
Video models
API image to video examples
Raw outputs, no retouching. Blurred until you confirm you are 18 or older. More on the examples page.
Developer-first API design
Predictable endpoints
Standard HTTP methods, consistent JSON and error messages that name the field at fault.
Webhooks with retries
task.succeeded and task.failed, HMAC-signed, retried for about five hours if your endpoint is down.
Keys per environment
Name a key per app or customer, revoke any key at once, and cap spend with a monthly limit.
Build before you pay
Sandbox keys return fixture output from every endpoint at no cost.
Request log with cost
Every call with its status, latency and cost in the dashboard, filterable by type and status, exportable as CSV.
Node, Python and MCP
The spicyapi package on npm, porn-api on PyPI, plus an MCP server so coding agents can integrate for you.
Pricing
Prepaid credits in USD, spent at each model's rate when a job succeeds. Failed or blocked generations are never billed and the balance never expires. Top up from $50 by card or crypto.
Common questions
How do I call the image to video API?
POST /v1/videos/generations with model, prompt, image_url, resolution and duration. The image_url must be an image your account generated with SpicyAPI. You get a task id back; poll GET /v1/videos/tasks/{id} or receive a webhook.
What platforms is it built for?
AI girlfriend and companion apps, adult content platforms, Telegram and Discord bots, and interactive entertainment.
Is there a sandbox?
Yes. Sandbox keys answer every endpoint with sample output so you can build the full integration before topping up.
What are the rate limits?
There is no fixed cap on video jobs per key. If a model is at capacity the API answers 429 and you retry after a few seconds. Agent tool calls (MCP and /v1/tools) are limited to 60 requests per minute per key.
How am I billed?
Per second of output at the model and resolution rate, from a prepaid balance. The price is debited when the task is created and refunded automatically if the job fails.
Start building with our API
Sign up, grab a sandbox key and wire the whole flow before spending a cent.