Skip to main content
POST
Generate Blog Meta Elements

Overview

Generate complete blog post metadata including images, excerpt, category, and tags using AI. This endpoint uses advanced AI models to create professional blog metadata.

Request Body

string
required
The title of your blog post. This is used to generate all elements.
string
required
Your GistMag API key
string
Optional blog post content. Providing content helps generate more accurate and relevant results.
string
default:"realistic"
The style of images to generate. Options:
  • realistic: Photorealistic images
  • illustration: Artistic illustrations
  • abstract: Abstract designs
  • minimalist: Simple, clean designs
  • photographic: High-quality photographs
string
default:"en"
Language code for the generated content (default: en)
string
Source identifier for tracking (web, api, extension, wordpress, shopify, batch)

Example Request

cURL

Python

JavaScript

Image Generation

Images are generated using Nano Banana (Google Gemini Image Generation API) and automatically uploaded to Supabase Storage. Each image is returned as a public URL that can be directly used in your application or downloaded.
All images are hosted on Supabase Storage and are publicly accessible via the returned URLs. Images are generated in the style you specify and optimized for web use.

Response

array
Array of generated images (up to 3 images)
string
Public URL of the generated image (hosted on Supabase Storage). Images are generated using Nano Banana (Google Gemini) and automatically uploaded to storage.
string
The style of the image (realistic, illustration, abstract, minimalist, photographic)
string
Description of what the image represents
string
A concise 2-3 sentence summary of the blog post (max 200 characters)
string
An appropriate category name for the blog post (e.g., “Technology”, “Health”, “Business”)
array<string>
Array of 5-8 relevant tags for the blog post
string
ISO 8601 timestamp of when the content was generated

Example Response

Error Responses

string
Error type
string
Detailed error message

Common Errors

  • 400 Bad Request: Invalid request parameters (e.g., missing title, invalid image_style)
  • 401 Unauthorized: Invalid or missing API key
  • 402 Payment Required: Insufficient credits (requires 3 credits per generation)
  • 500 Internal Server Error: Server error processing the request

Example Error Response

Best Practices

  1. Provide Content When Possible: Including the blog post content helps generate more accurate excerpts, categories, and tags
  2. Choose Appropriate Image Style: Select an image style that matches your blog’s aesthetic
  3. Review Generated Content: Always review and edit the generated content to ensure it matches your brand voice
  4. Handle Image URLs: Generated image URLs are temporary - download and host them on your own server for permanent use
  5. Credit Management: Each generation costs 3 credits, so ensure you have sufficient credits before making requests

Rate Limits

The Blog Meta Generator follows the same rate limits as other GistMag API endpoints. Check your subscription tier for specific limits.