Professional quality, endless possibilities.

Generate Background API

Upgrade your catalog branding

Rebrand assets endlessly

curl -X GET "https://beta-sdk.photoroom.com/v1/instant-backgrounds?imageUrl=<IMAGE_URL>&prompt=<PROMPT>&negativePrompt=<NEGATIVE_PROMPT>" \
     -H "accept: image/jpg" \
     -H "x-api-key: <API_KEY>"
     
curl -X POST "https://beta-sdk.photoroom.com/v1/instant-backgrounds" \
     -H "accept: image/jpg" \
     -H "Content-Type: application/json" \
     -H "x-api-key: <API_KEY>" \
     -d "{\"imageUrl\":\"<IMAGE_URL>\",\"prompt\":\"<PROMPT>\",\"negativePrompt\":\"<NEGATIVE_PROMPT>\"}"


import requests

imageUrl = '<IMAGE_URL>'
prompt = '<PROMPT>'
negativePrompt = '<NEGATIVE_PROMPT>'

response = requests.get(f'https://beta-sdk.photoroom.com/v1/instant-backgrounds?imageUrl={imageUrl}&prompt={prompt}&negativePrompt={negativePrompt}', headers={'accept': 'image/jpg'})
# handle response

response = requests.post('https://beta-sdk.photoroom.com/v1/instant-backgrounds', headers={'accept': 'image/jpg', 'Content-Type': 'application/json'}, json={'imageUrl': imageUrl, 'prompt': prompt, 'negativePrompt': negativePrompt})
# handle response

import Foundation

let apiKey = "<API_KEY>"
let imageUrl = "<IMAGE_URL>"
let prompt = "<PROMPT>"
let negativePrompt = "<NEGATIVE_PROMPT>"

// GET request
let url = URL(string: "https://beta-sdk.photoroom.com/v1/instant-backgrounds?imageUrl=\(imageUrl)&prompt=\(prompt)&negativePrompt=\(negativePrompt)")!
var request = URLRequest(url: url)
request.addValue("image/jpg", forHTTPHeaderField: "accept")
request.addValue(apiKey, forHTTPHeaderField: "x-api-key")
let task = URLSession.shared.dataTask(with: request) { data, response, error in
    // handle response
}
task.resume()

// POST request
let postUrl = URL(string: "https://beta-sdk.photoroom.com/v1/instant-backgrounds")!
var postRequest = URLRequest(url: postUrl)
postRequest.httpMethod = "POST"
postRequest.addValue("application/json", forHTTPHeaderField: "Content-Type")
postRequest.addValue("image/jpg", forHTTPHeaderField: "accept")
postRequest.addValue(apiKey, forHTTPHeaderField: "x-api-key")
let postBody = [
    "imageUrl": imageUrl,
    "prompt": prompt,
    "negativePrompt": negativePrompt,
]
postRequest.httpBody = try? JSONSerialization.data(withJSONObject: postBody, options: [])
let postTask = URLSession.shared.dataTask(with: postRequest) { data, response, error in
    // handle response
}
postTask.resume()

import java.net.HttpURLConnection
import java.net.URL

fun main() {
    val apiKey = "<API_KEY>"
    val imageUrl = "<IMAGE_URL>"
    val prompt = "<PROMPT>"
    val negativePrompt = "<NEGATIVE_PROMPT>"

    // GET request
    val getUrl = URL("https://beta-sdk.photoroom.com/v1/instant-backgrounds?imageUrl=$imageUrl&prompt=$prompt&negativePrompt=$negativePrompt")
    val getRequest = (getUrl.openConnection() as HttpURLConnection).apply {
        requestMethod = "GET"
        addRequestProperty("accept", "image/jpg")
        addRequestProperty("x-api-key", apiKey)
    }
    val getResponse = getRequest.inputStream.readAllBytes()
    // handle response

    // POST request
    val postUrl = URL("https://beta-sdk.photoroom.com/v1/instant-backgrounds")
    val postRequest = (postUrl.openConnection() as HttpURLConnection).apply {
        requestMethod = "POST"
        addRequestProperty("Content-Type", "application/json")
        addRequestProperty("accept", "image/jpg")
        addRequestProperty("x-api-key", apiKey)
        doOutput = true
        outputStream.write("""
            {
                "imageUrl": "$imageUrl",
                "prompt": "$prompt",
                "negativePrompt": "$negativePrompt"
            }
        """.trimIndent().toByteArray())
    }
    val postResponse = postRequest.inputStream.readAllBytes()
    // handle response
}

fun java.io.InputStream.readAllBytes(): ByteArray {
    val buf = ByteArrayOutputStream()
    var next = read()
    while (next > -1) {
        buf.write(next)
        next = read()
    }
    return buf.toByteArray()
}

Generate Background API

Upgrade your catalog branding

Rebrand assets endlessly

Easy to integrate

Pricing

Get a monthly credit package

Go further with PhotoRoom

Explore our free tools