> For the complete documentation index, see [llms.txt](https://docs.quickqr.art/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quickqr.art/apis/http-api-reference/predictions/outpainting.md).

# Outpainting

## Submit an outpainting request

<mark style="color:blue;">`GET`</mark> `https://api.quickqr.art/v1/predictions/queue`

#### Headers

| Name                                        | Type   | Description     |
| ------------------------------------------- | ------ | --------------- |
| x-api-key<mark style="color:red;">\*</mark> | String | \<your-api-key> |

#### Request Body

| Name                                              | Type     | Description                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| workflow<mark style="color:red;">\*</mark>        | String   | Fixed value: `outpainting`                                                                                                                                                                                                                                                                                                                                                                                       |
| image<mark style="color:red;">\*</mark>           | String   | The url to origin image to paint out.                                                                                                                                                                                                                                                                                                                                                                            |
| prompt                                            | String   | The prompt to generate. If not provided, we will generate a summary of your image by our AI model.                                                                                                                                                                                                                                                                                                               |
| negativePrompt                                    | String   | The negative prompt (what you don't want to see in the generated images.)                                                                                                                                                                                                                                                                                                                                        |
| seed                                              | integer  | <p>Seed number to create a field of visual noise, similar to television static, as a starting point for generating the initial image grids.</p><p>Range: <code>0-9007199254740991</code></p><p>Default value: <code>random</code></p>                                                                                                                                                                            |
| image\_width<mark style="color:red;">\*</mark>    | integer  | The width of original image. We will use it to resize the input image before paint.                                                                                                                                                                                                                                                                                                                              |
| image\_height<mark style="color:red;">\*</mark>   | integer  | The height of original image. We will use it to resize the input image before paint.                                                                                                                                                                                                                                                                                                                             |
| padding\_left<mark style="color:red;">\*</mark>   | interger | Padding left.                                                                                                                                                                                                                                                                                                                                                                                                    |
| padding\_bottom<mark style="color:red;">\*</mark> | interger | Padding bottom.                                                                                                                                                                                                                                                                                                                                                                                                  |
| padding\_top<mark style="color:red;">\*</mark>    | interger | Padding top.                                                                                                                                                                                                                                                                                                                                                                                                     |
| padding\_right<mark style="color:red;">\*</mark>  | interger | Padding right.                                                                                                                                                                                                                                                                                                                                                                                                   |
| type<mark style="color:red;">\*</mark>            | String   | <p>There are 2 types:</p><p><code>one\_shot</code>: do less steps, cheaper.</p><p><code>multi\_shots</code>: do more steps, expensiver.</p>                                                                                                                                                                                                                                                                      |
| webhook                                           | String   | An HTTPS URL for receiving a webhook when the prediction has new output. The webhook will be a POST request where the request body is the same as the response body of the [get prediction](https://docs.quickqr.art/apis/http-api-reference/predictions#get-a-prediction) operation. If there are network problems, we will retry the webhook a few times, so make sure it can be safely called more than once. |

Example curl request:

```bash
curl --location 'https://api.quickqr.art/v1/predictions/queue' \
--header 'x-api-key: <Insert your api key>' \
--header 'Content-Type: application/json' \
--data '{
    "workflow": "outpainting",
    "image": "https://delivery.quickqr.art/qr-v4/a80203d68e4248699de3592ca2ef62fc-20231203103444.png",
    "prompt": "best quality, masterpiece, depth of field, beautiful woman, big dress, trees, flowers, sky, water",
    "negativePrompt": "",
    "seed": 2800163943969242,
    "image_width": 512,
    "image_height": 512,
    "padding_left": 512,
    "padding_right": 512,
    "padding_top": 512,
    "padding_bottom": 512,
    "type": "multi_shots"
}
'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.quickqr.art/apis/http-api-reference/predictions/outpainting.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.