Operation

Enhance Video Prompt

Transform a rough motion prompt into a concise, camera-aware generation prompt.

Start Here Operations Reference

Open Console OpenAPI Spec

Operation: prompt.enhance.video

Submit via POST /api/v1/requests

Credits: 1

Request fields

promptvisualStyledurationaspectRatiorewriteRequest

Example request

{
  "operation": "prompt.enhance.video",
  "input": {
    "prompt": "A runner sprinting through a desert canyon at sunrise.",
    "visualStyle": "cinematic, high-contrast golden light",
    "duration": 8,
    "aspectRatio": "16:9",
    "rewriteRequest": "Make the camera motion feel premium but keep the direction readable."
  }
}

curl -X POST https://www.cannonstudio.app/api/v1/requests \
  -H "Content-Type: application/json" \
  -H "x-api-key: $CANNON_API_KEY" \
  -H "x-idempotency-key: prompt-enhance-video-001" \
  -d @- <<'JSON'
{
  "operation": "prompt.enhance.video",
  "input": {
    "prompt": "A runner sprinting through a desert canyon at sunrise.",
    "visualStyle": "cinematic, high-contrast golden light",
    "duration": 8,
    "aspectRatio": "16:9",
    "rewriteRequest": "Make the camera motion feel premium but keep the direction readable."
  }
}
JSON

Notes

Returns a camera-aware video prompt.
Best used before calling video generation with a provider model.
Keeps the response concise and production-ready.

Success output

{
  "enhancedPrompt": "Handheld chase through a crowded market at blue hour, fast lateral motion, kinetic foreground traffic, practical lantern glow, grounded realism, cinematic pacing.",
  "model": "gpt-5-mini",
  "operation": "prompt.enhance.video"
}