Video technical docs
Endpoint, auth header, parameters, prices, and tested request examples for Imole Video.
Endpoint and pricing
Request headers
Bearer Imole API key.
Use application/json for JSON requests.
Request parameters
Use imole-video.
Scene, action, motion, camera movement, and positive constraints. Use the shared structured prompt format, including time-coded [Shot Details] blocks.
Unwanted visual or motion elements. Put subtitles, text, logos, watermarks, defects, and forbidden camera behavior here instead of the main prompt.
Video workflow mode.
auto, t2v, i2v, flf2vPreset format and aspect ratio.
landscape, portrait, square, hd, classic, vertical, wideRequested duration in seconds.
1-15Input image URL for image-to-video.
Final frame URL for first-last-frame generation.
Custom width when not using a format preset.
Custom height when not using a format preset.
Target frames per second.
Diffusion steps.
Optional deterministic seed.
Video example library
Tested request examples
curl -X POST "https://api.imole.app/v1/videos" \
-H "Authorization: Bearer $IMOLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "imole-video",
"mode": "t2v",
"prompt": "[Supported models]\nsora-2, imole-video.\n\n[Style]\nCinematic startup launch short film, premium commercial realism, soft film grain, warm sunrise contrast, shallow depth of field.\n\n[Scene]\nA quiet design studio at sunrise, large windows, long wooden table, laptop, notebooks, floating dust in the light.\n\n[Character]\nA focused founder in a textured dark jacket, calm but excited, natural breathing, consistent face and outfit.\n\n[Shot Details]\n[00:00-00:03] Slow push-in from a medium wide shot as the founder opens the laptop and sunrise light crosses the keyboard.\n[00:03-00:06] Close three-quarter profile, the founder studies a rising graph and forms a restrained smile.\n[00:06-00:08] Over-shoulder finish with a tiny camera arc, screen glow reflected on the face, room depth visible.\n\n[Camera]\nSlow dolly in, gentle micro-handheld stabilization, restrained motion.",
"negative_prompt": "subtitles, watermark, broken anatomy, unreadable UI text, logo distortion, whip pans",
"format": "landscape",
"duration_seconds": 5,
"fps": 24
}'curl -X POST "https://api.imole.app/v1/videos" \
-H "Authorization: Bearer $IMOLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "imole-video",
"mode": "i2v",
"prompt": "[Supported models]\nimole-video.\n\n[Style]\nPolished product motion plate, photoreal, premium SaaS campaign feel, clean light transitions, controlled depth.\n\n[Scene]\nUse the provided source image as the first frame and preserve its composition, product layout, and overall mood.\n\n[Shot Details]\n[00:00-00:02] Keep the composition anchored to the source image and add a gentle forward push with layered parallax between foreground and background.\n[00:02-00:04] Introduce a subtle light roll across the desk edge and screen border while preserving the exact subject placement.\n[00:04-00:05] Finish with a calm settling motion, soft lens breathing,.\n\n[Positive Constraints]\nPreserve subject identity.",
"negative_prompt": "add extra text, warp objects, change the original palette dramatically, abrupt morphing",
"image_url": "https://imole.app/docs-samples/poster.png",
"format": "landscape",
"duration_seconds": 5,
"fps": 24
}'curl -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/videos/$VIDEO_ID"curl -L -H "Authorization: Bearer $IMOLE_API_KEY" "https://api.imole.app/v1/videos/$VIDEO_ID/content" -o imole-video.mp4