Our Intelligent Composition API leverages advanced aesthetic evaluation techniques to analyze input images and generate bounding boxes that highlight the most visually appealing areas. This API intelligently identifies key elements and optimizes the composition, enabling users to crop their original photos into more refined and aesthetically pleasing images. Ideal for photographers, graphic designers, and digital content creators, this tool simplifies the image enhancement process by providing precise guidelines for optimal cropping. Integrate our Intelligent Composition API into your application to offer users an innovative feature that enhances the visual quality of their images through smart composition analysis and cropping. Elevate your platform with this cutting-edge technology, ensuring consistently high-quality and beautifully composed images that capture attention and enhance visual storytelling.
Enhance images with intelligent aesthetic evaluation and optimized cropping using our Intelligent Composition API.
| Field | Required | Type | Scope | Defaults | Description |
|---|---|---|---|---|---|
image |
YES | file |
|||
num_boxes |
NO | integer |
|
5 | The number of output boxes. |
Intelligent Composition - Endpoint Features
| Object | Description |
|---|---|
num_boxes |
Optional The number of output boxes. `1` `2` `3` `4` `5` `6` `7` `8` `9` `10` |
Request Body |
[Required] File Binary |
{"data":{"elements":[{"max_x":396,"max_y":354,"min_x":21,"score":3.996,"min_y":21},{"max_x":396,"max_y":396,"min_x":21,"score":3.984,"min_y":21},{"max_x":438,"max_y":396,"min_x":21,"score":3.725,"min_y":21},{"max_x":438,"max_y":354,"min_x":21,"score":3.714,"min_y":21},{"max_x":396,"max_y":438,"min_x":21,"score":3.678,"min_y":21}]},"error_code":0,"error_detail":{"status_code":200,"code":"","code_message":"","message":""},"log_id":"59A1393D-AAE2-5247-B095-8D783B8185B0","request_id":"59A1393D-AAE2-5247-B095-8D783B8185B0"}
curl --location 'https://zylalabs.com/api/4438/intelligent+composition+api/5451/intelligent+composition' \
--header 'Content-Type: application/json' \
--form 'image=@"FILE_PATH"'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime.
Our Intelligent Composition API leverages advanced aesthetic evaluation techniques to analyze input images and generate bounding boxes that highlight the most visually appealing areas. This API intelligently identifies key elements and optimizes the composition, enabling users to crop their original photos into more refined and aesthetically pleasing images. Ideal for photographers, graphic designers, and digital content creators, this tool simplifies the image enhancement process by providing precise guidelines for optimal cropping.
Photography: Automatically enhancing photo composition to create more balanced and visually appealing images. Graphic Design: Assisting designers in creating well-composed layouts for posters, brochures, and other visual materials. E-commerce: Improving the composition of product images to highlight features and attract customers. Social Media: Enhancing images for social media posts to increase engagement and aesthetic appeal. Web Design: Creating well-composed images and graphics for website layouts, ensuring a professional look. Advertising and Marketing: Designing visually compelling advertisements and marketing materials with optimized composition.
Enhanced Aesthetics: Automatically improves the visual appeal of images and designs by optimizing composition. Time Efficiency: Saves time by automating the process of achieving well-composed visuals, especially useful for batch processing. Consistency: Provides consistent composition improvements across various images and projects. Versatility: Applicable to a wide range of fields, including photography, graphic design, e-commerce, social media, web design, video production, advertising, and creative arts. Quality Enhancement: Enhances the overall quality of images and designs by focusing on key elements and achieving balanced compositions.
Photographers and Videographers: Professionals and hobbyists looking to enhance their composition skills using advanced tools and techniques. Graphic Designers and Visual Artists: Individuals who create visual content and can benefit from intelligent composition tools to improve their work. Content Creators and Social Media Influencers: Those who regularly produce visual content and seek to make their posts more engaging and aesthetically pleasing. Marketing and Advertising Professionals: Experts who design visual campaigns and need to ensure their compositions are appealing and effective.
The API returns a structured JSON response containing information about the image composition, including bounding box coordinates and a composition score. The key fields include `request_id`, `log_id`, `error_code`, and `data`, which holds the composition results.
Key fields in the response include `error_code` (indicating success or failure), `error_msg` (providing error details), and `data`, which contains an array of `elements` with bounding box coordinates (`min_x`, `max_x`, `min_y`, `max_y`) and a `score` reflecting composition quality.
The response data is organized into a main object containing metadata (like `request_id` and `error_code`) and a `data` object. Within `data`, an array of `elements` provides detailed composition results, including bounding box coordinates and scores.
The endpoint accepts two parameters: `image` (required) for the input image file and `num_boxes` (optional) to specify the number of output bounding boxes, ranging from 1 to 10, with a default value of 5.
Users can customize requests by selecting the `num_boxes` parameter to define how many bounding boxes they want in the response. This allows for tailored results based on specific needs, such as focusing on fewer key areas or more detailed analysis.
Typical use cases include enhancing photographs for social media, optimizing product images for e-commerce, and assisting graphic designers in creating visually appealing layouts. The API helps improve image aesthetics across various digital platforms.
Users can utilize the returned data by analyzing the bounding box coordinates to crop images effectively. The `score` can guide users in selecting the best composition, with scores of 3.8 or above indicating high-quality compositions.
The API employs advanced aesthetic evaluation techniques to ensure the accuracy of the composition analysis. Each output is generated based on sophisticated algorithms that assess visual appeal, helping maintain high-quality results across various images.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Service Level:
100%
Response Time:
3,461ms
Service Level:
100%
Response Time:
5,312ms
Service Level:
100%
Response Time:
2,310ms
Service Level:
100%
Response Time:
573ms
Service Level:
90%
Response Time:
721ms
Service Level:
100%
Response Time:
3,976ms
Service Level:
100%
Response Time:
756ms
Service Level:
100%
Response Time:
1,127ms
Service Level:
100%
Response Time:
1,425ms
Service Level:
100%
Response Time:
18ms
Service Level:
100%
Response Time:
20,002ms
Service Level:
100%
Response Time:
242ms
Service Level:
100%
Response Time:
431ms
Service Level:
100%
Response Time:
268ms
Service Level:
100%
Response Time:
243ms
Service Level:
100%
Response Time:
370ms
Service Level:
100%
Response Time:
213ms
Service Level:
100%
Response Time:
501ms
Service Level:
100%
Response Time:
1,466ms
Service Level:
100%
Response Time:
547ms