generate-social-card

Generate an Open Graph social sharing card with dynamic title, description, and branding.

SKILL.md

GitHub

Generate Social Card

Content platforms and developer blogs use this recipe to generate an Open Graph image for social sharing. Define a canvas with your brand background and render the article title, description, and site name — ready for an og:image meta tag with a consistent, eye-catching preview.

APIs Used

Image Generation (1 credits/request)

Prerequisites

You need an Iteration Layer API key. Get one at platform.iterationlayer.com during the 7-day trial.

For full integration guidance (SDKs, auth, MCP, error handling), see the Iteration Layer Integration Guide.

Implementation

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": 630
    },
    "output_format": "png",
    "layers": [
      {
        "index": 0,
        "type": "solid-color",
        "hex_color": "#0F172A"
      },
      {
        "index": 1,
        "type": "text",
        "text": "Building Scalable APIs with Elixir",
        "font_name": "Inter",
        "font_size_in_px": 48,
        "text_color": "#FFFFFF",
        "font_weight": "bold",
        "position": {
          "x_in_px": 80.0,
          "y_in_px": 120.0
        },
        "dimensions": {
          "width_in_px": 1040,
          "height_in_px": 200
        }
      },
      {
        "index": 2,
        "type": "text",
        "text": "A practical guide to designing fault-tolerant API services",
        "font_name": "Inter",
        "font_size_in_px": 24,
        "text_color": "#94A3B8",
        "position": {
          "x_in_px": 80.0,
          "y_in_px": 360.0
        },
        "dimensions": {
          "width_in_px": 1040,
          "height_in_px": 80
        }
      },
      {
        "index": 3,
        "type": "text",
        "text": "iterationlayer.com",
        "font_name": "Inter",
        "font_size_in_px": 20,
        "text_color": "#6366F1",
        "position": {
          "x_in_px": 80.0,
          "y_in_px": 530.0
        },
        "dimensions": {
          "width_in_px": 400,
          "height_in_px": 40
        }
      }
    ]
  }'
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: 630,
  },
  output_format: "png",
  layers: [
    {
      index: 0,
      type: "solid-color",
      hex_color: "#0F172A",
    },
    {
      index: 1,
      type: "text",
      text: "Building Scalable APIs with Elixir",
      font_name: "Inter",
      font_size_in_px: 48,
      text_color: "#FFFFFF",
      font_weight: "bold",
      position: {
        x_in_px: 80.0,
        y_in_px: 120.0,
      },
      dimensions: {
        width_in_px: 1040,
        height_in_px: 200,
      },
    },
    {
      index: 2,
      type: "text",
      text: "A practical guide to designing fault-tolerant API services",
      font_name: "Inter",
      font_size_in_px: 24,
      text_color: "#94A3B8",
      position: {
        x_in_px: 80.0,
        y_in_px: 360.0,
      },
      dimensions: {
        width_in_px: 1040,
        height_in_px: 80,
      },
    },
    {
      index: 3,
      type: "text",
      text: "iterationlayer.com",
      font_name: "Inter",
      font_size_in_px: 20,
      text_color: "#6366F1",
      position: {
        x_in_px: 80.0,
        y_in_px: 530.0,
      },
      dimensions: {
        width_in_px: 400,
        height_in_px: 40,
      },
    },
  ],
});
from iterationlayer import IterationLayer
client = IterationLayer(api_key="YOUR_API_KEY")

result = client.generate_image(
    dimensions={
        "width_in_px": 1200,
        "height_in_px": 630,
    },
    output_format="png",
    layers=[
        {
            "index": 0,
            "type": "solid-color",
            "hex_color": "#0F172A",
        },
        {
            "index": 1,
            "type": "text",
            "text": "Building Scalable APIs with Elixir",
            "font_name": "Inter",
            "font_size_in_px": 48,
            "text_color": "#FFFFFF",
            "font_weight": "bold",
            "position": {
                "x_in_px": 80.0,
                "y_in_px": 120.0,
            },
            "dimensions": {
                "width_in_px": 1040,
                "height_in_px": 200,
            },
        },
        {
            "index": 2,
            "type": "text",
            "text": "A practical guide to designing fault-tolerant API services",
            "font_name": "Inter",
            "font_size_in_px": 24,
            "text_color": "#94A3B8",
            "position": {
                "x_in_px": 80.0,
                "y_in_px": 360.0,
            },
            "dimensions": {
                "width_in_px": 1040,
                "height_in_px": 80,
            },
        },
        {
            "index": 3,
            "type": "text",
            "text": "iterationlayer.com",
            "font_name": "Inter",
            "font_size_in_px": 20,
            "text_color": "#6366F1",
            "position": {
                "x_in_px": 80.0,
                "y_in_px": 530.0,
            },
            "dimensions": {
                "width_in_px": 400,
                "height_in_px": 40,
            },
        },
    ],
)
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: 630,
            },
            OutputFormat: "png",
            Layers: []il.Layer{
                il.NewSolidColorBackgroundLayer(0, "#0F172A"),
                il.NewTextLayer(
                    1,
                    "Building Scalable APIs with Elixir",
                    "Inter", 48, "#FFFFFF",
                    il.Position{
       XInPx: 80.0,
       YInPx: 120.0,
     },
                    il.Dimensions{
       WidthInPx: 1040,
       HeightInPx: 200,
     },
                ),
                il.NewTextLayer(
                    2,
                    "A practical guide to designing fault-tolerant API services",
                    "Inter", 24, "#94A3B8",
                    il.Position{
       XInPx: 80.0,
       YInPx: 360.0,
     },
                    il.Dimensions{
       WidthInPx: 1040,
       HeightInPx: 80,
     },
                ),
                il.NewTextLayer(
                    3, "iterationlayer.com",
                    "Inter", 20, "#6366F1",
                    il.Position{
       XInPx: 80.0,
       YInPx: 530.0,
     },
                    il.Dimensions{
       WidthInPx: 400,
       HeightInPx: 40,
     },
                ),
            },
        },
    )
    if err != nil {
        panic(err)
    }
}
{
  "name": "Generate Social Card",
  "nodes": [
    {
      "parameters": {
        "content": "## Generate Social Card\n\nContent platforms and developer blogs use this recipe to generate an Open Graph image for social sharing. Define a canvas with your brand background and render the article title, description, and site name \u2014 ready for an og:image meta tag with a consistent, eye-catching preview.\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": "96376d68-9d87-4f29-82e1-7c971434dc25",
      "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": "77153d06-46d8-44fd-a90e-e50399008afa",
      "name": "Step 1 Note"
    },
    {
      "parameters": {},
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ],
      "id": "f2a3b4c5-cccc-4000-8000-000000000001",
      "name": "Manual Trigger"
    },
    {
      "parameters": {
        "resource": "imageGeneration",
        "widthInPx": 1200,
        "heightInPx": 630,
        "outputFormat": "png",
        "layersJson": "[{\"index\":0,\"type\":\"solid-color\",\"hex_color\":\"#0F172A\"},{\"index\":1,\"type\":\"text\",\"text\":\"Building Scalable APIs with Elixir\",\"font_name\":\"Inter\",\"font_size_in_px\":48,\"text_color\":\"#FFFFFF\",\"font_weight\":\"bold\",\"position\":{\"x\":80.0,\"y\":120.0},\"dimensions\":{\"width\":1040,\"height\":200}},{\"index\":2,\"type\":\"text\",\"text\":\"A practical guide to designing fault-tolerant API services\",\"font_name\":\"Inter\",\"font_size_in_px\":24,\"text_color\":\"#94A3B8\",\"position\":{\"x\":80.0,\"y\":360.0},\"dimensions\":{\"width\":1040,\"height\":80}},{\"index\":3,\"type\":\"text\",\"text\":\"iterationlayer.com\",\"font_name\":\"Inter\",\"font_size_in_px\":20,\"text_color\":\"#6366F1\",\"position\":{\"x\":80.0,\"y\":530.0},\"dimensions\":{\"width\":400,\"height\":40}}]",
        "fontsJson": "[]"
      },
      "type": "n8n-nodes-iterationlayer.iterationLayer",
      "typeVersion": 1,
      "position": [
        500,
        300
      ],
      "id": "f2a3b4c5-cccc-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"
  }
}
Generate an Open Graph social card at 1200x630 pixels. Use the generate_image tool with these layers:

1. Background: solid-color layer with [brand background color]
2. Title: text layer with [article title] in large bold text, white
3. Description: text layer with [article description] in smaller text
4. Site name: text layer with [site name] positioned at the bottom

Response

{
  "success": true,
  "data": {
    "buffer": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime_type": "image/png"
  }
}

Links