Skip to content
prodia

inference.recraft.img2img.v1

View markdown

The inference.recraft.img2img.v1 job transforms an input image guided by a text prompt using Recraft V3.

{
    "type": "inference.recraft.img2img.v1",
    "config": {
        "prompt": "a serene mountain landscape at golden hour",
        "image": "reference.png"
    }
}

Additional configuration:

  • negative_prompt (string)
  • strength (number; default 0)
  • style_id (string)
  • style (string; one of realistic_image, digital_illustration, vector_illustration, icon, logo_raster; default realistic_image)
  • substyle (string; one of b_and_w, enterprise, evening_light, faded_nostalgia, forest_life, hard_flash, hdr, motion_blur, mystic_naturalism, natural_light, natural_tones, organic_calm, real_life_glow, retro_realism, retro_snapshot, studio_portrait, urban_drama, village_realism, warm_folk, 2d_art_poster, antiquarian, bold_fantasy, child_book, crosshatch, 3d, 80s, glow, pixel_art, bold_stroke, chemistry, colored_stencil, cosmics, cutout, editorial, cartoon, doodle_line_art, engraving, flat_2, broken_line, colored_outline, doodle_fill, offset_fill, pictogram, emblem_graffiti, emblem_pop_art, emblem_punk, emblem_stamp, emblem_vintage)
  • controls (object)

This job type is also available under its partner alias inference.partner.recraft.img2img.v1.

Schema

Section titled “Schema”
{
  "type": "object",
  "required": [
    "type",
    "config"
  ],
  "properties": {
    "type": {
      "type": "string"
    },
    "config": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "prompt"
      ],
      "properties": {
        "image": {
          "type": "string",
          "format": "filename",
          "example": "input.png",
          "description": "The input image filename. If not specified, the first uploaded image will be used."
        },
        "prompt": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000,
          "description": "Describes areas to change in the image",
          "examples": [
            "transform into a watercolor painting"
          ]
        },
        "negative_prompt": {
          "type": "string",
          "description": "Description of undesired image elements"
        },
        "strength": {
          "type": "number",
          "minimum": 0,
          "maximum": 1,
          "default": 0,
          "description": "Defines difference from original image (0=almost identical, 1=minimal similarity)"
        },
        "style_id": {
          "type": "string",
          "format": "uuid",
          "description": "Reference to a previously uploaded style (mutually exclusive with style parameter)"
        },
        "style": {
          "type": "string",
          "default": "realistic_image",
          "description": "Style of generated images",
          "enum": [
            "realistic_image",
            "digital_illustration",
            "vector_illustration",
            "icon",
            "logo_raster"
          ]
        },
        "substyle": {
          "type": "string",
          "description": "Substyle within the chosen style category",
          "enum": [
            "b_and_w",
            "enterprise",
            "evening_light",
            "faded_nostalgia",
            "forest_life",
            "hard_flash",
            "hdr",
            "motion_blur",
            "mystic_naturalism",
            "natural_light",
            "natural_tones",
            "organic_calm",
            "real_life_glow",
            "retro_realism",
            "retro_snapshot",
            "studio_portrait",
            "urban_drama",
            "village_realism",
            "warm_folk",
            "2d_art_poster",
            "antiquarian",
            "bold_fantasy",
            "child_book",
            "crosshatch",
            "3d",
            "80s",
            "glow",
            "pixel_art",
            "bold_stroke",
            "chemistry",
            "colored_stencil",
            "cosmics",
            "cutout",
            "editorial",
            "cartoon",
            "doodle_line_art",
            "engraving",
            "flat_2",
            "broken_line",
            "colored_outline",
            "doodle_fill",
            "offset_fill",
            "pictogram",
            "emblem_graffiti",
            "emblem_pop_art",
            "emblem_punk",
            "emblem_stamp",
            "emblem_vintage"
          ]
        },
        "controls": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "colors"
          ],
          "properties": {
            "colors": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "rgb"
                ],
                "properties": {
                  "rgb": {
                    "type": "array",
                    "minLength": 3,
                    "maxLength": 3,
                    "items": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 255
                    }
                  }
                }
              }
            },
            "background_color": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "rgb"
              ],
              "properties": {
                "rgb": {
                  "type": "array",
                  "minLength": 3,
                  "maxLength": 3,
                  "items": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 255
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}