Documentation
Learn how to use ImageFork to create branded images and banners
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
-
Navigate to Template Builder
Go to Template Builder in your dashboard. This is where you'll create and edit your HTML/CSS templates.
-
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.
-
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
-
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.
-
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 / control | Action |
|---|---|
| Zoom input (bottom-left of canvas) | Type or view zoom % (25–200%) |
| Scroll | Pan vertically |
| Shift + scroll | Pan horizontally |
| Ctrl + scroll | Zoom in/out toward cursor |
| Ctrl + + | Zoom in (toward cursor if over canvas) |
| Ctrl + - | Zoom out (toward cursor if over canvas) |
| Ctrl + 0 | Reset to 100% zoom and center the template |
| Space + drag | Pan 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
- Log in to your ImageFork account
- Navigate to your account settings
- Generate or copy your API key
- 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.