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.
{"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.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key 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.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
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. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
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.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
Service Level:
100%
Response Time:
5,312ms
Service Level:
100%
Response Time:
3,461ms
Service Level:
100%
Response Time:
2,310ms
Service Level:
100%
Response Time:
573ms
Service Level:
90%
Response Time:
721ms
Service Level:
100%
Response Time:
756ms
Service Level:
100%
Response Time:
3,976ms
Service Level:
100%
Response Time:
1,129ms
Service Level:
100%
Response Time:
1,669ms