Design Pipeline

Score a design for printability

Scores a design 0–100 for printability, edge cleanliness and colour vibrancy against what it was meant to be, and checks that required text is present. Use it to gate designs before you order.

post/api/quality/score

Request

Base URL: https://api.crayonz.ai
URL: https://api.crayonz.ai/api/quality/score
Auth: API key in header X-API-Key

Request body

image_urlstring required

Public https URL of the design (file_url from /api/design/custom)

design_briefstring required

What the design was meant to be, in a sentence

check_textstring

Exact text that must appear in the design

brand_colorsstring[]

Hex colours the design should use

Example request

{
  "image_url": "https://…/design.png",
  "design_brief": "Minimal mountain badge for a hiking club, two colours",
  "check_text": "TRAIL BUDDIES",
  "brand_colors": [
    "#111111",
    "#F5D400"
  ]
}

Response

Success

statusstring

"scored" or "error"

recommendationstring

"approve" (overall_quality ≥7), "review" (5–7) or "reject" (<5)

scoresobject

1–10 per criterion: composition_balance, print_readiness, design_originality, color_harmony, brief_adherence, overall_quality (plus text_accuracy / brand_color_alignment when check_text / brand_colors were sent)

issuesstring[]

Short strings describing what would print badly

strengthsstring[]

Short strings describing what works

scored_atstring

ISO 8601 timestamp

Changes

No recorded changes to this operation across all 1 revision of this API.