WOworqhat
AI Services

Extend an Image's Composition

Changed on

Extend an image's composition using this endpoint. You can pass in an existing image, and we will enhance or extend its composition based on the provided description. This feature is particularly useful for creative projects, design work, or when you need to add more context or elements to an existing image.

post/api/ai/images/modify/v3/extend-image

Request

Request body multi-part/form-data

existing_imagestring binary

The image to be modified or edited.`.

output_type'url' | 'blob'

The type of output to be generated. You can choose between url and blob . URL will return a cloud-hosted Temporary URL for the generated image, you need to handle the image download on your end. blob will return the image as a base64 encoded string.

leftExtendinteger

Percentage to extend the image on the left side. If the percentage value results in a number that is greater than 512px, it will default to 512px.

rightExtendinteger

Percentage to extend the image on the right side. If the percentage value results in a number that is greater than 512px, it will default to 512px.

topExtendinteger

Percentage to extend the image on the top. If the percentage value results in a number that is greater than 512px, it will default to 512px.

bottomExtendinteger

Percentage to extend the image on the bottom. If the percentage value results in a number that is greater than 512px, it will default to 512px.

descriptionstring

The description of the modification to be applied to the image. You can add in the modification parameters as a string based description.

Response

Image generated successfully

statusstring

Status indicating the success of the image generation.

imagestring

The generated image.

processing_timeinteger

The time taken to process the request, in milliseconds.

processing_idstring

A universally unique identifier for the request. This can be used to track the request in the logs.

processing_countinteger

The number of times the request has been processed. This is what is considered in the Billing Process. This is either the number of times the image is processed or the number of words that the server processes.

Example response

{
  "status": "success",
  "image": "https://storage.googleapis.com/1fe0a9ac-617a-42e4-a376-37808b98fc99-worqhat/image-gen/MFl2oNxrMLYKvWbwoDkbQPpScWD3-1697226444718.png?GoogleAccessId=cloud-storage-upload%40worqhat-dev.iam.gserviceaccount.com&Expires=1697226626&Signature=DHlOeWd4QladLc6hsdoqp9lTbvMXs06B6hOkQPviFubszuLfahXXRv9aj%2FPTTlytlTClXHX0zGFr3Tsq9S%2Fs3hFjqBsy7lho%2BfuRFhPG4FrQoV2lxrZmB47X6nWc7TG6hbgLkyT3CvAOfwccmWHH1cbBiEDSI0iEKvx7kwUsgIrYu1ko9Szkul29fjVQ89WL6jyQQX1G9ejsQTNmXHFNRvhwRHkRfZJ5n3Y1uR7aqAyMZfQ2Me6i7bVb7smc0t5Ed2yk6%2BN1fdrz6zhbkc%2Fuh13vWhrT8EWMuCYKhsrzPakO%2B%2B229nlt5Y4D9zyFqevAmj43Vl76INIq29gcs39oQg%3D%3D",
  "processing_time": 2311,
  "processing_id": "cd185dd4-fcfb-4b15-93de-db9eded23ade",
  "processing_count": 2
}

Changes