Check photo suitability
klynx_check_photoUse this when the user wants to know whether a photo is good enough for a social media post, or before klynx_create_post_pack on a photo not used before. Needs image_url (https) or upload_id (from klynx_request_photo_upload). Free and changes nothing. Returns a 0 to 100 suitability score, suitable (true or false), brightness, clipped shadows and highlights, sharpness and blur, whether people or hands are in frame, whether it is a photograph (reported for information only), a short description of the subject, up to three issues and the longest edge in pixels. A photo under 800px on its longest edge is reported as not suitable with reason photo_too_small. It does not enhance or caption the photo.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "klynx_check_photo"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image_url | No | https URL of a JPEG, PNG or WebP photo, up to 20MB. Send this or upload_id, not both. | |
| upload_id | No | upload_id from klynx_request_photo_upload, once the photo has been uploaded. Send this or image_url, not both. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blur | Yes | ||
| score | Yes | 0 to 100. | |
| issues | Yes | ||
| reason | Yes | photo_too_small when the longest edge is under 800px, otherwise null. | |
| subject | Yes | ||
| suitable | Yes | ||
| reel_note | No | How the photo is framed on a Reel. | |
| sharpness | Yes | ||
| brightness | Yes | ||
| orientation | No | portrait when taller than wide, otherwise landscape. | |
| operation_id | Yes | ||
| people_count | Yes | ||
| hands_visible | Yes | ||
| is_photograph | Yes | true for a photograph, false for an illustration, screenshot or AI-generated image. Reported for information; it does not affect suitable. | |
| clipped_shadows | Yes | ||
| longest_edge_px | Yes | ||
| brightness_label | Yes | ||
| clipped_highlights | Yes |