Skip to main content
POST
/
v3
/
outpainting
Outpainting
curl --request POST \
  --url https://api.novita.ai/v3/outpainting \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "extra": {
    "response_image_type": "<string>",
    "enterprise_plan": {
      "enabled": true
    }
  },
  "image_file": "<string>",
  "prompt": "<string>",
  "negative_prompt": "<string>",
  "width": 123,
  "height": 123,
  "center_x": 123,
  "center_y": 123
}
'
{
  "image_file": "<string>",
  "image_type": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://novita.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

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"
}
Outpainting
Outpainting