Recraft V3 Image To Image

From 48 credits/call
ae_recraft_v3_image_to_image

Edit an existing image with a text prompt, chosen visual style, preferred colors, and control over how much it changes.

Image
From 48 credits/call

Pricing

From 48 credits/call
Image styleCharge
Other image styles (including omitted)48 credits/call
Vector illustration options96 credits/call

Starting price applies to Image style: Realistic image.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.styleenum (any | realistic_image | digital_illustration | vector_illustration | realistic_image/b_and_w | realistic_image/hard_flash | realistic_image/hdr | realistic_image/natural_light | realistic_image/studio_portrait | realistic_image/enterprise | realistic_image/motion_blur | realistic_image/evening_light | realistic_image/faded_nostalgia | realistic_image/forest_life | realistic_image/mystic_naturalism | realistic_image/natural_tones | realistic_image/organic_calm | realistic_image/real_life_glow | realistic_image/retro_realism | realistic_image/retro_snapshot | realistic_image/urban_drama | realistic_image/village_realism | realistic_image/warm_folk | digital_illustration/pixel_art | digital_illustration/hand_drawn | digital_illustration/grain | digital_illustration/infantile_sketch | digital_illustration/2d_art_poster | digital_illustration/handmade_3d | digital_illustration/hand_drawn_outline | digital_illustration/engraving_color | digital_illustration/2d_art_poster_2 | digital_illustration/antiquarian | digital_illustration/bold_fantasy | digital_illustration/child_book | digital_illustration/child_books | digital_illustration/cover | digital_illustration/crosshatch | digital_illustration/digital_engraving | digital_illustration/expressionism | digital_illustration/freehand_details | digital_illustration/grain_20 | digital_illustration/graphic_intensity | digital_illustration/hard_comics | digital_illustration/long_shadow | digital_illustration/modern_folk | digital_illustration/multicolor | digital_illustration/neon_calm | digital_illustration/noir | digital_illustration/nostalgic_pastel | digital_illustration/outline_details | digital_illustration/pastel_gradient | digital_illustration/pastel_sketch | digital_illustration/pop_art | digital_illustration/pop_renaissance | digital_illustration/street_art | digital_illustration/tablet_sketch | digital_illustration/urban_glow | digital_illustration/urban_sketching | digital_illustration/vanilla_dreams | digital_illustration/young_adult_book | digital_illustration/young_adult_book_2 | vector_illustration/bold_stroke | vector_illustration/chemistry | vector_illustration/colored_stencil | vector_illustration/contour_pop_art | vector_illustration/cosmics | vector_illustration/cutout | vector_illustration/depressive | vector_illustration/editorial | vector_illustration/emotional_flat | vector_illustration/infographical | vector_illustration/marker_outline | vector_illustration/mosaic | vector_illustration/naivector | vector_illustration/roundish_flat | vector_illustration/segmented_colors | vector_illustration/sharp_contrast | vector_illustration/thin | vector_illustration/vector_photo | vector_illustration/vivid_shapes | vector_illustration/engraving | vector_illustration/line_art | vector_illustration/line_circuit | vector_illustration/linocut)NoThe style of the generated images. Vector images cost 2X as much.realistic_image
request_body.colorsarrayNoAn array of preferable colors—
request_body.colors[].bintegerNoBlue color value0
request_body.colors[].gintegerNoGreen color value0
request_body.colors[].rintegerNoRed color value0
request_body.promptstringYesA text description of areas to change.—
request_body.strengthnumberNoDefines the difference with the original image, should lie in [0, 1], where 0 means almost identical, and 1 means miserable similarity0.5
request_body.style_idstring | unknownNoThe ID of the custom style reference (optional)—
request_body.image_urlstringYesThe URL of the image to modify. Must be less than 5 MB in size, have resolution less than 16 MP and max dimension less than 4096 pixels.—
request_body.sync_modebooleanNoIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.false
request_body.negative_promptstring | unknownNoA text description of undesired elements on an image—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_recraft_v3_image_to_image' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "colors": [
        {
          "b": 94,
          "g": 106,
          "r": 179
        },
        {
          "b": 214,
          "g": 232,
          "r": 240
        }
      ],
      "image_url": "https://file.gw.xnetwk.net/file/1ad3003a-e3ec-4aa6-8056-7a9467a11d88.png",
      "negative_prompt": "saturated vivid red, pure red, photorealistic, 3d render, perfect symmetric oval, vector flat shapes, glossy, heavy shadows, text, watermark",
      "prompt": "Minimal single-line illustration on cream paper background: a small red-bean character soaking in a wooden bath tub with steam, a tiny potted plant and a spoon beside it. Keep the same composition. Change three things: 1) desaturate the red into a soft muted dusty brick red, no bright saturated red anywhere. 2) the red bean has a very gentle, soft, peaceful expression, closed curved eyes and a faint tender smile. 3) the wooden bath tub outline is drawn like a small child'\''s crayon doodle: wobbly, crooked, uneven, asymmetric, not a neat oval, lines of varying thickness and pressure with slight overlap, the vertical wood planks bend randomly with irregular spacing. Naive, childlike, innocent, tender hand drawing.",
      "strength": 0.42,
      "style": "digital_illustration/infantile_sketch"
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "77129707-0cab-47c5-a89c-ebfe3ff0779b"
}