Recraft

https://www.recraft.ai/

Overview

Property	Details
Description	Recraft is an AI-powered design tool that generates high-quality images with precise control over style and content.
Provider Route on LiteLLM	recraft/
Link to Provider Doc	Recraft ↗
Supported Operations	/images/generations

LiteLLM supports Recraft Image Generation calls.

API Base, Key

# env variable
os.environ['RECRAFT_API_KEY'] = "your-api-key"
os.environ['RECRAFT_API_BASE'] = "https://external.api.recraft.ai"  # [optional] 

Image Generation

Usage - LiteLLM Python SDK

from litellm import image_generation
import os

os.environ['RECRAFT_API_KEY'] = "your-api-key"

# recraft image generation call
response = image_generation(
    model="recraft/recraftv3",
    prompt="A beautiful sunset over a calm ocean",
)
print(response)

Usage - LiteLLM Proxy Server

1. Setup config.yaml

model_list:
  - model_name: recraft-v3
    litellm_params:
      model: recraft/recraftv3
      api_key: os.environ/RECRAFT_API_KEY
  model_info:
    mode: image_generation

general_settings:
  master_key: sk-1234

2. Start the proxy

litellm --config config.yaml

# RUNNING on http://0.0.0.0:4000

3. Test it

curl --location 'http://0.0.0.0:4000/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer sk-1234' \
--data '{
    "model": "recraft-v3",
    "prompt": "A beautiful sunset over a calm ocean",
}'

Advanced Usage - With Additional Parameters

from litellm import image_generation
import os

os.environ['RECRAFT_API_KEY'] = "your-api-key"

response = image_generation(
    model="recraft/recraftv3",
    prompt="A beautiful sunset over a calm ocean",
)
print(response)

Supported Parameters

Recraft supports the following OpenAI-compatible parameters:

Parameter	Type	Description	Example
n	integer	Number of images to generate (1-4)	1
response_format	string	Format of response (url or b64_json)	"url"
size	string	Image dimensions	"1024x1024"
style	string	Image style/artistic direction	"realistic"

Using Non-OpenAI Parameters

If you want to pass parameters that are not supported by OpenAI, you can pass them in your request body, LiteLLM will automatically route it to recraft.

In this example we will pass style_id parameter to the recraft image generation call.

Usage with LiteLLM Python SDK

from litellm import image_generation
import os

os.environ['RECRAFT_API_KEY'] = "your-api-key"

response = image_generation(
    model="recraft/recraftv3",
    prompt="A beautiful sunset over a calm ocean",
    style_id="your-style-id",
)

Usage with LiteLLM Proxy Server + OpenAI Python SDK

from openai import OpenAI
import os

os.environ['RECRAFT_API_KEY'] = "your-api-key"

client = OpenAI(api_key=os.environ['RECRAFT_API_KEY'])

response = client.images.generate(
    model="recraft/recraftv3",
    prompt="A beautiful sunset over a calm ocean",
    extra_body={
        "style_id": "your-style-id",
    },
)
print(response)

Supported Image Generation Models

Note: All recraft models are supported by LiteLLM Just pass the model name with recraft/<model_name> and litellm will route it to recraft.

Model Name	Function Call
recraftv3	image_generation(model="recraft/recraftv3", prompt="...")
recraftv2	image_generation(model="recraft/recraftv2", prompt="...")

For more details on available models and features, see: https://www.recraft.ai/docs

API Key Setup

Get your API key from Recraft's website and set it as an environment variable:

export RECRAFT_API_KEY="your-api-key"