# Quickstart Guide

## Who is this API for?

The Remove Background API allows you to isolate the subject of an image by removing the background of the image.

Using this API is appropriate if you only need to remove the background of your image, and don't need to perform any additional edits.

The quality of the background removal will be the same than that of the [Image Editing API](/image-editing-api-plus-plan/quickstart-guide.md).&#x20;

However, because this API only performs background removal, its response time will be faster. Data on median and p90 response times is [available here](https://photoroomapi.statuspage.io).

{% hint style="info" %}
For additional information about the important features to look for in image background removal technology, you can [consult this blog article](https://www.photoroom.com/blog/image-background-removal-technology-comparison).
{% endhint %}

## How do I make my first API call?

To call the Remove Background API and remove the background of an image, you can run the following code in your terminal:

```bash
curl --request POST \
  --url https://sdk.photoroom.com/v1/segment \
  --header 'x-api-key: YOUR_API_KEY' \
  --form image_file=@/path/to/your/image.jpg \
  --output photoroom-result.png
```

{% hint style="info" %}
If you don't have an API key, here are the [steps to create yours](/getting-started/introduction.md#how-can-i-get-my-api-key).
{% endhint %}

To go further, you can visit the [API Reference](/getting-started/api-reference-openapi.md#post-v1-segment) to learn about all the available parameters (`format`, `channels`, `bg_color`, `size`, `crop`).

## Will the API make alterations to my products?

No, the Remove Background API will only remove the background and will not make any change to the actual pixels of the original image.

Consequently, it cannot make alterations to your products, such as modifying a logo or a brand name.

{% hint style="info" %}
Please note that the feature [Green Screen Despill](/remove-background-api-basic-plan/green-screen-despill.md) can, however, alter colors.
{% endhint %}


---

# 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/remove-background-api-basic-plan/quickstart-guide.md?ask=<question>
```

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.
