Rule-of-thirds points API

Returns the four power-points and gridline coordinates for a width x height frame, the focal anchors for composition and cropping. Answers 'Where are the rule-of-thirds power points for a 1920x1080 frame?', 'Where do the gridlines fall?'.

Price$0.02per request

MethodPOST

Route/v1/design/rule-of-thirds

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

designlayoutrule-of-thirdscompositionpower-pointsgridcroppingphotography

API URLhttps://x402.hexl.dev/v1/design/rule-of-thirds

Integration docs

Example request

{
  "width": 1920,
  "height": 1080
}

Example response

{
  "width": 1920,
  "height": 1080,
  "gridLines": {
    "vertical": [
      640,
      1280
    ],
    "horizontal": [
      360,
      720
    ]
  },
  "powerPoints": [
    {
      "name": "top-left",
      "x": 640,
      "y": 360
    },
    {
      "name": "top-right",
      "x": 1280,
      "y": 360
    },
    {
      "name": "bottom-left",
      "x": 640,
      "y": 720
    },
    {
      "name": "bottom-right",
      "x": 1280,
      "y": 720
    }
  ],
  "interpretation": "Place key subjects on the four power-points or along the gridlines."
}

Input schema

{
  "type": "object",
  "required": [
    "width",
    "height"
  ],
  "properties": {
    "width": {
      "type": "number",
      "description": "Frame width",
      "examples": [
        1920
      ]
    },
    "height": {
      "type": "number",
      "description": "Frame height",
      "examples": [
        1080
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}