# \[Preview] Text-Guided Segmentation {% hint style="warning" %} Warning: Text-Guided Segmentation is available as a preview feature. As such, please be aware that there could be breaking changes with a 2-week notice period. {% endhint %} Text-Guided Segmentation allows you to have more control over which parts of the input image should be kept by the segmentation mode and which parts should be removed. Text-Guided segmentation is controlled through 3 parameters: * `segmentation.prompt`: A textual description of what the segmentation should keep. (required, comma separated values are allowed, use singular rather than plural) * `segmentation.negativePrompt`: A textual description of what the segmentation should remove. (optional, comma separated values are allowed, use singular rather than plural) * `segmentation.mode`: When set to `keepSalientObject`, the salient object of the image (i.e. what the default segmentation would have kept) will also be kept by the segmentation. (optional) {% hint style="info" %} For the arguments `segmentation.prompt` and `segmentation.negativePrompt`, please use the singular rather than the plural. (e.g. `laptop` rather than `laptops`) If you want the segmentation to keep a person, we recommend setting `segmentation.mode=keepSalientObject` rather than `segmentation.prompt=person`. (the reason why is that the `prompt` is currently is less performant when dealing with fine details, like hair) {% endhint %} To help better understand how the feature works, here are some examples:


	(original image)
	(default segmentation)
	`segmentation.prompt=laptop`
	`segmentation.prompt=memory card`
	`segmentation.prompt=laptop, hand, arm`


	(original image)
	(default segmentation)
	`segmentation.prompt=tee-shirt` and `segmentation.negativePrompt=hanger`

If you want to give it a try, here are some code snippets to reproduce the examples above: ```bash curl --request POST \ --url https://image-api.photoroom.com/v2/edit \ --header 'x-api-key: YOUR_API_KEY' \ --form 'imageFile=@"/path/to/image.jpeg"' \ --form 'referenceBox="originalImage"' \ --form 'segmentation.prompt="laptop, hand, arm"' \ --output result-laptop-hand-arm.png ``` Try it now! ```bash curl --request POST \ --url https://image-api.photoroom.com/v2/edit \ --header 'x-api-key: YOUR_API_KEY' \ --form 'imageFile=@"/path/to/image.jpeg"' \ --form 'referenceBox="originalImage"' \ --form 'segmentation.prompt="tee-shirt"' \ --form 'segmentation.negativePrompt="hanger"' \ --output result-tee-shirt-no-hanger.png ``` Try it now! --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.photoroom.com/image-editing-api-plus-plan/preview-text-guided-segmentation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.