Sora 2 technical docs
Endpoint, auth header, parameters, prices, and tested request examples for Sora 2.
Endpoint and pricing
Request headers
Authorization required
Bearer Imole API key.
Content-Type required
Use application/json for JSON requests.
Request parameters
model required
Use sora-2.
prompt required
Scene, action, motion, camera, and lighting. Use the shared structured video prompt style: [Style], [Scene], [Character], [Shot Details], [Camera], and [Constraints].
seconds required
Duration in seconds.
4, 8, 12size
Output size as WIDTHxHEIGHT.
720x1280, 1280x720Video 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": "sora-2",
"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.",
"seconds": 8,
"size": "1280x720"
}'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 sora-2.mp4