Raw schema
{
"type": "object",
"properties": {
"tool_id": {
"description": "Edit tool id. One of: image_edit, inpainting, outpainting, seam_tiling, background_remover, color_style_transfer, color_reducer, palette_converter, pixel_correction, k_centroid_downscale, rotate. Use list_edit_tools for authoritative fields, costs, and limits.",
"type": "string"
},
"input_image": {
"description": "Base64 PNG of the image to edit (raw base64 or a data URL). Required by every edit tool.",
"type": "string"
},
"prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "What to generate or change (required by image_edit and inpainting; optional for outpainting)."
},
"mask_image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64 mask for inpainting: white pixels are regenerated, black pixels are kept."
},
"extra_input_image": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Second base64 input image for styles that use one (e.g. the second texture in rd_tile__tileset_advanced)."
},
"input_palette": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Base64 image of a color palette; output colors are constrained to it."
},
"expand_left": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Outpainting: pixels to add on the left edge."
},
"expand_right": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Outpainting: pixels to add on the right edge."
},
"expand_top": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Outpainting: pixels to add on the top edge."
},
"expand_bottom": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Outpainting: pixels to add on the bottom edge."
},
"soft_inpaint": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "Inpainting/outpainting: blend edits softly with the surrounding pixels."
},
"tile_x": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "seam_tiling: repair the horizontal seam (tool default applies when omitted)."
},
"tile_y": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "seam_tiling: repair the vertical seam (tool default applies when omitted)."
},
"seam_width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "seam_tiling: width in pixels of the seam band to repair."
},
"repair_window_size": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "seam_tiling: size of the repair window."
},
"color_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "color_reducer: target number of colors."
},
"dither_mode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "color_reducer/palette_converter: dithering mode."
},
"dither_strength": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "color_reducer/palette_converter: dithering strength."
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "k_centroid_downscale: target width in pixels (required for that tool)."
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "k_centroid_downscale: target height in pixels (required for that tool)."
},
"rotation_degrees": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "rotate: rotation angle in degrees (clean-edge pixel rotation)."
},
"transparency_threshold": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "background_remover: alpha threshold for treating pixels as transparent."
},
"force_solid_pixels": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"description": "background_remover: force fully solid or fully transparent pixels (tool default applies when omitted)."
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Seed for reproducible results; reuse the same seed to iterate on one composition."
},
"timeout_seconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Read-timeout override in seconds for this call; increase for animations or large batches."
},
"rd_api_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "RetroDiffusion API key (rdpk-...) for this call only; overrides session or header auth."
}
},
"required": [
"tool_id",
"input_image"
]
}
