Skip to main content
ArtEmotion
Image

Recraft v3 (I2I)

Credit-based pricing. Supports reference images.

Recraft v3 (I2I) preview
Output
image
Aspect ratio
1:1, 16:9, 9:16, 4:3, 3:4
Resolution
1024, 2048

Inputs

  • Reference image (required)

Example prompt

Transform into a bold vintage travel poster illustration with flat graphic shapes, rich jewel-toned color palette, clean strong outlines, retro screen-print aesthetic
Try this prompt →
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/recraft/v3/image-to-image.

POST/api/v1/generate15 fields · 3 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringRequiredOptional model input.
negative_promptstringOptionalA text description of undesired elements on an image
style_idstringOptionalThe ID of the custom style reference (optional)
strengthnumberOptionalDefines the difference with the original image, should lie in [0, 1], where 0 means almost identical, and 1 means miserable similarity · Default: 0.5 · Range: 0–1
stylestringOptionalThe style of the generated images. Vector images cost 2X as much. · Allowed: 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 · Default: realistic_image
colorsobjectOptionalAn array of preferable colors, e.g. [{"r":255,"g":0,"b":0}]
aspect_ratiostringOptionalAllowed: 1:1, 16:9, 9:16, 4:3, 3:4
resolutionstringOptionalAllowed: 1024, 2048
reference_image_urlstringRequiredFormat: uri
Minimal request example
{
  "model_id": "fal-ai/recraft/v3/image-to-image",
  "prompt": "Transform into a bold vintage travel poster illustration with flat graphic shapes, rich jewel-toned color palette, clean strong outlines, retro screen-print aesthetic",
  "reference_image_url": "https://example.com/reference_image"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Frecraft%2Fv3%2Fimage-to-image",
  "title": "Recraft v3 (I2I) generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/recraft/v3/image-to-image.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/recraft/v3/image-to-image",
      "description": "ArtEmotion model identifier."
    },
    "extra": {
      "type": "object",
      "additionalProperties": true,
      "description": "Model-specific settings may also be nested here."
    },
    "max_credits": {
      "type": "number",
      "minimum": 1,
      "description": "Reject before submission if the estimated list price exceeds this cap."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 512
    },
    "folder_id": {
      "type": "string"
    },
    "prompt": {
      "type": "string"
    },
    "negative_prompt": {
      "title": "Negative Prompt",
      "description": "A text description of undesired elements on an image",
      "type": "string"
    },
    "style_id": {
      "title": "Style Id",
      "description": "The ID of the custom style reference (optional)",
      "type": "string"
    },
    "strength": {
      "title": "Strength",
      "description": "Defines the difference with the original image, should lie in [0, 1], where 0 means almost identical, and 1 means miserable similarity",
      "default": 0.5,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "style": {
      "title": "Style",
      "description": "The style of the generated images. Vector images cost 2X as much.",
      "default": "realistic_image",
      "type": "string",
      "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"
      ]
    },
    "colors": {
      "title": "Colors",
      "description": "An array of preferable colors, e.g. [{\"r\":255,\"g\":0,\"b\":0}]",
      "type": "object",
      "additionalProperties": true
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "1:1",
        "16:9",
        "9:16",
        "4:3",
        "3:4"
      ]
    },
    "resolution": {
      "type": "string",
      "enum": [
        "1024",
        "2048"
      ]
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "model_id",
    "prompt",
    "reference_image_url"
  ],
  "additionalProperties": false
}

FAQ

How much does Recraft v3 (I2I) cost on ArtEmotion?

Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.

Do I get my credits back if Recraft v3 (I2I) fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Recraft v3 (I2I) from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/recraft/v3/image-to-image". See the API reference for the full schema.

Where are my generations stored?

Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.

Ready to generate with Recraft v3 (I2I)?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.