---
title: Basic OG Image Generator API
slug: generate-og-image
url: https://apyhub.com/apyhub/service/generate-og-image
provider: ApyHub
categories: [Marketing, Smart Generation]
tags: [open-graph, image-generation, social-preview, og-image, branding]
auth: api_key
---

# Basic OG Image Generator API

Generate Open Graph PNGs from JSON with title, subtitle, description, and brand colors. Use a file or signed URL in social preview workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/download` | What it does Generates an Open Graph image and returns it as a PNG download. You provide the card c… | 50 |
| POST | `/link` | What it does Generates an Open Graph image from the request body fields and returns a JSON object c… | 50 |

## About

## What it does
Open Graph Image Generator creates social preview images from JSON. Send a required `title`, and optionally add `subtitle`, `description`, `bgColor`, `textColor`, and `accentColor` to control the layout and branding of the card.

Use `/download` when you want the PNG file itself. Use `/link` when you want a signed URL to the uploaded image. Both endpoints generate the same Open Graph-style image, so you can choose the response shape that fits your publishing flow.

The `title` becomes the primary headline on the card. `subtitle` and `description` let you add supporting copy, while the color fields accept `#RRGGBB` values so you can match your brand palette. If you are generating share images for blog posts, product launches, docs pages, or invite links, this gives you a direct way to produce consistent preview assets from backend code.

Open Graph Image Generator is a good fit for CMS pipelines, social sharing workflows, and any app that needs predictable preview images without a manual design step.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/apyhub/service/generate-og-image