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.
From 48 credits/call
Pricing
From 48 credits/call
| Image style | Charge |
|---|---|
| Other image styles (including omitted) | 48 credits/call |
| Vector illustration options | 96 credits/call |
Starting price applies to Image style: Realistic image.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.style | enum (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) | No | The style of the generated images. Vector images cost 2X as much. | realistic_image |
request_body.colors | array | No | An array of preferable colors | — |
request_body.colors[].b | integer | No | Blue color value | 0 |
request_body.colors[].g | integer | No | Green color value | 0 |
request_body.colors[].r | integer | No | Red color value | 0 |
request_body.prompt | string | Yes | A text description of areas to change. | — |
request_body.strength | number | No | Defines the difference with the original image, should lie in [0, 1], where 0 means almost identical, and 1 means miserable similarity | 0.5 |
request_body.style_id | string | unknown | No | The ID of the custom style reference (optional) | — |
request_body.image_url | string | Yes | The 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_mode | boolean | No | If `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_prompt | string | unknown | No | A 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-KeySubmit 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
{
"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"
}




