Quick Start

What is ImageFork?

ImageFork is a dynamic image generation platform that transforms your content into branded ad banners and social media images using customizable HTML/CSS templates. Create templates once, then generate unlimited variations with different dimensions, content, and brand assets.

Your First Template

  1. Navigate to Template Builder

    Go to Template Builder in your dashboard. This is where you'll create and edit your HTML/CSS templates.

  2. Design Your Template

    Use the visual editor to add elements, set dimensions, and style your template. You can use your brand colors, logos, and custom fonts. Templates are stored as HTML/CSS and can include dynamic content placeholders.

  3. Save Your Template

    Give your template a name and save it. You can create multiple variations of the same template for different dimensions (e.g., 800x400 for banners, 1200x628 for social media).

Your First Image

  1. Select a Template

    Go to Image Generator and choose one of your saved templates. You can also browse the Template Library for pre-made designs.

  2. Generate Your Image

    Click the generate button. ImageFork will render your template as a PNG image. The image will be available immediately, and one credit will be deducted from your account.

Core Concepts

Templates

Templates are HTML/CSS designs that define the structure and styling of your images. Each template can have multiple variations for different dimensions (width × height).

Template Features
  • HTML/CSS Based: Full control over design using standard web technologies
  • Dynamic Content: Use placeholders that can be replaced during generation
  • Brand Integration: Automatically use your saved brand colors and logos
  • Variations: Create size-specific variations of the same template
  • Preview: See how your template looks before generating images
Template Best Practices
  • Keep templates responsive to different dimensions
  • Use relative units (%, em, rem) when possible
  • Optimize images and assets for faster generation
  • Test templates at different sizes before saving
  • Use semantic HTML for better structure

Template builder: zoom and pan

When editing a template, you can zoom and pan the canvas. New and loaded templates start at 100% zoom with the canvas centered.

Shortcut / controlAction
Zoom input (bottom-left of canvas)Type or view zoom % (25–200%)
ScrollPan vertically
Shift + scrollPan horizontally
Ctrl + scrollZoom in/out toward cursor
Ctrl + +Zoom in (toward cursor if over canvas)
Ctrl + -Zoom out (toward cursor if over canvas)
Ctrl + 0Reset to 100% zoom and center the template
Space + dragPan the canvas (hand tool)

On Mac, use Cmd instead of Ctrl for zoom shortcuts.

Brand Assets

Brand assets are reusable design elements that help maintain consistency across all your generated images. Manage them in the Brand Manager.

Brand Colors

Save your brand color palette and use them in templates. Colors are stored as hex values and can be referenced in your template CSS using CSS variables or direct color values.

Brand Logos

Upload your logos (PNG or SVG format) and use them across multiple templates. Logos are stored in your brand asset library and can be easily inserted into any template.

Credits

Credits are used to generate images. Each image generation consumes credits based on the image dimensions.

How Credits Work
  • Credit Cost: Calculated based on image dimensions (width × height)
  • Deduction: Credits are deducted only after successful image generation
  • Balance: Check your credit balance in your account dashboard
  • Low Balance: You'll receive warnings when your credits are running low
Getting More Credits

Purchase credits through your account or subscribe to a plan that includes monthly credits. Visit Pricing to see available plans.

API Reference

Use the ImageFork API to automate image generation from external tools like Zapier, Make.com, or your own applications.

Authentication

All API requests require authentication using your API key. You can find your API key in your account settings.

Getting Your API Key
  1. Log in to your ImageFork account
  2. Navigate to your account settings
  3. Generate or copy your API key
  4. Keep your API key secure and never share it publicly
API Key Security
  • API keys provide full access to your account
  • Treat them like passwords
  • Regenerate keys if they're ever compromised
  • Use environment variables to store keys in your applications

Endpoints

Generate Image

Endpoint: POST /wp-json/imagefork/v1/generate

Description: Generates an image from a template.

Request Parameters

Parameter Type Required Description
user_id integer Yes Your user ID
api_key string Yes Your API key
template_name string Yes Name of the template to use
width integer Yes Image width in pixels
height integer Yes Image height in pixels
job_id string No Optional identifier for tracking

Response

Success (200):

{
  "success": true,
  "image_url": "https://gen.imagefork.com/images/user123_template_20250127.png",
  "processing_time": 2.1,
  "template_name": "My Template",
  "user_id": 123,
  "credits_remaining": 4
}

Error (400):

{
  "success": false,
  "error": "Insufficient credits",
  "error_code": "INSUFFICIENT_CREDITS",
  "credits_remaining": 0
}

Examples

cURL Example
curl -X POST https://imagefork.com/wp-json/imagefork/v1/generate \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 123,
    "api_key": "your-api-key-here",
    "template_name": "My Banner Template",
    "width": 800,
    "height": 400
  }'
JavaScript Example
fetch('https://imagefork.com/wp-json/imagefork/v1/generate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    user_id: 123,
    api_key: 'your-api-key-here',
    template_name: 'My Banner Template',
    width: 800,
    height: 400
  })
})
.then(response => response.json())
.then(data => {
  if (data.success) {
    console.log('Image URL:', data.image_url);
  } else {
    console.error('Error:', data.error);
  }
});
Python Example
import requests

url = 'https://imagefork.com/wp-json/imagefork/v1/generate'
data = {
    'user_id': 123,
    'api_key': 'your-api-key-here',
    'template_name': 'My Banner Template',
    'width': 800,
    'height': 400
}

response = requests.post(url, json=data)
result = response.json()

if result['success']:
    print(f"Image URL: {result['image_url']}")
else:
    print(f"Error: {result['error']}")

Need Help?

Can't find what you're looking for? We're here to help.

Note: ImageFork is currently in early access. Some features may be incomplete or subject to change. We appreciate your patience as we continue to improve the platform.