Examples

Generate AI images using cURL or Python and create your own styles programmatically.

Generate a raster image using Recraft V4.1 model

generate_recraftv4_1.sh

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "two race cars on a track",
        "model": "recraftv4_1"
    }'

Generate a vector image using Recraft V4.1 Vector model

generate_recraftv4_1_vector.sh

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "cat on a mat",
        "model": "recraftv4_1_vector"
    }'

Generate an image using Recraft V4.1 Pro with specific size

generate_recraftv4_1_pro_with_size.sh

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "red point siamese cat",
        "model": "recraftv4_1_pro",
        "size": "2560x1664"
    }'

Generate a digital illustration by Recraft V3 with specific style

generate_digital_illustration.sh

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "a monster with lots of hands",
        "style": "Hand-drawn"
    }'

Image to image by Recraft V3 with digital illustration style

image_to_image.sh

curl -X POST https://external.api.recraft.ai/v1/images/imageToImage \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "image=@image.png" \
    -F "prompt=winter" \
    -F "strength=0.2" \
    -F "style=Illustration"

Inpaint an image by Recraft V3 with style Enterprise

inpaint.sh

curl -X POST https://external.api.recraft.ai/v1/images/inpaint \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "prompt=moon" \
    -F "style=Enterprise" \
    -F "image=@image.png" -F "mask=@mask.png"

Outpaint an image by Recraft V3 to a 16:9 aspect ratio

outpaint.sh

curl -X POST https://external.api.recraft.ai/v1/images/outpaint \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "prompt=a mountain landscape" \
    -F "size=16:9" \
    -F "zoom_out_percentage=25.0" \
    -F "image=@image.png"

Outpaint an image by Recraft V3 with per-side pixel margins

outpaint_expand.sh

curl -X POST https://external.api.recraft.ai/v1/images/outpaint \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "prompt=a mountain landscape" \
    -F "expand_left=256" \
    -F "expand_right=256" \
    -F "expand_top=128" \
    -F "expand_bottom=128" \
    -F "image=@image.png"

Create own Recraft V3 style by uploading reference images and use them for generation

create_style_and_generate.sh

curl -X POST https://external.api.recraft.ai/v1/styles \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "style=digital_illustration" \
    -F "file=@image.png"

# response: {"id":"095b9f9d-f06f-4b4e-9bb2-d4f823203427"}

curl https://external.api.recraft.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "wood potato masher",
        "style_id": "095b9f9d-f06f-4b4e-9bb2-d4f823203427"
    }'

Vectorize an image in PNG format

vectorize.sh

curl -X POST https://external.api.recraft.ai/v1/images/vectorize \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "file=@image.png"

Remove background from a PNG image, get the result in B64 JSON

remove_background_b64.sh

curl -X POST https://external.api.recraft.ai/v1/images/removeBackground \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "response_format=b64_json" \
    -F "file=@image.png"

Run crisp upscale tool for a PNG image, get the result in B64 JSON

crisp_upscale_b64.sh

curl -X POST https://external.api.recraft.ai/v1/images/crispUpscale \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "response_format=b64_json" \
    -F "file=@image.png"

Run creative upscale tool for a PNG image

creative_upscale.sh

curl -X POST https://external.api.recraft.ai/v1/images/creativeUpscale \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "file=@image.png"

Variate PNG image, get the result in WEBP format

variate_image.sh

curl -X POST https://external.api.recraft.ai/v1/images/variateImage \
    -H "Content-Type: multipart/form-data" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -F "response_format=url" \
    -F "size=1024x1024" \
    -F "n=1" \
    -F "seed=13191922" \
    -F "image_format=webp" \
    -F "file=@image.png"

Explore images

explore.sh

curl https://external.api.recraft.ai/v1/images/explore \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "race car on a track",
        "model": "recraftv4"
    }'

Enhance a prompt

enhance_prompt.sh

curl https://external.api.recraft.ai/v1/prompts/enhance \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "prompt": "race car on a track"
    }'

Explore similar images

explore_similar.sh

curl https://external.api.recraft.ai/v1/images/explore/similar \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $RECRAFT_API_TOKEN" \
    -d '{
        "source_image_id": "c18a1988-45e7-4c00-82c4-4ad7d3dbce3a",
        "similarity": 3
    }'