> For the complete documentation index, see [llms.txt](https://help.pixboost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.pixboost.com/api/background-prompt.md).

# Background AI Prompt

API endpoint - `/api/2/img/[IMAGE-URL]/prompt/background`

## Description

**/prompt/background** - generates prompts that could be used in image transformation API using `?background` query parameter.

Without any parameters, API will generate JSON with four prompts with plain text and encoded outputs. Encoded output is what can be passed into `?background` query parameter.

## Parameters

**auth** (**required**) - [API secret](/setup/api-secrets.md) that's used for authentication.

**theme** (optional) - theme that is used for prompt generation. It could be either a generic short theme or a full custom prompt. When the parameter is used, then the first prompt in the output will be the exact "theme" included encoded version.

## Examples

Image used for the prompt

![](https://pixboost.com/api/2/img/https://pixboost.com/img/demos/tshirt.jpg/asis?auth=MTA0ODU5NDA0NQ__)

API call to generate prompt: `https://pixboost.com/api/2/img/https://pixboost.com/img/demos/tshirt.jpg/prompt/background?auth=[API_SECRET]`

`encoded` field is what can be passed into transformation API.

Output:

```json
[
    {
        "text": "An urban concrete plaza with minimalist architecture at sunset. Warm golden hour light casting long, soft shadows. Shallow depth of field, clean lines, elegant bokeh in the background.",
        "encoded": "knhZyK4t9qsJA1GkjhnMzAKI%2BsXSnQtPxI0FOzUhMTsMzDdw2agZ%2B0yfr8qmEWfVyAzh%2FPA918l4kgru4geEA90Om2ImRrYyfJ7e0Iho9%2BNlQnlqlI5DRk6IVNKorvZ421xVSLxdZi%2B1dZYDcw5y%2Bk7jAWLg9Js9rRh1FdbU617C2FXsSWSUFgwVJntnq1dgGYXx6VctvDLwTfLhaNgc0WhB8%2FAmIETVpSJCKXwp3Fzo9WxnRB42me57Z6UNC%2B8DojE9us4YDGWqhVmyV1Q4cVz%2FGr8%3D"
    },
    {
        "text": "A sun-drenched coastal rooftop terrace at golden hour. Out-of-focus ocean and distant modern skyline. Soft, warm ambient light, high-end lifestyle vibe, shallow depth of field.",
        "encoded": "uP41RpNXujw7EZxBjYjI2%2Fv80NRVtGzKbJjvMYAcV%2FubKKHBNnfw9Tz%2FsKqDscFSURIAmkBpn0EibvgHU0WQ1U0UVklXK3a5kNgZaIjRhojHEPncbXOu3BRBztvn351hX8xFbYeqa91I%2BlCmhATcQRXnN7muXQFgdUpRW%2BicKXQHJHTS2qpEPOa0HfzQVUJuXlJ73h53iqvKS28TF8IKtNlmomwIG5K4%2BkeQRJDMmNUZ19Mbpx6%2FjFq1vYn0Lg3qBfNsiOGM7tbnXYSW"
    },
    {
        "text": "An industrial loft interior with exposed brick and polished concrete. Soft morning light diffusing through large windows, creating subtle rim lighting. Out-of-focus modern design elements.",
        "encoded": "uk4l2l4eC8wQEWVQ8AX5%2FdMfxn%2FvS3B10RY4iZq01zeu1vzE29%2FgSYt6yFCgj2C3QMn3DLqbRpvDRspjyY2AC%2Bn%2FMgy%2BVBbbCN5GBsQe1wfVJJZ9t%2F56nG%2BsggTu36oRmkCSWHyzfzm7Aum8w7vf8rMr61qaUFtfoaQvRMPuuaowlQK7nCaPc%2BpB3uLaLHZfpvExuQdPktUfToqInWxWFDH2s%2FrIpq87XqCv9RYXlrMR4bkHWHwHzuKQ7wUQKnw%2BMQRAAs61dl572mq3wejmH3DYki1X%2BuHw"
    },
    {
        "text": "A minimalist editorial studio setup with abstract neutral-toned plaster blocks. High-key diffused studio lighting, clean background with soft-focus architectural shadows, professional fashion style.",
        "encoded": "kht9CkvCEBF7EXnDtRsePsHF5i8dEFED7XvMr%2FCAlf%2BimXNXESi6ZDY92yejFY8oJJFE2tAONsefi57gPWhQTQ0NfHN4tH1a948KNLpcnEmAotBu7jsU0e%2B1jpD6BynU1j5iP2QFO3XQkuFcRogiUuzDVOe5JbJYJNnTVfaXauRioPv67GTI9I9ROYs1KYUwcY9C%2B%2F11TfBwMldtLr2eXrozO5CPHs1ASS4Vc5mwk6lZUT7gnIx6OgQeZ2Sovy6C4tLxhyYFVASTORbTVW87NljKERLs5A4Pud0bF2tmKCxzLw%3D%3D"
    }
]
```