> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recraft v3 Image to Image API

> Clean SVG-level vector graphics.

[← Recraft](https://docs.creatify.ai/api-documentation/ai-generation/models/recraft.md)

**Model name:** `recraft/v3/image-to-image`\
**Generation type:** `image_to_image`\
**Endpoint:** [`POST /api/asset_generator/`](https://docs.creatify.ai/api-reference/ai-generation/post-ai-generation)

## Pricing

**0.5** credits per output.

Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

## Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

```bash cURL theme={null}
curl --request POST \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "model_name": "recraft/v3/image-to-image",
    "input_params": {
      "prompt": "Place her in a bright café with soft morning light.",
      "image_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
    }
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.creatify.ai/api/asset_generator/",
    headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
    json={
        "model_name": "recraft/v3/image-to-image",
        "input_params": {
            "prompt": "Place her in a bright café with soft morning light.",
            "image_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
        },
    },
)
print(response.json()["id"])
```

## Input parameters

Send these fields in `input_params`.

**prompt** `string` *required*

The prompt to generate an image from.

Minimum characters: `1`.
Maximum characters: `1000`.

**image\_url** `string` *required*

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.

**style** `string` (default: realistic\_image)

The style of the generated images. Vector images cost 2X as much.

Allowed values: `"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"`.

**strength** `number` (default: 0.5)

Defines the difference with the original image, should lie in \[0, 1], where 0 means almost identical, and 1 means miserable similarity

Minimum: `0`.
Maximum: `1`.
Multiple of: `0.1`.

**num\_images** `integer` (default: 1)

The number of images to generate.

Minimum: `1`.
Maximum: `1`.

**negative\_prompt** `string`

A text description of undesired elements on an image

Maximum characters: `1000`.

> [accordion] Complete JSON schema
>
> ```json theme={null}
> {
>   "$schema": "http://json-schema.org/draft-07/schema#",
>   "required": [
>     "prompt",
>     "image_url"
>   ],
>   "properties": {
>     "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"
>       ],
>       "type": "string",
>       "title": "Style",
>       "default": "realistic_image",
>       "description": "The style of the generated images. Vector images cost 2X as much.",
>       "x-advance-settings": true
>     },
>     "prompt": {
>       "type": "string",
>       "title": "Prompt",
>       "maxLength": 1000,
>       "minLength": 1,
>       "description": "The prompt to generate an image from."
>     },
>     "strength": {
>       "type": "number",
>       "title": "Strength",
>       "default": 0.5,
>       "maximum": 1,
>       "minimum": 0,
>       "multipleOf": 0.1,
>       "description": "Defines the difference with the original image, should lie in [0, 1], where 0 means almost identical, and 1 means miserable similarity",
>       "x-advance-settings": true
>     },
>     "image_url": {
>       "type": "string",
>       "title": "Image Url",
>       "max_width": 4000,
>       "min_width": 300,
>       "max_height": 4000,
>       "min_height": 300,
>       "description": "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.",
>       "max_file_size": 5242880
>     },
>     "num_images": {
>       "type": "integer",
>       "title": "Num Images",
>       "default": 1,
>       "maximum": 1,
>       "minimum": 1,
>       "x-ui-name": "output_nums",
>       "description": "The number of images to generate."
>     },
>     "negative_prompt": {
>       "type": "string",
>       "title": "Negative Prompt",
>       "maxLength": 1000,
>       "description": "A text description of undesired elements on an image",
>       "x-advance-settings": true
>     }
>   }
> }
> ```

## Response

The request returns the task with `status: "initializing"`. Poll [GET /api/asset\_generator/\{id}/](https://docs.creatify.ai/api-reference/ai-generation/get-ai-generation-.md) until `status` is `done` or `failed`, or pass a `webhook_url` to be notified. A finished task lists its files in `assets` and the credits it charged in `credits_used`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.