"Recraft API Tutorial: Professional AI Design and Image Generation"

# Get your API key from https://www.recraft.ai/
# API base URL: https://external.api.recraft.ai/v1

import requests
import json

API_KEY = "your-recraft-api-key"
BASE_URL = "https://external.api.recraft.ai/v1"

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# Generate a raster image
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers=headers,
    json={
        "prompt": "A modern tech company logo with abstract geometric shapes, blue and purple gradient",
        "style": "digital_illustration",
        "model": "recraftv3",
        "size": "1024x1024"
    }
)

result = response.json()
image_url = result["data"][0]["url"]
print(f"Image URL: {image_url}")

# Generate SVG vector output
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers=headers,
    json={
        "prompt": "A set of 4 flat design icons: cloud, lock, gear, chart — consistent line weight, minimal style",
        "style": "icon",
        "model": "recraftv3",
        "response_format": "svg",
        "size": "1024x1024"
    }
)

result = response.json()
svg_content = result["data"][0]["url"]  # or b64_json for inline SVG

# Save as SVG file
with open("icons.svg", "w") as f:
    f.write(svg_content)

# Create a style with your brand colors first
style_response = requests.post(
    f"{BASE_URL}/styles",
    headers=headers,
    json={
        "style": "digital_illustration",
        "colors": [
            {"rgb": [66, 133, 244]},   # Google Blue
            {"rgb": [234, 67, 53]},     # Google Red
            {"rgb": [251, 188, 4]},     # Google Yellow
            {"rgb": [52, 168, 83]}      # Google Green
        ]
    }
)

style_id = style_response.json()["id"]

# Generate using your brand style
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers=headers,
    json={
        "prompt": "A friendly robot mascot waving hello",
        "style_id": style_id,
        "model": "recraftv3",
        "size": "1024x1024"
    }
)

const axios = require('axios');

const API_KEY = 'your-recraft-api-key';
const BASE_URL = 'https://external.api.recraft.ai/v1';

async function generateDesign(prompt, options = {}) {
  const response = await axios.post(
    `${BASE_URL}/images/generations`,
    {
      prompt,
      style: options.style || 'digital_illustration',
      model: 'recraftv3',
      size: options.size || '1024x1024',
      response_format: options.format || 'url',
      ...options
    },
    {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    }
  );

  return response.data;
}

// Generate an icon set
generateDesign(
  'A navigation icon set: home, search, profile, settings, notifications — flat design, 2px stroke',
  { style: 'icon', format: 'svg' }
).then(result => {
  console.log('SVG URL:', result.data[0].url);
});

// Generate a marketing banner
generateDesign(
  'A SaaS product hero banner showing a dashboard with analytics charts, modern flat design, blue theme',
  { size: '1536x1024' }
).then(result => {
  console.log('Banner URL:', result.data[0].url);
});

# Generate a vector icon
curl -X POST https://external.api.recraft.ai/v1/images/generations \
  -H "Authorization: Bearer your-recraft-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A minimalist cloud computing icon, single color, clean lines",
    "style": "icon",
    "model": "recraftv3",
    "response_format": "svg",
    "size": "1024x1024"
  }'

response = requests.post(
    f"{BASE_URL}/images/generations",
    headers=headers,
    json={
        "prompt": "App icon for a meditation app, lotus flower, gradient from purple to blue, rounded corners, iOS style",
        "style": "icon",
        "model": "recraftv3",
        "size": "1024x1024"
    }
)

response = requests.post(
    f"{BASE_URL}/images/generations",
    headers=headers,
    json={
        "prompt": "Isometric illustration of a team collaborating on a software project, laptops, whiteboards, modern office",
        "style": "digital_illustration",
        "model": "recraftv3",
        "size": "1536x1024"
    }
)

# Generate multiple icons with consistent style
icons = [
    "dashboard analytics icon",
    "user profile icon",
    "settings gear icon",
    "notification bell icon",
    "search magnifying glass icon"
]

for icon_prompt in icons:
    response = requests.post(
        f"{BASE_URL}/images/generations",
        headers=headers,
        json={
            "prompt": f"{icon_prompt}, minimal line art, 2px stroke, single color",
            "style": "icon",
            "model": "recraftv3",
            "response_format": "svg",
            "size": "512x512"
        }
    )
    # Save each icon