{"items":[{"type":"link","label":"Product Shot API Reference","link":"/product-shot-editing","routeSlug":"/product-shot-editing","content":{"contentType":"overview","meta":{"name":"Product Shot API Reference"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"product-shot-editing.json","url":"/_bundle/product-shot-editing.json?download"},{"kind":"download","label":"product-shot-editing.yaml","url":"/_bundle/product-shot-editing.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Product Shot API Reference","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"Below you will find the technical specifications, request schemas, and response models for our endpoints. \n \nChoose an endpoint from the sidebar to view code samples and run test requests."}],"sectionId":"/product-shot-editing"},{"nodeType":"external-docs","url":"https://platform.bria.ai/organization-management/api-keys","description":"Register and get API Access"}],"sectionId":"/product-shot-editing"}]}]}},{"type":"group","label":"Product Endpoints","link":"/product-shot-editing/product-endpoints","routeSlug":"/product-shot-editing/product-endpoints","items":[{"label":"Product Cutout","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-cutout","routeSlug":"/product-shot-editing/product-endpoints/product-cutout","metadata":{"seo":{"title":"Product Cutout","description":"Try out this capability in Bria's sandbox"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-cutout","name":"Product Cutout","isWebhook":false,"pointer":"/paths/~1product~1cutout/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Product Cutout","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://platform.bria.ai/product-shot-editing/product-cutout"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's sandbox"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This capability allows you to create a precise cutout of a product from any given image. This feature is especially valuable for eCommerce platforms and applications, serving as a fundamental building block for crafting a user-friendly interface."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization","required":true}],"pointer":"/paths/~1product~1cutout/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_144","exampleIds":["paths/~1product~1cutout/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_144","exampleIds":["paths/~1product~1cutout/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1cutout/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/cutout","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_144","exampleIds":["paths/~1product~1cutout/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/cutout","href":"product-endpoints/product-cutout","openApiOperationId":"product-cutout","summary":"Product Cutout"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_144","exampleIds":["paths/~1product~1cutout/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_144","exampleIds":["paths/~1product~1cutout/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_145","exampleIds":["paths/~1product~1cutout/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_145","exampleIds":["paths/~1product~1cutout/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1cutout/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1cutout/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Invalid file type. Supported file types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1cutout/post/responses/422/content/application~1json/examples/output_violation"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1cutout/post/responses/422/content/application~1json/examples/output_violation"]},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1cutout/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_145","exampleIds":["paths/~1product~1cutout/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_145","exampleIds":["paths/~1product~1cutout/post/responses/200/content/application~1json/example"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1cutout/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1cutout/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422","schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1cutout/post/responses/422/content/application~1json/examples/output_violation"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1cutout/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1cutout/post/responses/422/content/application~1json/examples/output_violation"]}}},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-cutout"}],"panels":[]}]},"httpPath":"/product/cutout"},{"label":"Product Packshot","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-packshot","routeSlug":"/product-shot-editing/product-endpoints/product-packshot","metadata":{"seo":{"title":"Product Packshot","description":"Try out this capability in Bria's sandbox"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-packshot","name":"Product Packshot","isWebhook":false,"pointer":"/paths/~1product~1packshot/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Product Packshot","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://platform.bria.ai/product-shot-editing/product-packshot"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's sandbox"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Product Pack Shot feature is designed to create professional standard pack shots. The output is a 2000x2000 px image, with the product size and location according to best practices. This feature can allow users to take any photo of a product and transform it into a professional pack shot, placing the product on a clean, seamless background, typically white but customizable to any color."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1product~1packshot/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_146","exampleIds":["paths/~1product~1packshot/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_146","exampleIds":["paths/~1product~1packshot/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1packshot/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/packshot","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_146","exampleIds":["paths/~1product~1packshot/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/packshot","href":"product-endpoints/product-packshot","openApiOperationId":"product-packshot","summary":"Product Packshot"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_146","exampleIds":["paths/~1product~1packshot/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_146","exampleIds":["paths/~1product~1packshot/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147","exampleIds":["paths/~1product~1packshot/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_147","exampleIds":["paths/~1product~1packshot/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1packshot/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1packshot/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Invalid file type. Supported file types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1packshot/post/responses/422/content/application~1json/examples/output_violation"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1packshot/post/responses/422/content/application~1json/examples/output_violation"]},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1packshot/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_147","exampleIds":["paths/~1product~1packshot/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147","exampleIds":["paths/~1product~1packshot/post/responses/200/content/application~1json/example"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1packshot/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1packshot/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422","schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1packshot/post/responses/422/content/application~1json/examples/output_violation"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1packshot/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1packshot/post/responses/422/content/application~1json/examples/output_violation"]}}},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-packshot"}],"panels":[]}]},"httpPath":"/product/packshot"},{"label":"Product Shadow","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-shadow","routeSlug":"/product-shot-editing/product-endpoints/product-shadow","metadata":{"seo":{"title":"Product Shadow","description":"Try out this capability in Bria's sandbox"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-shadow","name":"Product Shadow","isWebhook":false,"pointer":"/paths/~1product~1shadow/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Product Shadow","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://platform.bria.ai/product-shot-editing/product-shadow"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's sandbox"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Product Shadow API allows you to add consistent and customizable shadow to a product cutout. This feature is designed to work in combination with other capabilities like product cutout,  product packshot and product lifestyle shots, enhancing the visual appeal of e-commerce and product imagery."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the product image isn't a product cutout, you should use the product cutout API first. The product shadow API accepts a product cutout as input. Once you have a product cutout with a shadow, you can use it in product packshot or product lifestyle shot APIs, where needed."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content or if the modified output would contain inappropriate content."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1product~1shadow/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_148","exampleIds":["paths/~1product~1shadow/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_148","exampleIds":["paths/~1product~1shadow/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1shadow/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/shadow","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_148","exampleIds":["paths/~1product~1shadow/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/shadow","href":"product-endpoints/product-shadow","openApiOperationId":"product-shadow","summary":"Product Shadow"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_148","exampleIds":["paths/~1product~1shadow/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_148","exampleIds":["paths/~1product~1shadow/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147","exampleIds":["paths/~1product~1shadow/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_147","exampleIds":["paths/~1product~1shadow/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1shadow/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1shadow/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Invalid file type. Supported file types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1shadow/post/responses/422/content/application~1json/examples/output_violation"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1shadow/post/responses/422/content/application~1json/examples/output_violation"]},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1shadow/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_147","exampleIds":["paths/~1product~1shadow/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_147","exampleIds":["paths/~1product~1shadow/post/responses/200/content/application~1json/example"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1shadow/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1shadow/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422","schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1shadow/post/responses/422/content/application~1json/examples/output_violation"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1shadow/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1shadow/post/responses/422/content/application~1json/examples/output_violation"]}}},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-shadow"}],"panels":[]}]},"httpPath":"/product/shadow"},{"label":"Lifestyle Product Shot by Text","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-lifestyle-shot-by-text","routeSlug":"/product-shot-editing/product-endpoints/product-lifestyle-shot-by-text","metadata":{"seo":{"title":"Lifestyle Product Shot by Text","description":"Try out this capability in Bria's sandbox"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-lifestyle-shot-by-text","name":"Lifestyle Product Shot by Text","isWebhook":false,"pointer":"/paths/~1product~1lifestyle_shot_by_text/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Lifestyle Product Shot by Text","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://platform.bria.ai/product-shot-editing/lifestyle-product-shot-by-text"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's sandbox"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates enriched product shots by placing them in various environments using textual descriptions."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In addition, you can adjust the background of the product by replacing it with a solid color."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To do this, specify a hex color code (e.g., #FF5733) in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"scene_description"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This feature is only available when generating a single result ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"num_results=1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint also allows adjusting the position of the product and the size of the final product shot."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This enables the creation of new and unique variations of your original product image while maintaining control over layout and format."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To control product positioning and shot dimensions, use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter, which offers several control modes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": preserves the original position and size of the product from the input image."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": generates results with 7 recommended placements, while the shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": allows choosing from predefined positions using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_coordinates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": provides full control over the product's size and location using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_padding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": lets you define padding in pixels around the product to control both size and placement."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic_aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": centers the product and resizes the canvas automatically to match the specified "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The parameters used for positioning and sizing depend on the selected "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Refer to the documentation for each mode to understand the supported fields and behaviors."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"We offer 3 different background generation modes when generating by text: base, high contol and fast."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - clean, high quality backgrounds."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High_control"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - Stronger prompt adherence and scene context, finer control over layout and details - "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"we recommend using this mode."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - same core capabilities as base, optimal speed and quality balace."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content, and filters out unsafe modified images - the first blocked input image will fail the entire request."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1product~1lifestyle_shot_by_text/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_149","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"]}},"schemaId":"schema_149","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"],"pointer":"/paths/~1product~1lifestyle_shot_by_text/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/lifestyle_shot_by_text","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_149","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/lifestyle_shot_by_text","href":"product-endpoints/product-lifestyle-shot-by-text","openApiOperationId":"product-lifestyle-shot-by-text","summary":"Lifestyle Product Shot by Text"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_149","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_149","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"]}},"examples":[{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/partial_success"]}},"schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/partial_success"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Invalid file type. Supported file types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"]},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1lifestyle_shot_by_text/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/partial_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/partial_success"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422","schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"]}}},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-lifestyle-shot-by-text"}],"panels":[]}]},"httpPath":"/product/lifestyle_shot_by_text"},{"label":"Lifestyle Product Shot by Image","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-lifestyle-shot-by-image","routeSlug":"/product-shot-editing/product-endpoints/product-lifestyle-shot-by-image","metadata":{"seo":{"title":"Lifestyle Product Shot by Image","description":"Try out this capability in Bria's sandbox"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-lifestyle-shot-by-image","name":"Lifestyle Product Shot by Image","isWebhook":false,"pointer":"/paths/~1product~1lifestyle_shot_by_image/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Lifestyle Product Shot by Image","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://platform.bria.ai/product-shot-editing/lifestyle-product-shot-by-image"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's sandbox"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generates enriched product shots by placing them in visually compelling environments, guided by a reference image."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint also allows adjusting the position of the product and the size of the final product shot."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This enables the creation of new and unique variations of your original product image while maintaining control over layout and format."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To control product positioning and shot dimensions, use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter, which offers several control modes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": preserves the original position and size of the product from the input image."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": generates results with 7 recommended placements, while the shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": allows choosing from predefined positions using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_coordinates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": provides full control over the product's size and location using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_padding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": lets you define padding in pixels around the product to control both size and placement."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic_aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": centers the product and resizes the canvas automatically to match the specified "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The parameters used for positioning and sizing depend on the selected "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Refer to the documentation for each mode to understand the supported fields and behaviors."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content, and filters out unsafe modified images - the first blocked input image will fail the entire request."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1product~1lifestyle_shot_by_image/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_151","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"]}},"schemaId":"schema_151","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"],"pointer":"/paths/~1product~1lifestyle_shot_by_image/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/lifestyle_shot_by_image","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_151","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/lifestyle_shot_by_image","href":"product-endpoints/product-lifestyle-shot-by-image","openApiOperationId":"product-lifestyle-shot-by-image","summary":"Lifestyle Product Shot by Image"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_151","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_151","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding","paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"]}},"examples":[{},{},{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/partial_success"]}},"schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/partial_success"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Invalid file type. Supported file types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/all_outputs_blocked"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/all_outputs_blocked"]},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1lifestyle_shot_by_image/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/partial_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/success","paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/partial_success"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422","schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/all_outputs_blocked"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/all_outputs_blocked"]}}},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-lifestyle-shot-by-image"}],"panels":[]}]},"httpPath":"/product/lifestyle_shot_by_image"},{"label":"Embed products into a scene","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-integrate","routeSlug":"/product-shot-editing/product-endpoints/product-integrate","metadata":{"seo":{"title":"Embed products into a scene","description":"Try out this capability in Bria's sandbox"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-integrate","name":"Embed products into a scene","isWebhook":false,"pointer":"/paths/~1image~1edit~1product~1integrate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Embed products into a scene","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://platform.bria.ai/product-shot-editing/product-embedding"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's sandbox"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Integrate and embed one or more products into a predefined scene at precise user-defined coordinates."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint ensures the product matches the scene's lighting, perspective, and aesthetics."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note on Product Cutout & Scaling:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Please use Product Cutput endpoint first, to create a presice cutout of your product. "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Crucially, the provided "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"coordinates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (x, y, width, height) are applied to the resulting tight cutout of the product, not the original source image."},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" To avoid stretching or distortion, developers should ensure the requested width/height matches the aspect ratio of the actual product object rather than the original canvas."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1image~1edit~1product~1integrate/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_152"}},"schemaId":"schema_152","pointer":"/paths/~1image~1edit~1product~1integrate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/image/edit/product/integrate","servers":[{"url":"https://engine.prod.bria-api.com/v2","description":"Specific server for v2 endpoints"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_152"}},"pointer":"/image/edit/product/integrate","href":"product-endpoints/product-integrate","openApiOperationId":"product-integrate","summary":"Embed products into a scene"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v2","description":"Specific server for v2 endpoints"}],"schemaId":"schema_152","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_152"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-integrate"}],"panels":[]}]},"httpPath":"/image/edit/product/integrate"},{"label":"Product Cutout (v2)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/product-cutout-v2","routeSlug":"/product-shot-editing/product-endpoints/product-cutout-v2","metadata":{"seo":{"title":"Product Cutout (v2)","description":"Description"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"product-cutout-v2","name":"Product Cutout (v2)","isWebhook":false,"pointer":"/paths/~1image~1edit~1product~1cutout/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Product Cutout (v2)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates a clean product cutout from any image by removing the background and cropping the image tightly around the product. This capability is especially valuable for eCommerce platforms and applications, and serves as a fundamental building block for product imagery pipelines such as Product Packshot, Product Shadow, and Embed products into a scene."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is the v2 version of the Product Cutout capability, replacing the legacy v1 endpoint (POST /v1/product/cutout). Both versions produce identical results. v2 introduces the standard v2 API contract - JSON requests, asynchronous execution with status polling or webhooks, granular content moderation controls, and the standard v2 response envelope. The v1 endpoint remains available, and new integrations should use v2."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"By default, requests are processed asynchronously. The API immediately returns a request_id and a status URL. Track progress and retrieve the result using the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://docs.bria.ai/status"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status Service"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or receive the result via webhook_url. Set sync to true to hold the connection open and receive the final result directly in the response."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint supports content moderation via optional parameters that can prevent processing if the input image contains inappropriate content or if the output would contain inappropriate content."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1image~1edit~1product~1cutout/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_153","exampleIds":["paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_153","exampleIds":["paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1image~1edit~1product~1cutout/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/image/edit/product/cutout","servers":[{"url":"https://engine.prod.bria-api.com/v2","description":"Specific server for v2 endpoints"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_153","exampleIds":["paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","202","400","401","403","422","429","5XX"],"pointer":"/image/edit/product/cutout","href":"product-endpoints/product-cutout-v2","openApiOperationId":"product-cutout-v2","summary":"Product Cutout (v2)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v2","description":"Specific server for v2 endpoints"}],"schemaId":"schema_153","exampleIds":["paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_153","exampleIds":["paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation (Synchronous Success).","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_154"}},"schemaId":"schema_154"},{"code":"202","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Accepted (Asynchronous). You can track the progress and retrieve the final result using the Status Service. For more details, refer to the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://docs.bria.ai/status"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status Service"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" section."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_155"}},"schemaId":"schema_155"},{"code":"400","description":"Bad request. For example, the input image is fully transparent.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_156"}},"schemaId":"schema_156"},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden."},{"code":"422","description":"Unprocessable Entity. Validation or content moderation failure. The response contains a structured error object with message and details.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_156"}},"schemaId":"schema_156"},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"5XX","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1image~1edit~1product~1cutout/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_154","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_154"}}},{"code":"202","schemaId":"schema_155","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_155"}}},{"code":"400","schemaId":"schema_156","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_156"}}},{"code":"401"},{"code":"403"},{"code":"422","schemaId":"schema_156","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_156"}}},{"code":"429"},{"code":"5XX"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/product-cutout-v2"}],"panels":[]}]},"httpPath":"/image/edit/product/cutout"},{"label":"Consistent Product Shots (Coming Soon)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/consistent-product-shots","routeSlug":"/product-shot-editing/product-endpoints/consistent-product-shots","metadata":{"seo":{"title":"Consistent Product Shots (Coming Soon)","description":"DescriptionThis feature allows users to create consistent product shots by providing either a textual description of a scene or an image, along with a group of product images. The resulting consistent product shots are ideal for use on social media, eCommerce websites, product catalogs, and other marketing materials, ensuring a uniform and professional appearance across all platforms."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"consistent-product-shots","name":"Consistent Product Shots (Coming Soon)","isWebhook":false,"pointer":"/paths/~1products~1consistent_shots/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Consistent Product Shots (Coming Soon)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This feature allows users to create consistent product shots by providing either a textual description of a scene or an image, along with a group of product images. The resulting consistent product shots are ideal for use on social media, eCommerce websites, product catalogs, and other marketing materials, ensuring a uniform and professional appearance across all platforms."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/products/consistent_shots","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/products/consistent_shots","href":"product-endpoints/consistent-product-shots","openApiOperationId":"consistent-product-shots","summary":"Consistent Product Shots (Coming Soon)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation."}],"pointer":"/paths/~1products~1consistent_shots/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/consistent-product-shots"}],"panels":[]}]},"httpPath":"/products/consistent_shots"},{"label":"Contextual Keyword Extraction (Coming Soon)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/product-endpoints/contextual-keyword-extraction","routeSlug":"/product-shot-editing/product-endpoints/contextual-keyword-extraction","metadata":{"seo":{"title":"Contextual Keyword Extraction (Coming Soon)","description":"DescriptionThis feature allows users to extract relevant keywords from an image and its context, focusing on the primary product rather than secondary elements. This capability enhances search optimization in eCommerce by ensuring that the keywords accurately represent the product being sold. It can be particularly useful for improving product searchability on eCommerce websites, enhancing SEO for product listings, automating content management, and optimizing social media marketing efforts."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"contextual-keyword-extraction","name":"Contextual Keyword Extraction (Coming Soon)","isWebhook":false,"pointer":"/paths/~1product~1contextual_keyword_extraction/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Contextual Keyword Extraction (Coming Soon)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This feature allows users to extract relevant keywords from an image and its context, focusing on the primary product rather than secondary elements. This capability enhances search optimization in eCommerce by ensuring that the keywords accurately represent the product being sold. It can be particularly useful for improving product searchability on eCommerce websites, enhancing SEO for product listings, automating content management, and optimizing social media marketing efforts."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/contextual_keyword_extraction","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"responseCodes":["200"],"pointer":"/product/contextual_keyword_extraction","href":"product-endpoints/contextual-keyword-extraction","openApiOperationId":"contextual-keyword-extraction","summary":"Contextual Keyword Extraction (Coming Soon)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation."}],"pointer":"/paths/~1product~1contextual_keyword_extraction/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/product-endpoints/contextual-keyword-extraction"}],"panels":[]}]},"httpPath":"/product/contextual_keyword_extraction"}],"content":{"contentType":"group","meta":{"name":"Product Endpoints"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Product Endpoints","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/product/cutout","summary":"Product Cutout","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-cutout","deprecated":false},{"title":"/product/packshot","summary":"Product Packshot","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-packshot","deprecated":false},{"title":"/product/shadow","summary":"Product Shadow","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-shadow","deprecated":false},{"title":"/product/lifestyle_shot_by_text","summary":"Lifestyle Product Shot by Text","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-lifestyle-shot-by-text","deprecated":false},{"title":"/product/lifestyle_shot_by_image","summary":"Lifestyle Product Shot by Image","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-lifestyle-shot-by-image","deprecated":false},{"title":"/image/edit/product/integrate","summary":"Embed products into a scene","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-integrate","deprecated":false},{"title":"/image/edit/product/cutout","summary":"Product Cutout (v2)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/product-cutout-v2","deprecated":false},{"title":"/products/consistent_shots","summary":"Consistent Product Shots (Coming Soon)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/consistent-product-shots","deprecated":false},{"title":"/product/contextual_keyword_extraction","summary":"Contextual Keyword Extraction (Coming Soon)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/product-endpoints/contextual-keyword-extraction","deprecated":false}]}]}]}]}},{"type":"group","label":"Automotive Endpoints","link":"/product-shot-editing/automotive-endpoints","routeSlug":"/product-shot-editing/automotive-endpoints","items":[{"label":"Vehicle Shot by text","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-shot-by-text","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-shot-by-text","metadata":{"seo":{"title":"Vehicle Shot by text","description":"Try out this capability in Bria's Automobile Playground"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-shot-by-text","name":"Vehicle Shot by text","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1shot_by_text/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Vehicle Shot by text","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://console.bria.ai/automotive"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's Automobile Playground"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates enriched automotive product shots by placing vehicles in realistic environments using textual descriptions."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint includes vehicle-specific enhancements that adapt the background scene to match automotive contexts, specifically - snow, sand, and grass. It embeds the vehicle into the environment for a natural, grounded appearance."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint also allows adjusting the position of the product and the size of the final product shot."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This enables the creation of new and unique variations of your original product image while maintaining control over layout and format."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"To control product positioning and shot dimensions, use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter, which offers several control modes:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": preserves the original position and size of the product from the input image."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": generates results with 7 recommended placements, while the shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": allows choosing from predefined positions using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"custom_coordinates"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": provides full control over the product's size and location using "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_padding"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": lets you define padding in pixels around the product to control both size and placement."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic_aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": centers the product and resizes the canvas automatically to match the specified "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The parameters used for positioning and sizing depend on the selected "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Refer to the documentation for each mode to understand the supported fields and behaviors."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API endpoint supports content moderation via an optional parameter that can prevent processing if input images contain inappropriate content, and filters out unsafe modified images — the first blocked input image will fail the entire request."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization","required":true}],"pointer":"/paths/~1product~1vehicle~1shot_by_text/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_157","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_157","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1vehicle~1shot_by_text/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/shot_by_text","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_157","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/vehicle/shot_by_text","href":"automotive-endpoints/vehicle-shot-by-text","openApiOperationId":"vehicle-shot-by-text","summary":"Vehicle Shot by text"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_157","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_157","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful operation","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/partial_success"]}},"schemaId":"schema_150","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/partial_success"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Invalid file type. Supported file types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"]},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1vehicle~1shot_by_text/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_150","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/partial_success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_150","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/success","paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/partial_success"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/input_violation","paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"]}}},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-shot-by-text"}],"panels":[]}]},"httpPath":"/product/vehicle/shot_by_text"},{"label":"Vehicle Shot by Image (Coming soon)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-shot-by-image","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-shot-by-image","metadata":{"seo":{"title":"Vehicle Shot by Image (Coming soon)","description":"Coming soon"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-shot-by-image","name":"Vehicle Shot by Image (Coming soon)","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1shot_by_image/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Vehicle Shot by Image (Coming soon)","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Coming soon\n"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/shot_by_image","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[],"pointer":"/product/vehicle/shot_by_image","href":"automotive-endpoints/vehicle-shot-by-image","openApiOperationId":"vehicle-shot-by-image","summary":"Vehicle Shot by Image (Coming soon)"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-shot-by-image"}],"panels":[]}]},"httpPath":"/product/vehicle/shot_by_image"},{"label":"Segmentation","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-segmentation","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-segmentation","metadata":{"seo":{"title":"Segmentation","description":"Try out this capability in Bria's Automobile Playground"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-segmentation","name":"Segmentation","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1segment/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Segmentation","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://console.bria.ai/automotive"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's Automobile Playground"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generates segmentation masks for specific vehicle parts from an input image, enabling further enhancements such as reflection generation or wheel refinement."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint returns separate binary masks for each segmented region, including windows, wheels, and body parts. If a specific part is not detected in the image, it will be returned with an empty URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The API supports input via image URL or base64-encoded image file, and also includes optional content moderation."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization.","required":true}],"pointer":"/paths/~1product~1vehicle~1segment/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_158","exampleIds":["paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_158","exampleIds":["paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1vehicle~1segment/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/segment","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_158","exampleIds":["paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/vehicle/segment","href":"automotive-endpoints/vehicle-segmentation","openApiOperationId":"vehicle-segmentation","summary":"Segmentation"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_158","exampleIds":["paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_158","exampleIds":["paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Segmentation masks successfully generated.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_159","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/200/content/application~1json/examples/success"]}},"schemaId":"schema_159","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/200/content/application~1json/examples/success"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Supported types - jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content"},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1vehicle~1segment/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_159","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_159","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/200/content/application~1json/examples/success"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422"},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-segmentation"}],"panels":[]}]},"httpPath":"/product/vehicle/segment"},{"label":"Reflections","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-generate-reflections","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-generate-reflections","metadata":{"seo":{"title":"Reflections","description":"Try out this capability in Bria's Automobile Playground"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-generate-reflections","name":"Reflections","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1generate_reflections/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reflections","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://console.bria.ai/automotive"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's Automobile Playground"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generates realistic reflections on relevant surfaces of a product image, such as glass, metal, or glossy materials."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Reflection masks can be provided manually or generated automatically using our segmentation tools."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The output includes an updated image with applied reflections and optional reflection layers per region."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization","required":true}],"pointer":"/paths/~1product~1vehicle~1generate_reflections/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_160","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_160","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1vehicle~1generate_reflections/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/generate_reflections","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_160","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/vehicle/generate_reflections","href":"automotive-endpoints/vehicle-generate-reflections","openApiOperationId":"vehicle-generate-reflections","summary":"Reflections"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_160","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_160","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Reflections successfully applied.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_161","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_true"]}},"schemaId":"schema_161","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_true"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Supported types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content"},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1vehicle~1generate_reflections/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_161","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_true"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_161","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_true"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422"},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-generate-reflections"}],"panels":[]}]},"httpPath":"/product/vehicle/generate_reflections"},{"label":"Tires Refinement","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-refine-tires","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-refine-tires","metadata":{"seo":{"title":"Tires Refinement","description":"Try out this capability in Bria's Automobile Playground"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-refine-tires","name":"Tires Refinement","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1refine_tires/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Tires Refinement","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://console.bria.ai/automotive"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's Automobile Playground"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enhances the appearance of the vehicle tires by adding realistic textures that match specific surfaces - snow, mud, grass."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint accepts a binary mask of all tires and returns the image with refined tires. You can optionally receive the refined wheels as a separate layer."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization","required":true}],"pointer":"/paths/~1product~1vehicle~1refine_tires/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_162","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_162","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1vehicle~1refine_tires/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/refine_tires","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_162","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/vehicle/refine_tires","href":"automotive-endpoints/vehicle-refine-tires","openApiOperationId":"vehicle-refine-tires","summary":"Tires Refinement"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_162","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_162","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Wheel refinement successfully applied.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_163","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_true"]}},"schemaId":"schema_163","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_true"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Supported types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content"},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1vehicle~1refine_tires/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_163","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_true"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_163","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_true"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422"},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-refine-tires"}],"panels":[]}]},"httpPath":"/product/vehicle/refine_tires"},{"label":"Apply Effects","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-apply-effect","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-apply-effect","metadata":{"seo":{"title":"Apply Effects","description":"Try out this capability in Bria's Automobile Playground"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-apply-effect","name":"Apply Effects","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1apply_effect/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Apply Effects","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://console.bria.ai/automotive"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's Automobile Playground"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds visual overlays such as dust, snow, fog, light leaks, and lens flare to enhance the realism and atmosphere of a product image."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each effect includes multiple variations to ensure visually unique results. Effects can be applied directly to the image or delivered as separate layers."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization","required":true}],"pointer":"/paths/~1product~1vehicle~1apply_effect/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_164","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_164","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1vehicle~1apply_effect/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/apply_effect","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_164","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/vehicle/apply_effect","href":"automotive-endpoints/vehicle-apply-effect","openApiOperationId":"vehicle-apply-effect","summary":"Apply Effects"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_164","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_164","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Effect applied successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_165","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_true"]}},"schemaId":"schema_165","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_true"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Supported types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content"},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1vehicle~1apply_effect/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_165","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_true"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_165","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_false","paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_true"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422"},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-apply-effect"}],"panels":[]}]},"httpPath":"/product/vehicle/apply_effect"},{"label":"Harmonization","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/product-shot-editing/automotive-endpoints/vehicle-harmonize","routeSlug":"/product-shot-editing/automotive-endpoints/vehicle-harmonize","metadata":{"seo":{"title":"Harmonization","description":"Try out this capability in Bria's Automobile Playground"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"vehicle-harmonize","name":"Harmonization","isWebhook":false,"pointer":"/paths/~1product~1vehicle~1harmonize/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Harmonization","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://console.bria.ai/automotive"},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Try out this capability in Bria's Automobile Playground"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Applies predefined lighting and tone presets to match the product image with a desired environmental context."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available presets include hot-day, cold-day, hot-night, and cold-night. These harmonization styles help unify the subject with its background for a consistent and visually appealing result."},"children":[]}]}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"api_token","in":"header","schemaId":"schema_143","description":"API token associated with the organization","required":true}],"pointer":"/paths/~1product~1vehicle~1harmonize/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_166","exampleIds":["paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example"]}},"schemaId":"schema_166","exampleIds":["paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1product~1vehicle~1harmonize/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/product/vehicle/harmonize","servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"api_token","in":"header","required":true,"schemaId":"schema_143"}],"cookie":[]},"security":[],"requestBody":{"application/json":{"schemaId":"schema_166","exampleIds":["paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example"]}},"responseCodes":["200","400","401","403","404","413","415","422","429","460","500"],"pointer":"/product/vehicle/harmonize","href":"automotive-endpoints/vehicle-harmonize","openApiOperationId":"vehicle-harmonize","summary":"Harmonization"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://engine.prod.bria-api.com/v1"}],"schemaId":"schema_166","exampleIds":["paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_166","exampleIds":["paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Preset applied successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_167","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/200/content/application~1json/example"]}},"schemaId":"schema_167","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad request. Missing or invalid parameters."},{"code":"401","description":"Unauthorized. Invalid API key or authentication token."},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/access_denied"]}},"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/access_denied"]},{"code":"404","description":"Not found. Image could not be found at the provided URL."},{"code":"413","description":"Payload too large. Image file size exceeds the 12MB limit."},{"code":"415","description":"Unsupported media type. Supported types are jpeg, jpg, png, webp."},{"code":"422","description":"Unprocessable Content"},{"code":"429","description":"Request limit exceeded. Your account has reached its maximum allowed requests. Please upgrade your plan or try again later."},{"code":"460","description":"Failed to download image."},{"code":"500","description":"Internal server error. An error occurred on the server."}],"pointer":"/paths/~1product~1vehicle~1harmonize/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"schema_167","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_167","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/200/content/application~1json/example"]}}},{"code":"400"},{"code":"401"},{"code":"403","schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/access_denied"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_143","exampleIds":["paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/quota_exceeded","paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/access_denied"]}}},{"code":"404"},{"code":"413"},{"code":"415"},{"code":"422"},{"code":"429"},{"code":"460"},{"code":"500"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/automotive-endpoints/vehicle-harmonize"}],"panels":[]}]},"httpPath":"/product/vehicle/harmonize"}],"content":{"contentType":"group","meta":{"name":"Automotive Endpoints"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Automotive Endpoints","showPageActions":true}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/product/vehicle/shot_by_text","summary":"Vehicle Shot by text","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-shot-by-text","deprecated":false},{"title":"/product/vehicle/shot_by_image","summary":"Vehicle Shot by Image (Coming soon)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-shot-by-image","deprecated":false},{"title":"/product/vehicle/segment","summary":"Segmentation","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-segmentation","deprecated":false},{"title":"/product/vehicle/generate_reflections","summary":"Reflections","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-generate-reflections","deprecated":false},{"title":"/product/vehicle/refine_tires","summary":"Tires Refinement","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-refine-tires","deprecated":false},{"title":"/product/vehicle/apply_effect","summary":"Apply Effects","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-apply-effect","deprecated":false},{"title":"/product/vehicle/harmonize","summary":"Harmonization","prefix":{"name":"post","color":"post"},"badges":[],"link":"/automotive-endpoints/vehicle-harmonize","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/ErrorObject":{"id":"components/schemas/ErrorObject","kind":"json-schema","title":"ErrorObject","data":{"type":"object","properties":{"code":{"type":"integer","example":123},"message":{"type":"string"},"details":{"type":"string"}},"required":["code","message","details"]}},"components/schemas/ErrorResponse":{"id":"components/schemas/ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"type":"object","properties":{"error":{"$ref":"#/components/schemas/ErrorObject"},"request_id":{"type":"string"}},"required":["error","request_id"]}},"components/schemas/SyncSuccessResponse":{"id":"components/schemas/SyncSuccessResponse","kind":"json-schema","title":"SyncSuccessResponse","data":{"type":"object","properties":{"result":{"type":"object","properties":{"image_url":{"type":"string"}},"required":["image_url"]},"request_id":{"type":"string"}},"required":["result","request_id"]}},"components/schemas/SyncEditResponse":{"id":"components/schemas/SyncEditResponse","kind":"json-schema","title":"SyncEditResponse","data":{"type":"object","properties":{"result":{"type":"object","properties":{"image_url":{"type":"string"},"seed":{"type":"integer"},"structured_instruction":{"type":"string"}},"required":["image_url","seed","structured_instruction"]},"request_id":{"type":"string"},"warning":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned only when ip_signal = true and the instruction field included IP content."},"children":[]}]}]}]}},"required":["result","request_id"]}},"components/schemas/SyncStructuredInstructionResponse":{"id":"components/schemas/SyncStructuredInstructionResponse","kind":"json-schema","title":"SyncStructuredInstructionResponse","data":{"type":"object","properties":{"result":{"type":"object","properties":{"seed":{"type":"integer"},"structured_instruction":{"type":"string"}},"required":["seed","structured_instruction"]},"request_id":{"type":"string"},"warning":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned only when ip_signal = true and the instruction field included IP content."},"children":[]}]}]}]}},"required":["result","request_id"]}},"components/schemas/AsyncInitialResponse":{"id":"components/schemas/AsyncInitialResponse","kind":"json-schema","title":"AsyncInitialResponse","data":{"type":"object","properties":{"request_id":{"type":"string"},"status_url":{"type":"string"}},"required":["request_id","status_url"]}},"components/schemas/SyncSuccessWithSeed":{"id":"components/schemas/SyncSuccessWithSeed","kind":"json-schema","title":"SyncSuccessWithSeed","data":{"allOf":[{"$ref":"#/components/schemas/SyncSuccessResponse"},{"type":"object","properties":{"result":{"allOf":[{"$ref":"#/components/schemas/SyncSuccessResponse/properties/result"},{"type":"object","properties":{"seed":{"type":"string"}}}]}}}]}},"components/schemas/SyncSuccessWithSeedAndRefinedPrompt":{"id":"components/schemas/SyncSuccessWithSeedAndRefinedPrompt","kind":"json-schema","title":"SyncSuccessWithSeedAndRefinedPrompt","data":{"allOf":[{"$ref":"#/components/schemas/SyncSuccessResponse"},{"type":"object","properties":{"result":{"allOf":[{"$ref":"#/components/schemas/SyncSuccessResponse/properties/result"},{"type":"object","properties":{"seed":{"type":"integer"},"refined_prompt":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Refined version of the input prompt."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned only when:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request included a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"prompt"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The request did NOT include a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"reference_image"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]}}}]}}}]}},"components/schemas/SyncSuccessWithSeedAndPrompt":{"id":"components/schemas/SyncSuccessWithSeedAndPrompt","kind":"json-schema","title":"SyncSuccessWithSeedAndPrompt","data":{"allOf":[{"$ref":"#/components/schemas/SyncSuccessResponse"},{"type":"object","properties":{"result":{"allOf":[{"$ref":"#/components/schemas/SyncSuccessResponse/properties/result"},{"type":"object","properties":{"seed":{"type":"integer"},"prompt":{"type":"string","description":"Original prompt sent by the user."}}}]}}}]}},"components/schemas/StatusSuccessResponse":{"id":"components/schemas/StatusSuccessResponse","kind":"json-schema","title":"StatusSuccessResponse","data":{"type":"object","properties":{"result":{"type":"object","properties":{"image_url":{"type":"string"}},"required":["image_url"]},"status":{"type":"string","enum":["COMPLETED"]},"request_id":{"type":"string"}},"required":["result","status","request_id"]}},"components/schemas/StatusErrorResponse":{"id":"components/schemas/StatusErrorResponse","kind":"json-schema","title":"StatusErrorResponse","data":{"allOf":[{"$ref":"#/components/schemas/ErrorResponse"},{"type":"object","properties":{"status":{"type":"string","enum":["FAILED"]}},"required":["status"]}]}},"components/schemas/parameters":{"id":"components/schemas/parameters","kind":"json-schema","title":"parameters","data":{"ApiTokenHeader":{"name":"api_token","in":"header","description":"API Token required for authentication","required":true,"schema":{"type":"string"}}}},"schema_143":{"kind":"json-schema","data":{"type":"string"},"id":"schema_143"},"schema_144":{"kind":"json-schema","data":{"type":"object","properties":{"sku":{"type":"string","description":"The Stock Keeping Unit identifier for the product. This parameter is optional."},"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the image containing the product to be cut out. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The image file containing the product to be cut out, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"force_rmbg":{"type":"boolean","default":false,"description":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels."},"preserve_alpha":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls whether the alpha channel values from the input image are retained in the output, if the input includes an alpha channel."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true: The output image maintains the original transparency of fully and partially transparent pixels."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When false: The transparency values from the input are not preserved, but the output may still include an alpha channel (e.g., around the cropped area)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Has no effect if the input image does not include an alpha channel."},"children":[]}]}]}]}]},"content_moderation":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When enabled, applies content moderation to both input visuals and modified outputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For input images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing stops if the image fails moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a 422 error with details about which parameter failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For output images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the modified image fails moderation, returns a 422 error"},"children":[]}]}]}]}]}}},"id":"schema_144"},"schema_145":{"kind":"json-schema","data":{"type":"object","properties":{"result_url":{"type":"string","description":"The URL of the processed product cutout image. This is a temporary URL that expires after 1 hour."}}},"id":"schema_145"},"schema_146":{"kind":"json-schema","data":{"type":"object","properties":{"sku":{"type":"string","description":"The Stock Keeping Unit identifier for the product. This parameter is optional."},"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the product image or product cutout. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The product image or product cutout file, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"background_color":{"type":"string","description":"The background hex color code for the pack shot. Optionally, use 'transparent' for a transparent background. This parameter is optional.","default":"#FFFFFF"},"force_rmbg":{"type":"boolean","default":false,"description":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels."},"content_moderation":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When enabled, applies content moderation to both input visuals and modified outputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For input images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing stops if the image fails moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a 422 error with details about which parameter failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For output images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the modified image fails moderation, returns a 422 error"},"children":[]}]}]}]}]}}},"id":"schema_146"},"schema_147":{"kind":"json-schema","data":{"type":"object","properties":{"result_url":{"type":"string","description":"The URL of the processed product pack shot image. This is a temporary URL that expires after 1 hour."}}},"id":"schema_147"},"schema_148":{"kind":"json-schema","data":{"type":"object","properties":{"sku":{"type":"string","description":"The Stock Keeping Unit identifier for the product. This parameter is optional."},"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the product image or product cutout. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB. The input image must have a transparent background, could be obtained by using our background removal or cutout features."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The product image or product cutout file, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB. The input image must have a transparent background, could be obtained by using our background removal or cutout features."},"children":[]}]}]}]},"type":{"type":"string","description":"Specifies the type of shadow. It can be 'regular' or 'float'. This parameter is optional.","default":"regular"},"background_color":{"type":"string","description":"The background hex color code for the resulting image. If you would like to get a transparent background, don't include this parameter in the request. This parameter is optional."},"shadow_color":{"type":"string","description":"The shadow color hex code. This parameter is optional.","default":"#000000"},"shadow_offset":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls the position of the shadow relative to the object, in pixels. Accepts a tuple-like list "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"[x, y]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" where x and y can be positive or negative values. This parameter is optional."},"children":[]}]}]}],"items":{"type":"integer"},"default":[0,15]},"shadow_intensity":{"type":"integer","description":"Adjusts the intensity of the shadow. This parameter is optional.","minimum":0,"maximum":100,"default":60},"shadow_blur":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls the blur level of the shadow's edges. This parameter is optional. Default for 'shadow_type'=regular is 15, while for 'shadow_type'=float is 20."},"children":[]}]}]}]},"shadow_width":{"type":"integer","description":"(For floating shadows) Controls the width of the elliptical shadow, in pixels that could be positive and negative. As default the value is according to the width of the product. This parameter is optional."},"shadow_height":{"type":"integer","description":"(For floating shadows) Controls the height of the elliptical shadow, in pixels that could be positive and negative. This parameter is optional.","default":70},"force_rmbg":{"type":"boolean","default":false,"description":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels."},"preserve_alpha":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls whether the alpha channel values from the input image are retained in the output, if the input includes an alpha channel."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true: The output image maintains the original transparency of fully and partially transparent pixels."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When false: The transparency values from the input are not preserved, but the output may still include an alpha channel (e.g., around the cropped area)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Has no effect if the input image does not include an alpha channel."},"children":[]}]}]}]}]},"content_moderation":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When enabled, applies content moderation to both input visuals and modified outputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For input images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing stops if the image fails moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a 422 error with details about which parameter failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For output images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the modified image fails moderation, returns a 422 error"},"children":[]}]}]}]}]}}},"id":"schema_148"},"schema_149":{"kind":"json-schema","data":{"type":"object","properties":{"sku":{"type":"string","description":"The Stock Keeping Unit identifier for the product. This parameter is optional."},"sync":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Determines the response mode. When true, responses are synchronous. With false, responses are asynchronous, immediately providing URLs for images that are generated in the background. It is recommended to use sync=false for optimal performance. When generating more than 1 result, you should use the value false. When placement_type is automatic, sync has to be false."},"children":[]}]}]}]},"mode":{"type":"string","enum":["base","high_control","fast"],"default":"fast","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selects the background-generation mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - clean, high quality backgrounds."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High_control"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - stronger prompt adherence and scene context, finer control over layout and details."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - same core capabilities as base, optimal speed and quality balace."},"children":[]}]}]}]}]},"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the product shot to be placed in a lifestyle shot. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The product shot file to be placed in a lifestyle shot, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"scene_description":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Text description of the new scene or background for the provided product shot. Bria currently supports prompts in English only, excluding special characters."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prompt length guidelines per mode:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"base / fast: ~50–60 words"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high_control: ~90–110 words"},"children":[]}]}]}]}]},"optimize_description":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true, an additional logic takes the scene_description that was included and adjusts it to achieve optimal results. Built with Meta Llama 3."},"children":[]}]}]}]},"num_results":{"type":"integer","default":4,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of lifestyle product shots you would like to generate. You will get num_results x 10 results when placement_type=automatic and according to the number of required placements x num_results if placement_type=manual_placement."},"children":[]}]}]}]},"exclude_elements":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Elements or features that should be excluded from the generated scene. This parameter is optional and is available only when fast=false. Bria currently supports descriptions in English only, excluding special characters."},"children":[]}]}]}]},"placement_type":{"type":"string","default":"original","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This parameter allows you to select the control mode for determining both the product's positioning and the final shot size."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"original\" will preserve the original position of the product in the image. The parameters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original_quality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"padding_values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shot_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be ignored when this mode is used."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"automatic\" will generate results with 7 of the recommended product positions. The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"manual_placement\" will allow you to select predefined positions, using the parameter \"manual_placement_selection\". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"custom_coordinates\" Provides precise control over the size and position of the image using the parameters \"foreground_image_size\" and \"foreground_image_location\". This includes positions outside the canvas, which may result in cropping. The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"manual_padding\" will allow you to control the position and size of the image by defining the desired padding (using 'padding_values') in pixels around the product."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"automatic_aspect_ratio\" will automatically center the product within the canvas and resize the canvas to match the provided "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The parameters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original_quality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"padding_values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shot_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be ignored when this mode is used."},"children":[]}]}]}]}],"enum":["original","automatic","manual_placement","manual_padding","custom_coordinates","automatic_aspect_ratio"]},"original_quality":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This flag is only relevant when placement_type=original. If true, the output image retains the original input image's size; otherwise, the image is scaled to 1 megapixel (1MP) while preserving its aspect ratio."},"children":[]}]}]}]},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the aspect ratio of the output product shot when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic_aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The original image will be automatically positioned and scaled to fit this aspect ratio."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ignored for all other placement types."},"children":[]}]}]}]},"shot_size":{"type":"array","items":{"type":"integer"},"default":[1000,1000],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The desired size of the final product shot. For optimal results, the total number of pixels should be around 1,000,000. This parameter is only relevant when placement_type is automatic, manual_placement or custom_coordinates."},"children":[]}]}]}]},"foreground_image_size":{"type":"array","items":{"type":"integer"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the desired dimensions of the foreground image within the generated output. The size is defined as an array of integers representing [width, height] in pixels. This parameter is only relevant when placement_type is custom_coordinates."},"children":[]}]}]}]},"foreground_image_location":{"type":"array","items":{"type":"integer"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the desired [x, y] coordinates for positioning the foreground image within the full shot. The coordinates represent the upper-left corner of the foreground image. Values can extend outside the shot, in which case the input image will be cropped accordingly. This parameter is only relevant when placement_type is custom_coordinates."},"children":[]}]}]}]},"manual_placement_selection":{"type":"array","items":{"type":"string","enum":["upper_left","upper_right","bottom_left","bottom_right","right_center","left_center","upper_center","bottom_center","center_vertical","center_horizontal"]},"default":["upper_left"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you've selected placement_type=manual_placement, you should use this parameter to specify which placements/positions you would like to use from the list. You can select more than one placement in one request."},"children":[]}]}]}]},"padding_values":{"type":"array","items":{"type":"integer"},"default":[0,0,0,0],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The desired padding in pixels around the product, when using placement_type=manual_padding. The order of the values is [left, right, top, bottom]. For optimal results, the total number of pixels, including padding, should be around 1,000,000. It is recommended to first use the product cutout API, get the cutout and understand the size of the result, and then define the required padding and use the cutout as an input for this API."},"children":[]}]}]}]},"force_rmbg":{"type":"boolean","default":false,"description":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels."},"content_moderation":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When enabled, applies content moderation to both input visuals and modified outputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For input images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing stops at the first image that fails moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a 422 error with details about which parameter failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For synchronous requests (sync=true):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If all modified images fail moderation, returns a 422 error"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If some images pass and others fail, returns a 200 response with successful outputs and \"blocked\" objects for failed ones"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For asynchronous requests (sync=false):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Failed images are replaced with zero-byte files at their placeholder URLs"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Successful images are stored at their original placeholder URLs"},"children":[]}]}]}]}]}}},"id":"schema_149"},"schema_150":{"kind":"json-schema","data":{"type":"object","properties":{"result":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The array contains the results created in the request. In each result, the first value represents the URL of the result, the second value represents the seed, and the third value represents the session id of the result. It will take a few seconds for the image to become available via the URL if sync=false. You can recreate the same result in the future by using the seed as part of the request."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When content_moderation is true:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For synchronous requests (sync=true): Results array will contain both successful generations and \"blocked\" objects for images that failed moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For asynchronous requests (sync=false): Failed images will be replaced with zero-byte files at their placeholder URLs"},"children":[]}]}]}]}],"items":{"type":"array","items":{"type":"string"}}}}},"id":"schema_150"},"schema_151":{"kind":"json-schema","data":{"type":"object","properties":{"sku":{"type":"string","description":"The Stock Keeping Unit identifier for the product. This parameter is optional."},"sync":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Determines the response mode. When true, responses are synchronous. With false, responses are asynchronous, immediately providing URLs for images that are generated in the background. It is recommended to use sync=false for optimal performance. When generating more than 1 result, you should use the value false."},"children":[]}]}]}]},"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the product shot to be placed in a lifestyle shot. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The product shot file to be placed in a lifestyle shot, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"ref_image_urls":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the reference image to be used for generating the lifestyle shot. If both ref_image_urls and ref_image_file are provided, ref_image_urls will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"ref_image_file":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The reference image file to be used for generating the lifestyle shot, in base64 format. Only a single refernce image is supported at the moment. Used if ref_image_urls is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"enhance_ref_image":{"type":"boolean","default":true,"description":"When set to True, enhances the reference image by applying adjustments, such as lighting, shadows, and texture refinements, to produce more realistic and visually cohesive results. When enabled, this may also incorporate subtle elements from the reference image into the generated background for added authenticity."},"ref_image_influence":{"type":"number","format":"float","minimum":0,"maximum":1,"default":1,"description":"Controls the degree of similarity between the generated background and the reference image, where 0.0 produces minimal resemblance and 1.0 creates a highly similar output."},"num_results":{"type":"integer","default":4,"description":"The number of lifestyle product shots you would like to generate."},"placement_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This parameter allows you to select the control mode for determining both the product's positioning and the final shot size."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"original\" will preserve the original position of the product in the image. The parameters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original_quality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"padding_values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shot_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be ignored when this mode is used."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"automatic\" will generate results with 7 of the recommended product positions. The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"manual_placement\" will allow you to select predefined positions, using the parameter \"manual_placement_selection\". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"custom_coordinates\" Provides precise control over the size and position of the image using the parameters \"foreground_image_size\" and \"foreground_image_location\". This includes positions outside the canvas, which may result in cropping. The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"manual_padding\" will allow you to control the position and size of the image by defining the desired padding (using 'padding_values') in pixels around the product."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"automatic_aspect_ratio\" will automatically center the product within the canvas and resize the canvas to match the provided "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The parameters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original_quality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"padding_values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shot_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be ignored when this mode is used."},"children":[]}]}]}]}],"enum":["original","automatic","manual_placement","manual_padding","custom_coordinates","automatic_aspect_ratio"]},"original_quality":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This flag is only relevant when placement_type=original. If true, the output image retains the original input image's size (and not the reference image size); otherwise, the image is scaled to 1 megapixel (1MP) while preserving its aspect ratio."},"children":[]}]}]}]},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the aspect ratio of the output product shot when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic_aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The original image will be automatically positioned and scaled to fit this aspect ratio."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ignored for all other placement types."},"children":[]}]}]}]},"shot_size":{"type":"array","items":{"type":"integer"},"default":[1000,1000],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The desired size of the final product shot. For optimal results, the total number of pixels should be around 1,000,000. This parameter is only relevant when placement_type is automatic,manual_placement or custom_coordinates."},"children":[]}]}]}]},"foreground_image_size":{"type":"array","items":{"type":"integer"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the desired dimensions of the foreground image within the generated output. The size is defined as an array of integers representing [width, height] in pixels. This parameter is only relevant when placement_type is custom_coordinates."},"children":[]}]}]}]},"foreground_image_location":{"type":"array","items":{"type":"integer"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the desired [x, y] coordinates for positioning the foreground image within the full shot. The coordinates represent the upper-left corner of the foreground image. Values can extend outside the shot, in which case the input image will be cropped accordingly. This parameter is only relevant when placement_type is custom_coordinates."},"children":[]}]}]}]},"manual_placement_selection":{"type":"array","items":{"type":"string","enum":["upper_left","upper_right","bottom_left","bottom_right","right_center","left_center","upper_center","bottom_center","center_vertical","center_horizontal"]},"default":["upper_left"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you've selected placement_type=manual_placement, you should use this parameter to specify which placements/positions you would like to use from the list. You can select more than one placement in one request."},"children":[]}]}]}]},"padding_values":{"type":"array","items":{"type":"integer"},"default":[0,0,0,0],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The desired padding in pixels around the product, when using placement_type=manual_padding. The order of the values is [left, right, top, bottom]. For optimal results, the total number of pixels, including padding, should be around 1,000,000. It is recommended to first use the product cutout API, get the cutout and understand the size of the result, and then define the required padding and use the cutout as an input for this API."},"children":[]}]}]}]},"force_rmbg":{"type":"boolean","default":false,"description":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels."},"content_moderation":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When enabled, applies content moderation to both input visuals and modified outputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For input images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing stops at the first image that fails moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a 422 error with details about which parameter failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For synchronous requests (sync=true):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If all modified images fail moderation, returns a 422 error"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If some images pass and others fail, returns a 200 response with successful outputs and \"blocked\" objects for failed ones"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For asynchronous requests (sync=false):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Failed images are replaced with zero-byte files at their placeholder URLs"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Successful images are stored at their original placeholder URLs"},"children":[]}]}]}]}]}}},"id":"schema_151"},"schema_152":{"kind":"json-schema","data":{"type":"object","required":["scene","products"],"properties":{"scene":{"type":"string","description":"Publicly available URL or Base64-encoded image of the scene where the product will be embedded. Accepted formats are jpeg, jpg, png, webp."},"products":{"type":"array","description":"An array where each object defines a product to be embedded and its specific placement within the scene. Supports 1 to N products.","minItems":1,"items":{"type":"object","required":["image","coordinates"],"properties":{"image":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Publicly available URL or Base64-encoded image of the product. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the image contains an alpha channel, no cutout is applied."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the image does not contain an alpha channel, automatic product cutout is applied."},"children":[]}]}]}]}]},"coordinates":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object specifying the exact placement and scaling of the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"cutout product"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" within the scene."},"children":[]}]}]}],"required":["x","y","width","height"],"properties":{"x":{"type":"integer","description":"X-coordinate of the cutout product's top-left corner relative to the scene image."},"y":{"type":"integer","description":"Y-coordinate of the cutout product's top-left corner relative to the scene image."},"width":{"type":"integer","description":"Target width for the tightly cropped product. Ensure this matches the product's aspect ratio to prevent distortion."},"height":{"type":"integer","description":"Target height for the tightly cropped product."}}}}}},"seed":{"type":"integer","description":"Seed for deterministic generation. Uses a random seed if omitted."},"visual_input_content_moderation":{"type":"boolean","default":true,"description":"If true, returns 422 on visual input moderation failure for scene or product."},"visual_output_content_moderation":{"type":"boolean","default":true,"description":"If true, returns 422 on visual output moderation failure."}}},"id":"schema_152"},"schema_153":{"kind":"json-schema","data":{"type":"object","required":["image"],"properties":{"image":{"type":"string","description":"Publicly available URL or Base64-encoded image containing the product to be cut out. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"sync":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the response mode. This parameter is optional."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (default), the request is processed asynchronously: the API immediately returns a status URL to track progress."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", the request is processed synchronously: the API holds the connection open until the process is complete and then returns the final image URL in the response."},"children":[]}]}]}]}]},"sku":{"type":"string","description":"The Stock Keeping Unit identifier for the product. This parameter is optional."},"preserve_alpha":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Controls whether the alpha channel values from the input image are retained in the output, if the input includes an alpha channel."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true: The output image maintains the original transparency of fully and partially transparent pixels."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When false: The transparency values from the input are not preserved, but the output may still include an alpha channel (e.g., around the cropped area)."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Has no effect if the input image does not include an alpha channel."},"children":[]}]}]}]}]},"force_background_detection":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels. Replaces the v1 parameter force_rmbg."},"children":[]}]}]}]},"output_type":{"type":"string","default":"png","enum":["png","jpeg"],"description":"The desired output format. This parameter is optional."},"visual_input_content_moderation":{"type":"boolean","default":false,"description":"If true, applies content moderation to the input image and returns 422 on moderation failure. This parameter is optional."},"visual_input_content_moderation_threshold":{"type":"number","default":80,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Threshold used by the input content moderation check. Applies only when visual_input_content_moderation is enabled."},"children":[]}]}]}]},"visual_output_content_moderation":{"type":"boolean","default":false,"description":"If true, applies content moderation to the output image and returns 422 on moderation failure. This parameter is optional."},"visual_output_content_moderation_threshold":{"type":"number","default":80,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Threshold used by the output content moderation check. Applies only when visual_output_content_moderation is enabled."},"children":[]}]}]}]},"webhook_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional URL for receiving the result via webhook when the async job completes. See "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://docs.bria.ai/webhooks"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Webhooks"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}}},"id":"schema_153"},"schema_154":{"kind":"json-schema","data":{"type":"object","properties":{"request_id":{"type":"string","description":"Unique identifier of the request."},"result":{"type":"object","properties":{"image_url":{"type":"string","description":"The URL of the processed product cutout image."}}}}},"id":"schema_154"},"schema_155":{"kind":"json-schema","data":{"type":"object","properties":{"request_id":{"type":"string","description":"Unique identifier of the request."},"status_url":{"type":"string","description":"URL for tracking the request status and retrieving the final result."}}},"id":"schema_155"},"schema_156":{"kind":"json-schema","data":{"type":"object","properties":{"request_id":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"},"details":{"type":"string"}}}}},"id":"schema_156"},"schema_157":{"kind":"json-schema","data":{"type":"object","properties":{"sync":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Determines the response mode. When true, responses are synchronous. With false, responses are asynchronous, immediately providing URLs for images that are generated in the background. It is recommended to use sync=false for optimal performance. When generating more than 1 result, you should use the value false. When placement_type is automatic, sync has to be false."},"children":[]}]}]}]},"mode":{"type":"string","enum":["base","high_control","fast"],"default":"high_control","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selects the background-generation mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - clean, high quality backgrounds."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High_control"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - stronger prompt adherence and scene context, finer control over layout and details."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Fast"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" - same core capabilities as base, optimal speed and quality balace."},"children":[]}]}]}]}]},"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the vehicle to be placed in the shot. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The vehicle file to be placed in the shot, in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Maximum file size 12MB."},"children":[]}]}]}]},"scene_description":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Text description of the new scene or background for the provided vehicle shot. Bria currently supports prompts in English only, excluding special characters."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prompt length guidelines per mode:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"base / fast: ~50–60 words"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"high_control: ~90–110 words"},"children":[]}]}]}]}]},"optimize_description":{"type":"boolean","default":true,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When true, an additional logic takes the scene_description that was included and adjusts it to achieve optimal results. Built with Meta Llama 3."},"children":[]}]}]}]},"num_results":{"type":"integer","default":4,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The number of vehicle shots you would like to generate. You will get num_results x 10 results when placement_type=automatic and according to the number of required placements x num_results if placement_type=manual_placement."},"children":[]}]}]}]},"exclude_elements":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Elements or features that should be excluded from the generated scene. This parameter is optional and is available only when fast=false. Bria currently supports descriptions in English only, excluding special characters."},"children":[]}]}]}]},"placement_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This parameter allows you to select the control mode for determining both the product's positioning and the final shot size."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"original\" will preserve the original position of the product in the image. The parameters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original_quality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"padding_values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shot_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be ignored when this mode is used."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"automatic\" will generate results with 7 of the recommended product positions. The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"manual_placement\" will allow you to select predefined positions, using the parameter \"manual_placement_selection\". The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"custom_coordinates\" Provides precise control over the size and position of the image using the parameters \"foreground_image_size\" and \"foreground_image_location\". This includes positions outside the canvas, which may result in cropping. The shot_size is defined by the 'shot_size' parameter."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"manual_padding\" will allow you to control the position and size of the image by defining the desired padding (using 'padding_values') in pixels around the product."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"automatic_aspect_ratio\" will automatically center the product within the canvas and resize the canvas to match the provided "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The parameters "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"original_quality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"foreground_image_location"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"manual_placement_selection"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"padding_values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"shot_size"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be ignored when this mode is used."},"children":[]}]}]}]}],"enum":["original","automatic","manual_placement","manual_padding","custom_coordinates","automatic_aspect_ratio"]},"original_quality":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This flag is only relevant when placement_type=original. If true, the output image retains the original input image's size; otherwise, the image is scaled to 1 megapixel (1MP) while preserving its aspect ratio."},"children":[]}]}]}]},"aspect_ratio":{"type":"string","enum":["1:1","2:3","3:2","3:4","4:3","4:5","5:4","9:16","16:9"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the aspect ratio of the output product shot when "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"placement_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"automatic_aspect_ratio"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The original image will be automatically positioned and scaled to fit this aspect ratio."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ignored for all other placement types."},"children":[]}]}]}]},"shot_size":{"type":"array","items":{"type":"integer"},"default":[1000,1000],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The desired size of the final product shot. For optimal results, the total number of pixels should be around 1,000,000. This parameter is only relevant when placement_type is automatic,manual_placement or custom_coordinates."},"children":[]}]}]}]},"foreground_image_size":{"type":"array","items":{"type":"integer"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the desired dimensions of the foreground image within the generated output. The size is defined as an array of integers representing [width, height] in pixels. This parameter is only relevant when placement_type is custom_coordinates."},"children":[]}]}]}]},"foreground_image_location":{"type":"array","items":{"type":"integer"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Specifies the desired [x, y] coordinates for positioning the foreground image within the full shot. The coordinates represent the upper-left corner of the foreground image. Values can extend outside the shot, in which case the input image will be cropped accordingly. This parameter is only relevant when placement_type is custom_coordinates."},"children":[]}]}]}]},"manual_placement_selection":{"type":"array","items":{"type":"string","enum":["upper_left","upper_right","bottom_left","bottom_right","right_center","left_center","upper_center","bottom_center","center_vertical","center_horizontal"]},"default":["upper_left"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you've selected placement_type=manual_placement, you should use this parameter to specify which placements/positions you would like to use from the list. You can select more than one placement in one request."},"children":[]}]}]}]},"padding_values":{"type":"array","items":{"type":"integer"},"default":[0,0,0,0],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The desired padding in pixels around the product, when using placement_type=manual_padding. The order of the values is [left, right, top, bottom]. For optimal results, the total number of pixels, including padding, should be around 1,000,000. It is recommended to first use the product cutout API, get the cutout and understand the size of the result, and then define the required padding and use the cutout as an input for this API."},"children":[]}]}]}]},"force_rmbg":{"type":"boolean","default":false,"description":"Forces background removal, even if the original image already contains an alpha channel. Useful for refining existing foreground/background separation or ignoring unnecessary alpha channels."},"content_moderation":{"type":"boolean","default":false,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When enabled, applies content moderation to both input visuals and modified outputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For input images:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Processing stops at the first image that fails moderation"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a 422 error with details about which parameter failed"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For synchronous requests (sync=true):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If all modified images fail moderation, returns a 422 error"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If some images pass and others fail, returns a 200 response with successful outputs and \"blocked\" objects for failed ones"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For asynchronous requests (sync=false):"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Failed images are replaced with zero-byte files at their placeholder URLs"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Successful images are stored at their original placeholder URLs"},"children":[]}]}]}]}]}}},"id":"schema_157"},"schema_158":{"kind":"json-schema","data":{"type":"object","properties":{"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the image containing the vehicle to segment. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Max file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Base64-encoded image containing the vehicle to segment. Used only if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Max file size 12MB."},"children":[]}]}]}]}}},"id":"schema_158"},"schema_159":{"kind":"json-schema","data":{"type":"object","properties":{"windshield":{"type":"string","description":"URL to the PNG mask of the windshield. Empty string if not detected."},"rear_window":{"type":"string","description":"URL to the PNG mask of the rear window. Empty string if not detected."},"side_windows":{"type":"string","description":"URL to the PNG mask of the side windows. Empty string if not detected."},"body":{"type":"string","description":"URL to the PNG mask of the vehicle body. Empty string if not detected."},"wheels":{"type":"string","description":"URL to the PNG mask of all visible wheels. Empty string if not detected."},"hubcap":{"type":"string","description":"URL to the PNG mask of all visible hubcaps. Empty string if not detected."},"tires":{"type":"string","description":"URL to the PNG mask of all visible hubcaps. Empty string if not detected."}}},"id":"schema_159"},"schema_160":{"kind":"json-schema","data":{"type":"object","properties":{"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the vehicle shot. If both image_url and file are provided, image_url will be used. Accepted formats are jpeg, jpg, png, webp. Max file size 12MB."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The vehicle shot file in base64 format. Used only if image_url is not provided. Accepted formats are jpeg, jpg, png, webp. Max file size 12MB."},"children":[]}]}]}]},"masks":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object containing URLs to binary masks for each region to apply reflections on. Accepted keys are "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"windshield"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rear_window"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"side_windows"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"body"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"wheels"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"layers":{"type":"boolean","description":"If true, returns separate images per region along with the full composite. If false, only the full image is returned."},"seed":{"type":"integer","description":"Optional seed for consistent reflection results."}}},"id":"schema_160"},"schema_161":{"kind":"json-schema","data":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the image with reflections applied."},"seed":{"type":"integer","description":"The seed used to generate the reflections."},"layers":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returned only when layers=true. Contains region-specific reflection images."},"children":[]}]}]}],"additionalProperties":{"type":"string"}}}},"id":"schema_161"},"schema_162":{"kind":"json-schema","data":{"type":"object","properties":{"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the image containing the vehicle. If both image_url and file are provided, image_url takes precedence. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The image file in base64 format. Used only if image_url is not provided. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]}]},"masks":{"type":"object","description":"An object containing the URLs of binary masks for the wheels and hubcaps.","properties":{"tires":{"type":"string","description":"Binary mask URL for the tires."}}},"layers":{"type":"boolean","description":"If true, returns only the refined wheels layer. If false, returns the full image with refined wheels."}}},"id":"schema_162"},"schema_163":{"kind":"json-schema","data":{"type":"object","properties":{"url":{"type":"string","description":"URL of the full image with refined wheels."},"layer_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the separate refined wheels layer. Only returned if layers=true."},"children":[]}]}]}]},"seed":{"type":"integer","description":"Optional seed used for generation."}}},"id":"schema_163"},"schema_164":{"kind":"json-schema","data":{"type":"object","properties":{"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the vehicle image. If both image_url and file are provided, image_url is used. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The vehicle image in base64 format. Used if image_url is not provided. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]}]},"effect":{"type":"string","description":"The visual effect to apply to the image. Supported values are dust, snow, fog, light leaks, lens flare."},"layers":{"type":"boolean","default":false,"description":"If true, returns only the effect layer. If false, returns the full image with the effect composited."},"seed":{"type":"integer","description":"Optional seed for generating consistent effect variations."}}},"id":"schema_164"},"schema_165":{"kind":"json-schema","data":{"type":"object","properties":{"url":{"type":"string","description":"URL of the image with the effect applied."},"layer_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the effect layer. Only returned if layers=true."},"children":[]}]}]}]},"seed":{"type":"integer","description":"Seed used for effect generation."}}},"id":"schema_165"},"schema_166":{"kind":"json-schema","data":{"type":"object","properties":{"image_url":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the vehicle image. If both image_url and file are provided, image_url takes precedence. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]}]},"file":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The vehicle image in base64 format. Used only if image_url is not provided. Accepted formats are jpeg, jpg, png, webp."},"children":[]}]}]}]},"preset":{"type":"string","description":"The preset to apply. Supported values are warm-day, cold-day, warm-night, cold-night."}}},"id":"schema_166"},"schema_167":{"kind":"json-schema","data":{"type":"object","properties":{"url":{"type":"string","description":"URL of the image with the preset applied."}}},"id":"schema_167"}},"exampleStore":{"paths/~1product~1cutout/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://labs-assets.bria.ai/sandbox-example-inputs/product_cutout_example_image.jpg"},"id":"paths/~1product~1cutout/post/requestBody/content/application~1json/example"},"paths/~1product~1cutout/post/responses/200/content/application~1json/example":{"value":{"result_url":"URL"},"id":"paths/~1product~1cutout/post/responses/200/content/application~1json/example"},"paths/~1product~1cutout/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1cutout/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1cutout/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1cutout/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1cutout/post/responses/422/content/application~1json/examples/input_violation":{"value":"The request could not be completed because the visual in the '{parameter_name}' parameter did not pass content moderation.","key":"input_violation","summary":"input_violation","id":"paths/~1product~1cutout/post/responses/422/content/application~1json/examples/input_violation"},"paths/~1product~1cutout/post/responses/422/content/application~1json/examples/output_violation":{"value":"The request could not be completed because the modified visual did not pass content moderation.","key":"output_violation","summary":"output_violation","id":"paths/~1product~1cutout/post/responses/422/content/application~1json/examples/output_violation"},"paths/~1product~1packshot/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://labs-assets.bria.ai/sandbox-example-inputs/product_packshot_example_image.jpg","background_color":"#FFFFFF"},"id":"paths/~1product~1packshot/post/requestBody/content/application~1json/example"},"paths/~1product~1packshot/post/responses/200/content/application~1json/example":{"value":{"result_url":"URL"},"id":"paths/~1product~1packshot/post/responses/200/content/application~1json/example"},"paths/~1product~1packshot/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1packshot/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1packshot/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1packshot/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1packshot/post/responses/422/content/application~1json/examples/input_violation":{"value":"The request could not be completed because the visual in the '{parameter_name}' parameter did not pass content moderation.","key":"input_violation","summary":"input_violation","id":"paths/~1product~1packshot/post/responses/422/content/application~1json/examples/input_violation"},"paths/~1product~1packshot/post/responses/422/content/application~1json/examples/output_violation":{"value":"The request could not be completed because the modified visual did not pass content moderation.","key":"output_violation","summary":"output_violation","id":"paths/~1product~1packshot/post/responses/422/content/application~1json/examples/output_violation"},"paths/~1product~1shadow/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://i.ibb.co/p6VjyrfY/6901921e-8856-4fbd-b344-b5e88bcf90e6.png"},"id":"paths/~1product~1shadow/post/requestBody/content/application~1json/example"},"paths/~1product~1shadow/post/responses/200/content/application~1json/example":{"value":{"result_url":"URL"},"id":"paths/~1product~1shadow/post/responses/200/content/application~1json/example"},"paths/~1product~1shadow/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1shadow/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1shadow/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1shadow/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1shadow/post/responses/422/content/application~1json/examples/input_violation":{"value":"The request could not be completed because the visual in the '{parameter_name}' parameter did not pass content moderation.","key":"input_violation","summary":"input_violation","id":"paths/~1product~1shadow/post/responses/422/content/application~1json/examples/input_violation"},"paths/~1product~1shadow/post/responses/422/content/application~1json/examples/output_violation":{"value":"The request could not be completed because the modified visual did not pass content moderation.","key":"output_violation","summary":"output_violation","id":"paths/~1product~1shadow/post/responses/422/content/application~1json/examples/output_violation"},"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement":{"value":{"image_url":"URL","mode":"high_control","scene_description":"In a living room interior, on a kitchen counter","placement_type":"original","num_results":2,"original_quality":true,"optimize_description":true,"sync":true},"key":"Original placement","summary":"Original placement","id":"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Original placement"},"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements":{"value":{"image_url":"URL","scene_description":"in a living room interior, on a kitchen counter","placement_type":"automatic","shot_size":[900,550],"num_results":1,"optimize_description":true},"key":"Automatic placements","summary":"Automatic placements","id":"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic placements"},"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list":{"value":{"image_url":"URL","scene_description":"in a living room interior, on a kitchen counter","placement_type":"manual_placement","shot_size":[900,550],"manual_placement_selection":["upper_center","bottom_center"],"num_results":2,"optimize_description":true,"sync":true},"key":"Manual placement from a list","summary":"Manual placement from a list","id":"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual placement from a list"},"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates":{"value":{"image_url":"URL","scene_description":"in a living room interior, on a kitchen counter","placement_type":"custom_coordinates","foreground_image_size":[500,500],"foreground_image_location":[100,100],"shot_size":[1000,1000],"num_results":2,"optimize_description":true,"sync":true},"key":"Custom Coordinates","summary":"Custom Coordinates","id":"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Custom Coordinates"},"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding":{"value":{"image_url":"URL","scene_description":"in a living room interior, on a kitchen counter","placement_type":"manual_padding","padding_values":[20,30,20,30],"num_results":2,"optimize_description":true,"sync":true},"key":"Manual padding","summary":"Manual padding","id":"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Manual padding"},"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio":{"value":{"image_url":"URL","scene_description":"In a living room interior, on a kitchen counter","placement_type":"automatic_aspect_ratio","aspect_ratio":"4:3","num_results":2,"optimize_description":true,"sync":true},"key":"Automatic Aspect Ratio","summary":"Automatic Aspect Ratio","id":"paths/~1product~1lifestyle_shot_by_text/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"},"paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/success":{"value":{"result":[["https://storage.server/outputs/valid_output_1.jpeg","123111","valid_output_1.jpeg"],["https://storage.server/outputs/valid_output_2.jpeg","123222","valid_output_2.jpeg"]]},"key":"success","summary":"success","id":"paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/success"},"paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/partial_success":{"value":{"result":[["https://storage.server/outputs/valid_output_1.jpeg","123111","valid_output_1.jpeg"],["blocked:true","error_code:422","description:The request could not be completed because the modified visual did not pass content moderation."]]},"key":"partial_success","summary":"partial_success","id":"paths/~1product~1lifestyle_shot_by_text/post/responses/200/content/application~1json/examples/partial_success"},"paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1lifestyle_shot_by_text/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/input_violation":{"value":"The request could not be completed because the visual in the '{parameter_name}' parameter did not pass content moderation.","key":"input_violation","summary":"input_violation","id":"paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/input_violation"},"paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked":{"value":"The request could not be completed because all modified visuals failed content moderation.","key":"all_outputs_blocked","summary":"all_outputs_blocked","id":"paths/~1product~1lifestyle_shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"},"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement":{"value":{"image_url":"URL","ref_image_urls":"URL","placement_type":"original","num_results":2,"original_quality":true,"sync":true},"key":"Original placement","summary":"Original placement","id":"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Original placement"},"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements":{"value":{"image_url":"URL","ref_image_urls":"URL","placement_type":"automatic","shot_size":[900,550],"num_results":1},"key":"Automatic placements","summary":"Automatic placements","id":"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic placements"},"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list":{"value":{"image_url":"URL","ref_image_urls":"URL","placement_type":"manual_placement","shot_size":[900,550],"manual_placement_selection":["upper_center","bottom_center"],"num_results":2,"sync":true},"key":"Manual placement from a list","summary":"Manual placement from a list","id":"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual placement from a list"},"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates":{"value":{"image_url":"URL","ref_image_urls":"URL","placement_type":"custom_coordinates","foreground_image_size":[500,500],"foreground_image_location":[100,100],"shot_size":[1000,1000],"num_results":2,"sync":true},"key":"Custom Coordinates","summary":"Custom Coordinates","id":"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Custom Coordinates"},"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding":{"value":{"image_url":"URL","ref_image_urls":"URL","placement_type":"manual_padding","padding_values":[20,30,20,30],"num_results":2,"optimize_description":true,"sync":true},"key":"Manual padding","summary":"Manual padding","id":"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Manual padding"},"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio":{"value":{"image_url":"URL","ref_image_urls":"URL","placement_type":"automatic_aspect_ratio","aspect_ratio":"4:3","num_results":2,"sync":true},"key":"Automatic Aspect Ratio","summary":"Automatic Aspect Ratio","id":"paths/~1product~1lifestyle_shot_by_image/post/requestBody/content/application~1json/examples/Automatic Aspect Ratio"},"paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/success":{"value":{"result":[["https://storage.server/outputs/valid_output_1.jpeg","123111","valid_output_1.jpeg"],["https://storage.server/outputs/valid_output_2.jpeg","123222","valid_output_2.jpeg"]]},"key":"success","summary":"success","id":"paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/success"},"paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/partial_success":{"value":{"result":[["https://storage.server/outputs/valid_output_1.jpeg","123111","valid_output_1.jpeg"],["blocked:true","error_code:422","description:The request could not be completed because the modified visual did not pass content moderation."]]},"key":"partial_success","summary":"partial_success","id":"paths/~1product~1lifestyle_shot_by_image/post/responses/200/content/application~1json/examples/partial_success"},"paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1lifestyle_shot_by_image/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/input_violation":{"value":"The request could not be completed because the visual in the '{parameter_name}' parameter did not pass content moderation.","key":"input_violation","summary":"input_violation","id":"paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/input_violation"},"paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/all_outputs_blocked":{"value":"The request could not be completed because all modified visuals failed content moderation.","key":"all_outputs_blocked","summary":"all_outputs_blocked","id":"paths/~1product~1lifestyle_shot_by_image/post/responses/422/content/application~1json/examples/all_outputs_blocked"},"paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example":{"value":{"image":"https://labs-assets.bria.ai/sandbox-example-inputs/product_cutout_example_image.jpg"},"id":"paths/~1image~1edit~1product~1cutout/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example":{"value":{"image_url":"URL","mode":"high_control","scene_description":"A vehicle on a coastal road at sunset","placement_type":"original","num_results":2,"original_quality":true,"optimize_description":true,"sync":true},"id":"paths/~1product~1vehicle~1shot_by_text/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/success":{"value":{"result":[["https://storage.server/outputs/valid_output_1.jpeg","123111","valid_output_1.jpeg"],["https://storage.server/outputs/valid_output_2.jpeg","123222","valid_output_2.jpeg"]]},"key":"success","summary":"success","id":"paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/success"},"paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/partial_success":{"value":{"result":[["https://storage.server/outputs/valid_output_1.jpeg","123111","valid_output_1.jpeg"],["blocked:true","error_code:422","description:The request could not be completed because the modified visual did not pass content moderation."]]},"key":"partial_success","summary":"partial_success","id":"paths/~1product~1vehicle~1shot_by_text/post/responses/200/content/application~1json/examples/partial_success"},"paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1vehicle~1shot_by_text/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/input_violation":{"value":"The request could not be completed because the visual in the '{parameter_name}' parameter did not pass content moderation.","key":"input_violation","summary":"input_violation","id":"paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/input_violation"},"paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked":{"value":"The request could not be completed because all modified visuals failed content moderation.","key":"all_outputs_blocked","summary":"all_outputs_blocked","id":"paths/~1product~1vehicle~1shot_by_text/post/responses/422/content/application~1json/examples/all_outputs_blocked"},"paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://example.com/car.jpeg"},"id":"paths/~1product~1vehicle~1segment/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1segment/post/responses/200/content/application~1json/examples/success":{"value":{"windshield":"https://example.com/masks/windshield.png","rear_window":"","side_windows":"https://example.com/masks/side_windows.png","body":"https://example.com/masks/body.png","wheels":"https://example.com/masks/wheels.png","hubcap":"https://example.com/masks/hubcap.png","tires":"https://example.com/masks/tires.png"},"key":"success","summary":"success","id":"paths/~1product~1vehicle~1segment/post/responses/200/content/application~1json/examples/success"},"paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1vehicle~1segment/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://example.com/car.jpg","masks":{"windshield":"https://example.com/masks/windshield.png","side_windows":"https://example.com/masks/side_windows.png","body":"https://example.com/masks/body.png","wheels":"https://example.com/masks/wheels.png"},"layers":true,"seed":42},"id":"paths/~1product~1vehicle~1generate_reflections/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_false":{"value":{"url":"https://example.com/results/full_image_with_reflections.png","seed":123},"key":"layers_false","summary":"layers_false","id":"paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_false"},"paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_true":{"value":{"url":"https://example.com/results/full_image_with_reflections.png","seed":123,"layers":{"windshield":"https://example.com/reflections/windshield.png","rear_window":null,"side_windows":"https://example.com/reflections/side_windows.png","body":"https://example.com/reflections/body.png","wheels":"https://example.com/reflections/wheels.png"}},"key":"layers_true","summary":"layers_true","id":"paths/~1product~1vehicle~1generate_reflections/post/responses/200/content/application~1json/examples/layers_true"},"paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1vehicle~1generate_reflections/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://example.com/car.jpg","masks":{"tires":"https://example.com/masks/tires.png"},"layers":true},"id":"paths/~1product~1vehicle~1refine_tires/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_false":{"value":{"url":"https://example.com/results/full_image_refined_1.png","seed":123},"key":"layers_false","summary":"layers_false","id":"paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_false"},"paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_true":{"value":{"url":"https://example.com/results/full_image_refined_1.png","layer_url":"https://example.com/results/wheels_layer.png","seed":123},"key":"layers_true","summary":"layers_true","id":"paths/~1product~1vehicle~1refine_tires/post/responses/200/content/application~1json/examples/layers_true"},"paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1vehicle~1refine_tires/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://example.com/vehicle.jpg","effect":"fog","layers":false,"seed":42},"id":"paths/~1product~1vehicle~1apply_effect/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_false":{"value":{"url":"https://example.com/results/full_image_refined_1.png","seed":123},"key":"layers_false","summary":"layers_false","id":"paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_false"},"paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_true":{"value":{"url":"https://example.com/results/full_image_refined_1.png","layer_url":"https://example.com/results/effect_layer.png","seed":123},"key":"layers_true","summary":"layers_true","id":"paths/~1product~1vehicle~1apply_effect/post/responses/200/content/application~1json/examples/layers_true"},"paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1vehicle~1apply_effect/post/responses/403/content/application~1json/examples/access_denied"},"paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example":{"value":{"image_url":"https://example.com/images/car_side_view.png","preset":"cold-day"},"id":"paths/~1product~1vehicle~1harmonize/post/requestBody/content/application~1json/example"},"paths/~1product~1vehicle~1harmonize/post/responses/200/content/application~1json/example":{"value":{"url":"https://example.com/results/full_image_refined_1.png"},"id":"paths/~1product~1vehicle~1harmonize/post/responses/200/content/application~1json/example"},"paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/quota_exceeded":{"value":"Quota exceeded: Free users can make up to 1000 requests in total. Please upgrade your plan to continue using the service.","key":"quota_exceeded","summary":"quota_exceeded","id":"paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/quota_exceeded"},"paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/access_denied":{"value":"Access denied: Your subscription does not include access to this feature/product.","key":"access_denied","summary":"access_denied","id":"paths/~1product~1vehicle~1harmonize/post/responses/403/content/application~1json/examples/access_denied"}},"securitySchemeStore":{},"servers":[{"url":"https://engine.prod.bria-api.com/v1"}]},"options":{"hideSidebar":true,"mockServer":{"url":"/_mock/product-shot-editing","position":"off","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/product-shot-editing.json?download"},{"url":"/_bundle/product-shot-editing.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Product Shot API Reference","description":"Below you will find the technical specifications, request schemas, and response models for our endpoints. \n \nChoose an endpoint from the sidebar to view code samples and run test requests. \n"}},"baseSlug":"/product-shot-editing","routesMapping":{}}