Iteration Layer
Products
Use Cases
Resources

Benchmarks

OCR
Pricing
Login Get Started

Generate Certificate Image

Generate a professional certificate image with recipient name, course title, and completion date for digital sharing, social media, or email delivery.

Get Your Free API Key

No credit card required — start with free trial credits

Who this is for

Online course platforms and training providers use this recipe to generate a completion certificate on the fly. Define a canvas with an elegant background, add a decorative border, and render the recipient's name, course title, and date — ready for digital sharing, social media, or email delivery.

Education
Request
curl -X POST https://api.iterationlayer.com/image-generation/v1/render \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dimensions": {
      "width_in_px": 1200,
      "height_in_px": 800
    },
    "layers": [
      {
        "index": 0,
        "type": "solid-color",
        "hex_color": "#FFFDF5"
      },
      {
        "index": 1,
        "type": "solid-color",
        "hex_color": "#C9A84C",
        "position": {
          "x_in_px": 30.0,
          "y_in_px": 30.0
        },
        "dimensions": {
          "width_in_px": 1140,
          "height_in_px": 740
        }
      },
      {
        "index": 2,
        "type": "solid-color",
        "hex_color": "#FFFDF5",
        "position": {
          "x_in_px": 40.0,
          "y_in_px": 40.0
        },
        "dimensions": {
          "width_in_px": 1120,
          "height_in_px": 720
        }
      },
      {
        "index": 3,
        "type": "text",
        "text": "Certificate of Completion",
        "font_name": "Playfair Display",
        "font_size_in_px": 42,
        "text_color": "#333333",
        "text_align": "center",
        "position": {
          "x_in_px": 100.0,
          "y_in_px": 100.0
        },
        "dimensions": {
          "width_in_px": 1000,
          "height_in_px": 60
        }
      },
      {
        "index": 4,
        "type": "text",
        "text": "Jane Smith",
        "font_name": "Playfair Display",
        "font_size_in_px": 56,
        "text_color": "#1a1a1a",
        "text_align": "center",
        "font_weight": "bold",
        "position": {
          "x_in_px": 100.0,
          "y_in_px": 280.0
        },
        "dimensions": {
          "width_in_px": 1000,
          "height_in_px": 80
        }
      },
      {
        "index": 5,
        "type": "text",
        "text": "Advanced API Design",
        "font_name": "Inter",
        "font_size_in_px": 28,
        "text_color": "#555555",
        "text_align": "center",
        "position": {
          "x_in_px": 100.0,
          "y_in_px": 420.0
        },
        "dimensions": {
          "width_in_px": 1000,
          "height_in_px": 50
        }
      },
      {
        "index": 6,
        "type": "text",
        "text": "March 5, 2026",
        "font_name": "Inter",
        "font_size_in_px": 20,
        "text_color": "#888888",
        "text_align": "center",
        "position": {
          "x_in_px": 100.0,
          "y_in_px": 600.0
        },
        "dimensions": {
          "width_in_px": 1000,
          "height_in_px": 40
        }
      }
    ],
    "output_format": "png"
  }'
Response
{
  "success": true,
  "data": {
    "buffer": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime_type": "image/png"
  }
}
Request
import { IterationLayer } from "iterationlayer";
const client = new IterationLayer({ apiKey: "YOUR_API_KEY" });

const result = await client.generateImage({
  dimensions: {
    width_in_px: 1200,
    height_in_px: 800,
  },
  layers: [
    {
      index: 0,
      type: "solid-color",
      hex_color: "#FFFDF5",
    },
    {
      index: 1,
      type: "solid-color",
      hex_color: "#C9A84C",
      position: {
        x_in_px: 30,
        y_in_px: 30,
      },
      dimensions: {
        width_in_px: 1140,
        height_in_px: 740,
      },
    },
    {
      index: 2,
      type: "solid-color",
      hex_color: "#FFFDF5",
      position: {
        x_in_px: 40,
        y_in_px: 40,
      },
      dimensions: {
        width_in_px: 1120,
        height_in_px: 720,
      },
    },
    {
      index: 3,
      type: "text",
      text: "Certificate of Completion",
      font_name: "Playfair Display",
      font_size_in_px: 42,
      text_color: "#333333",
      text_align: "center",
      position: {
        x_in_px: 100,
        y_in_px: 100,
      },
      dimensions: {
        width_in_px: 1000,
        height_in_px: 60,
      },
    },
    {
      index: 4,
      type: "text",
      text: "Jane Smith",
      font_name: "Playfair Display",
      font_size_in_px: 56,
      text_color: "#1a1a1a",
      text_align: "center",
      font_weight: "bold",
      position: {
        x_in_px: 100,
        y_in_px: 280,
      },
      dimensions: {
        width_in_px: 1000,
        height_in_px: 80,
      },
    },
    {
      index: 5,
      type: "text",
      text: "Advanced API Design",
      font_name: "Inter",
      font_size_in_px: 28,
      text_color: "#555555",
      text_align: "center",
      position: {
        x_in_px: 100,
        y_in_px: 420,
      },
      dimensions: {
        width_in_px: 1000,
        height_in_px: 50,
      },
    },
    {
      index: 6,
      type: "text",
      text: "March 5, 2026",
      font_name: "Inter",
      font_size_in_px: 20,
      text_color: "#888888",
      text_align: "center",
      position: {
        x_in_px: 100,
        y_in_px: 600,
      },
      dimensions: {
        width_in_px: 1000,
        height_in_px: 40,
      },
    },
  ],
  output_format: "png",
});
Response
{
  "success": true,
  "data": {
    "buffer": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime_type": "image/png"
  }
}
Request
from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.generate_image(
    dimensions={
        "width_in_px": 1200,
        "height_in_px": 800,
    },
    layers=[
        {
            "index": 0,
            "type": "solid-color",
            "hex_color": "#FFFDF5",
        },
        {
            "index": 1,
            "type": "solid-color",
            "hex_color": "#C9A84C",
            "position": {
                "x_in_px": 30,
                "y_in_px": 30,
            },
            "dimensions": {
                "width_in_px": 1140,
                "height_in_px": 740,
            },
        },
        {
            "index": 2,
            "type": "solid-color",
            "hex_color": "#FFFDF5",
            "position": {
                "x_in_px": 40,
                "y_in_px": 40,
            },
            "dimensions": {
                "width_in_px": 1120,
                "height_in_px": 720,
            },
        },
        {
            "index": 3,
            "type": "text",
            "text": "Certificate of Completion",
            "font_name": "Playfair Display",
            "font_size_in_px": 42,
            "text_color": "#333333",
            "text_align": "center",
            "position": {
                "x_in_px": 100,
                "y_in_px": 100,
            },
            "dimensions": {
                "width_in_px": 1000,
                "height_in_px": 60,
            },
        },
        {
            "index": 4,
            "type": "text",
            "text": "Jane Smith",
            "font_name": "Playfair Display",
            "font_size_in_px": 56,
            "text_color": "#1a1a1a",
            "text_align": "center",
            "font_weight": "bold",
            "position": {
                "x_in_px": 100,
                "y_in_px": 280,
            },
            "dimensions": {
                "width_in_px": 1000,
                "height_in_px": 80,
            },
        },
        {
            "index": 5,
            "type": "text",
            "text": "Advanced API Design",
            "font_name": "Inter",
            "font_size_in_px": 28,
            "text_color": "#555555",
            "text_align": "center",
            "position": {
                "x_in_px": 100,
                "y_in_px": 420,
            },
            "dimensions": {
                "width_in_px": 1000,
                "height_in_px": 50,
            },
        },
        {
            "index": 6,
            "type": "text",
            "text": "March 5, 2026",
            "font_name": "Inter",
            "font_size_in_px": 20,
            "text_color": "#888888",
            "text_align": "center",
            "position": {
                "x_in_px": 100,
                "y_in_px": 600,
            },
            "dimensions": {
                "width_in_px": 1000,
                "height_in_px": 40,
            },
        },
    ],
    output_format="png",
)
Response
{
  "success": true,
  "data": {
    "buffer": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime_type": "image/png"
  }
}
Request
package main

import il "github.com/iterationlayer/sdk-go"

func main() {
    client := il.NewClient("YOUR_API_KEY")

    result, err := client.GenerateImage(il.GenerateImageRequest{
        Dimensions:   il.Dimensions{
    WidthInPx: 1200,
    HeightInPx: 800,
  },
        OutputFormat: "png",
        Layers: []il.Layer{
            il.NewSolidColorBackgroundLayer(0, "#FFFDF5"),
            il.NewRectangleLayer(1, "#C9A84C",
                il.Position{
      XInPx: 30,
      YInPx: 30,
    },
                il.Dimensions{
      WidthInPx: 1140,
      HeightInPx: 740,
    }),
            il.NewRectangleLayer(2, "#FFFDF5",
                il.Position{
      XInPx: 40,
      YInPx: 40,
    },
                il.Dimensions{
      WidthInPx: 1120,
      HeightInPx: 720,
    }),
            il.NewTextLayer(3, "Certificate of Completion", "Playfair Display", 42, "#333333",
                il.Position{
      XInPx: 100,
      YInPx: 100,
    },
                il.Dimensions{
      WidthInPx: 1000,
      HeightInPx: 60,
    }),
            il.NewTextLayer(4, "Jane Smith", "Playfair Display", 56, "#1a1a1a",
                il.Position{
      XInPx: 100,
      YInPx: 280,
    },
                il.Dimensions{
      WidthInPx: 1000,
      HeightInPx: 80,
    }),
            il.NewTextLayer(5, "Advanced API Design", "Inter", 28, "#555555",
                il.Position{
      XInPx: 100,
      YInPx: 420,
    },
                il.Dimensions{
      WidthInPx: 1000,
      HeightInPx: 50,
    }),
            il.NewTextLayer(6, "March 5, 2026", "Inter", 20, "#888888",
                il.Position{
      XInPx: 100,
      YInPx: 600,
    },
                il.Dimensions{
      WidthInPx: 1000,
      HeightInPx: 40,
    }),
        },
    })
    if err != nil {
        panic(err)
    }
}
Response
{
  "success": true,
  "data": {
    "buffer": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime_type": "image/png"
  }
}
Template
{
  "name": "Generate Certificate Image",
  "nodes": [
    {
      "parameters": {
        "content": "## Generate Certificate Image\n\nOnline course platforms and training providers use this recipe to generate a completion certificate on the fly. Define a canvas with an elegant background, add a decorative border, and render the recipient's name, course title, and date \u2014 ready for digital sharing, social media, or email delivery.\n\n**Note:** This workflow uses the Iteration Layer community node (`n8n-nodes-iterationlayer`). Install it via Settings > Community Nodes on self-hosted n8n, or add it directly on n8n Cloud with Verified Community Nodes enabled.",
        "height_in_px": 280,
        "width_in_px": 500,
        "color": 2
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        200,
        40
      ],
      "id": "1a01d85c-c071-4b66-85a6-72a142bc3d8f",
      "name": "Overview"
    },
    {
      "parameters": {
        "content": "### Step 1: Generate Image\nResource: **Image Generation**\n\nConfigure the Image Generation parameters below, then connect your credentials.",
        "height_in_px": 160,
        "width_in_px": 300,
        "color": 6
      },
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        475,
        100
      ],
      "id": "fb427096-5eed-4db4-a00a-6a709c63e4fe",
      "name": "Step 1 Note"
    },
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ],
      "id": "b2c3d4e5-2222-4000-8000-000000000001",
      "name": "Manual Trigger"
    },
    {
      "parameters": {
        "resource": "imageGeneration",
        "widthInPx": 1200,
        "heightInPx": 800,
        "outputFormat": "png",
        "layersJson": "[{\"index\":0,\"type\":\"solid-color\",\"hex_color\":\"#FFFDF5\"},{\"index\":1,\"type\":\"solid-color\",\"hex_color\":\"#C9A84C\",\"position\":{\"x\":30.0,\"y\":30.0},\"dimensions\":{\"width\":1140,\"height\":740}},{\"index\":2,\"type\":\"solid-color\",\"hex_color\":\"#FFFDF5\",\"position\":{\"x\":40.0,\"y\":40.0},\"dimensions\":{\"width\":1120,\"height\":720}},{\"index\":3,\"type\":\"text\",\"text\":\"Certificate of Completion\",\"font_name\":\"Playfair Display\",\"font_size_in_px\":42,\"text_color\":\"#333333\",\"text_align\":\"center\",\"position\":{\"x\":100.0,\"y\":100.0},\"dimensions\":{\"width\":1000,\"height\":60}},{\"index\":4,\"type\":\"text\",\"text\":\"Jane Smith\",\"font_name\":\"Playfair Display\",\"font_size_in_px\":56,\"text_color\":\"#1a1a1a\",\"text_align\":\"center\",\"font_weight\":\"bold\",\"position\":{\"x\":100.0,\"y\":280.0},\"dimensions\":{\"width\":1000,\"height\":80}},{\"index\":5,\"type\":\"text\",\"text\":\"Advanced API Design\",\"font_name\":\"Inter\",\"font_size_in_px\":28,\"text_color\":\"#555555\",\"text_align\":\"center\",\"position\":{\"x\":100.0,\"y\":420.0},\"dimensions\":{\"width\":1000,\"height\":50}},{\"index\":6,\"type\":\"text\",\"text\":\"March 5, 2026\",\"font_name\":\"Inter\",\"font_size_in_px\":20,\"text_color\":\"#888888\",\"text_align\":\"center\",\"position\":{\"x\":100.0,\"y\":600.0},\"dimensions\":{\"width\":1000,\"height\":40}}]",
        "fontsJson": "[]"
      },
      "type": "n8n-nodes-iterationlayer.iterationLayer",
      "typeVersion": 1,
      "position": [
        500,
        300
      ],
      "id": "b2c3d4e5-2222-4000-8000-000000000002",
      "name": "Generate Image",
      "credentials": {
        "iterationLayerApi": {
          "id": "1",
          "name": "Iteration Layer API"
        }
      }
    }
  ],
  "connections": {
    "Manual Trigger": {
      "main": [
        [
          {
            "node": "Generate Image",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}
Prompt
Generate a certificate of completion image at 1200x800 pixels. Use the generate_image tool with these layers:

1. Background: solid-color layer with cream (#FFFDF5)
2. Border: solid-color layer with gold (#C9A84C) inset 30px
3. Inner fill: solid-color layer with cream inset 40px
4. Title: text layer with "Certificate of Completion" centered
5. Recipient: text layer with [recipient name] in large bold serif font
6. Course: text layer with [course title] centered
7. Date: text layer with [completion date] centered

Related Recipes

Extract Listing Data and Generate a Brochure

Extract property listing details from a real estate document, then generate a branded PDF brochure and a social media image for the listing.

Extract Product Data and Generate a Listing Image

Extract product details from a supplier data sheet, then generate a branded e-commerce listing image with the product name, price, and key specs.

Generate A+ Content Banner

Generate an Amazon A+ Content banner image for book marketing with cover art, title, and branding.

Try with your own data

Get a free API key and run this recipe in minutes. No credit card required.

Image Generation

Compose dynamic images from layers. 100 free image generations included.
Get Your Free API Key