Recraft AI

Use Recraft AI’s advanced image generation models through Portkey.

Quick Start

Get started with Recraft AI image generation in under 2 minutes:

Python

from portkey_ai import Portkey

# 1. Install: pip install portkey-ai
# 2. Add @recraft-ai provider in model catalog
# 3. Use it:

portkey = Portkey(api_key="PORTKEY_API_KEY")

image = portkey.images.generate(
    model="@recraft-ai/recraftv3",
    prompt="A serene mountain landscape at sunset",
    style="digital_illustration"
)

print(image.data[0].url)

import Portkey from 'portkey-ai'

// 1. Install: npm install portkey-ai
// 2. Add @recraft-ai provider in model catalog
// 3. Use it:

const portkey = new Portkey({
    apiKey: "PORTKEY_API_KEY"
})

const image = await portkey.images.generate({
    model: "@recraft-ai/recraftv3",
    prompt: "A serene mountain landscape at sunset",
    style: "digital_illustration"
})

console.log(image.data[0].url)

from openai import OpenAI
from portkey_ai import PORTKEY_GATEWAY_URL

# 1. Install: pip install openai portkey-ai
# 2. Add @recraft-ai provider in model catalog
# 3. Use it:

client = OpenAI(
    api_key="PORTKEY_API_KEY",  # Portkey API key
    base_url=PORTKEY_GATEWAY_URL
)

image = client.images.generate(
    model="@recraft-ai/recraftv3",
    prompt="A serene mountain landscape at sunset",
    style="digital_illustration"
)

print(image.data[0].url)

import OpenAI from "openai"
import { PORTKEY_GATEWAY_URL } from "portkey-ai"

// 1. Install: npm install openai portkey-ai
// 2. Add @recraft-ai provider in model catalog
// 3. Use it:

const client = new OpenAI({
    apiKey: "PORTKEY_API_KEY",  // Portkey API key
    baseURL: PORTKEY_GATEWAY_URL
})

const image = await client.images.generate({
    model: "@recraft-ai/recraftv3",
    prompt: "A serene mountain landscape at sunset",
    style: "digital_illustration"
})

console.log(image.data[0].url)

curl https://api.portkey.ai/v1/images/generations \
    -H "Content-Type: application/json" \
    -H "x-portkey-api-key: $PORTKEY_API_KEY" \
    -H "x-portkey-provider: @recraft-ai" \
    -d '{
        "model": "recraftv3",
        "prompt": "A serene mountain landscape at sunset",
        "style": "digital_illustration"
    }'

Add Provider in Model Catalog

Before making requests, add Recraft AI to your Model Catalog:

1. Go to Model Catalog → Add Provider
2. Select Recraft AI
3. Enter your Recraft AI API key
4. Name your provider (e.g., recraft-ai)

Complete Setup Guide

See all setup options and detailed configuration instructions

---

Supported Models

Recraft AI provides advanced image generation models:

Model	Description
recraftv3	Latest Recraft model with enhanced capabilities
recraftv2	Previous generation Recraft model

Check Recraft AI’s documentation for more details.

Portkey uses the OpenAI image generation signature for Recraft AI, allowing you to easily switch between providers.

---

Next Steps

Gateway Configs

Add fallbacks, load balancing, and more

Observability

Monitor and trace your Recraft AI requests

Caching

Cache generated images

Image API Reference

Complete image generation API docs

For complete SDK documentation:

SDK Reference

Complete Portkey SDK documentation