Stability AI · Schema

StructureControlRequest

3D GenerationAIGenerative AIImage GenerationImage EditingMachine LearningStable DiffusionText to ImageVideo Generation

Properties

Name	Type	Description
image	string	The reference image to use for structural guidance. The edges and layout of this image will guide the output composition.
prompt	string	Text describing the desired output image content and style.
negative_prompt	string	Text describing elements to exclude from the output image.
control_strength	number	Controls how closely the output follows the reference structure. Higher values produce outputs more faithful to the reference layout.
seed	integer	A value to control randomness in generation.
output_format	string	The output format of the generated image.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/StructureControlRequest",
  "title": "StructureControlRequest",
  "type": "object",
  "required": [
    "image",
    "prompt"
  ],
  "properties": {
    "image": {
      "type": "string",
      "format": "binary",
      "description": "The reference image to use for structural guidance. The edges and layout of this image will guide the output composition."
    },
    "prompt": {
      "type": "string",
      "maxLength": 10000,
      "description": "Text describing the desired output image content and style."
    },
    "negative_prompt": {
      "type": "string",
      "maxLength": 10000,
      "description": "Text describing elements to exclude from the output image."
    },
    "control_strength": {
      "type": "number",
      "minimum": 0,
      "maximum": 1,
      "default": 0.7,
      "description": "Controls how closely the output follows the reference structure. Higher values produce outputs more faithful to the reference layout."
    },
    "seed": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4294967294,
      "default": 0,
      "description": "A value to control randomness in generation."
    },
    "output_format": {
      "type": "string",
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "default": "png",
      "description": "The output format of the generated image."
    }
  }
}