POST
/
v3
/
outpainting

Extending the borders of the image or providing additional variations to the edges of the image.

Request Headers

Content-Type
string
required

Enum: application/json

Authorization
string
required

Bearer authentication format, for example: Bearer {{API Key}}.

Request Body

extra
object

Optional extra parameters for the request.

image_file
string
required

The base64 original image, with a maximum resolution of 1024 x 1024 and a maximum file size of 30 Mb.

prompt
string
required

Text input required to guide the image generation, divided by , . Range [1, 1024].

negative_prompt
string

Text input that specifies what to exclude from the generated images, divided by , . Range [1, 1024].

width
integer
required

The width of the outpainting image (px), which needs to be larger than the width of the original image. Maximum: 4096px.

height
integer
required

The height of the outpainting image (px), which needs to be larger than the height of the original image. Maximum: 4096px.

center_x
integer
required

The offset (px) between the center of the original image and the center of the expanded image in the X-axis direction. Default is 0. The allowed value range is -(width + original image width)/2 to (width + original image width)/2.

center_y
integer
required

The offset (px) between the center of the original image and the center of the expanded image in the Y-axis direction. Default is 0. The allowed value range is -(height + original image height)/2 to (height + original image height)/2.

Response

image_file
string

The Base64-encoded content of the returned image.

image_type
string

The returned image type.
Enum: png, webp, jpeg

Example

Extending the borders of the image or providing additional variations to the edges of the image.

Try it in playground.

Request:

curl --location --request POST 'https://api.novita.ai/v3/outpainting' \
--header 'Authorization: Bearer {{API Key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"image_file":"{{Base64 encoded image}}",
"width": 1024,
"height": 1024,
"center_x": 0,
"center_y": 0
}'

HTTP status codes in the 2xx range indicate that the request has been successfully accepted. A code 400 means there is a request parameter error, while status codes in the 5xx range indicate internal server errors.

You can obtain the image URL in the image_file of the response in base64 format.

Response:

{
    "image_file": "{{Base64 encoded image}}",
    "image_type": "png"
}

Was this page helpful?