Style Transfer
td_style_transferRestyle a finished design with a named library style or the look of a second image while preserving its layout. Results are saved to disk and file paths are returned.
Instructions
Style Transfer: restyle the design with a library style or with the style of a second image (image_to_image). Best for: giving a finished design a new artistic surface look (e.g. Watercolor, Oil Painting) or the look of a second image, while the design layout stays intact. Result files are saved to disk and their paths returned.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dpi | No | Output resolution in ppi (72-500). Omit to keep the image's own resolution. | |
| mode | No | Mode: style_library (Image Style Transfer, Recommended): Restyle the source design with a named library style (style). image_to_image (Image to Image Style Transfer): Apply the look of a second image (the style image) onto the source design, keeping the source layout. Required: pass the mode the user named. If the user did not name one, omit it and the tool returns the modes to show them; never choose for the user. | |
| wait | No | Wait for the job and save the outputs (default true). false returns the task_id right after submit. | |
| image | Yes | Source image: a local file path or an http(s) URL. PNG, JPEG or WebP, up to 80 MB and 5000 px per side. | |
| style | No | Style: watercolor (Watercolor), pastel_drawing (Pastel Drawing), oil_painting (Oil Painting), pencil_sketch (Pencil Sketch), paper_collage (Paper Collage), street_art (Street Art), japanese_ukiyoe (Japanese Ukiyo-e), baroque (Baroque), coloring_book (Coloring Book), art_nouveau (Art Nouveau), vintage_boho (Vintage Boho), floral (Floral), tile_art (Tile Art), surreal (Surreal), expressionist (Expressionist), mosaic (Mosaic), minimal_line_art (Minimal Line Art), stained_glass (Stained Glass), tropical (Tropical), neon (Neon), metallic (Metallic), low_poly (Low Poly), water_action (Water Action). Required: pass the mode the user named. If the user did not name one, omit it and the tool returns the modes to show them; never choose for the user. Required in style_library mode; there is no default style. Call describe_tool for what each option does. | |
| output_dir | No | Folder to save results in. Default: the folder of the input image (or the current directory for URL inputs). Files are never overwritten. | |
| style_image | No | image_to_image: path or URL of the website's Source Image (the style donor) whose look is copied onto the design; the design (image) is the website's Target Image. | |
| estimate_only | No | Only return the credit estimate; nothing is uploaded or charged. | |
| review_settings | No | Omit it and the tool first asks whether to use the recommended settings or adjust them (unless the call already sets some). true: ask each setting one by one. false: run with the given or recommended settings without asking; pass it only after the user chose that. | |
| timeout_seconds | No | How long to wait for the job before returning its task_id (default 240). | |
| unlimited_bundle | No | Request the Unlimited bundle for this run (only has effect on Unlimited plans; the server decides). |