Stability AI Outpainting

Use object detection bounding box to crop the image and to outpaint within given directions.

The block wraps Stability AI outpainting API and let users use object detection results to change the content of images in a creative way.

The block sends crop of the image to the API together with directions where to outpaint. As a result, the API returns the image with outpainted regions. At least one of left, right, up, down must be provided, otherwise original image is returned.

Type identifier

Use the following identifier in step "type" field: roboflow_core/stability_ai_outpainting@v1 to add the block as a step in your workflow.

Properties

Name	Type	Description	Refs
name	str	Enter a unique identifier for this step..	❌
creativity	float	Creativity parameter for outpainting. Higher values result in more creative outpainting..	✅
left	int	Number of pixels to outpaint on the left side of the image. Max value is 2000..	✅
right	int	Number of pixels to outpaint on the right side of the image. Max value is 2000..	✅
up	int	Number of pixels to outpaint on the top side of the image. Max value is 2000..	✅
down	int	Number of pixels to outpaint on the bottom side of the image. Max value is 2000..	✅
prompt	str	Optional prompt to apply when outpainting the image (what you wish to see). If not provided, the image will be outpainted without any prompt..	✅
preset	StabilityAIPresets	Optional preset to apply when outpainting the image (what you wish to see). If not provided, the image will be outpainted without any preset. Avaliable presets: 3d-model, analog-film, anime, cinematic, comic-book, digital-art, enhance, fantasy-art, isometric, line-art, low-poly, modeling-compound, neon-punk, origami, photographic, pixel-art, tile-texture.	❌
seed	int	A specific value that is used to guide the 'randomness' of the generation. If not provided, a random seed is used. Must be a number between 0 and 4294967294.	✅
api_key	str	Your Stability AI API key..	✅

The Refs column marks possibility to parametrise the property with dynamic values available in workflow runtime. See Bindings for more info.

Runtime compatibility

requires_internet - air-gapped / offline deployments : This block depends on a service that is not reachable from fully offline / air-gapped deployments.

Input and Output Bindings

The available connections depend on its binding kinds. Check what binding kinds Stability AI Outpainting in version v1 has.

Input and output bindings

• input

  • image (image): The image to outpaint..

  • creativity (float_zero_to_one): Creativity parameter for outpainting. Higher values result in more creative outpainting..

  • left (integer): Number of pixels to outpaint on the left side of the image. Max value is 2000..

  • right (integer): Number of pixels to outpaint on the right side of the image. Max value is 2000..

  • up (integer): Number of pixels to outpaint on the top side of the image. Max value is 2000..

  • down (integer): Number of pixels to outpaint on the bottom side of the image. Max value is 2000..

  • prompt (string): Optional prompt to apply when outpainting the image (what you wish to see). If not provided, the image will be outpainted without any prompt..

  • seed (integer): A specific value that is used to guide the 'randomness' of the generation. If not provided, a random seed is used. Must be a number between 0 and 4294967294.

  • api_key (Union[secret, string]): Your Stability AI API key..

• output

  • image (image): Image in workflows.

Example JSON definition

{
	    "name": "<your_step_name_here>",
	    "type": "roboflow_core/stability_ai_outpainting@v1",
	    "image": "$inputs.image",
	    "creativity": 0.5,
	    "left": 200,
	    "right": 200,
	    "up": 200,
	    "down": 200,
	    "prompt": "my prompt",
	    "preset": "3d-model",
	    "seed": 200,
	    "api_key": "xxx-xxx"
	}