Operation

Enhance Image Prompt

Rewrite an image prompt into a more specific, filmable, production-ready prompt.

Start Here Operations Reference

Open Console OpenAPI Spec

Operation: prompt.enhance.image

Submit via POST /api/v1/requests

Credits: 1

Request fields

promptvisualStyleaspectRatiorewriteRequest

Example request

{
  "operation": "prompt.enhance.image",
  "input": {
    "prompt": "A stormy alley with neon reflections and a lone detective.",
    "visualStyle": "moody cyberpunk noir, anamorphic lens flare, wet asphalt",
    "aspectRatio": "16:9",
    "rewriteRequest": "Push this toward a premium cinematic key art image."
  }
}

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-image-001" \
  -d @- <<'JSON'
{
  "operation": "prompt.enhance.image",
  "input": {
    "prompt": "A stormy alley with neon reflections and a lone detective.",
    "visualStyle": "moody cyberpunk noir, anamorphic lens flare, wet asphalt",
    "aspectRatio": "16:9",
    "rewriteRequest": "Push this toward a premium cinematic key art image."
  }
}
JSON

Notes

Returns a rewritten prompt as plain text.
Cannon Studio preserves the language already used in the input prompt and does not localize prompt text.
Use this when you want Cannon Studio to strengthen intent before generation.

Success output

{
  "enhancedPrompt": "A cinematic night alley with wet pavement, neon spill, drifting steam, and a lone detective framed in moody contrast.",
  "model": "gpt-5-mini",
  "operation": "prompt.enhance.image"
}