Apply classic filters, color adjustments, and social-media-inspired looks with one filter pipeline.
grayscale
sepia
blur
sharpen
brightness
contrast
saturation
pixelate
cinematic
viral_glow
warm_film
vhs_glitch
golden_hour
Preset-based media styling
Brand-aligned visual edits
Bulk post-processing
Inspired by common social-media aesthetics, not exact copies of proprietary platform filters.
All ImageHQ processing endpoints are asynchronous. Upon a successful POST, you receive a 202 Acceptedresponse with a job_id. Poll the status endpoint until the state reaches succeeded.
Request Example
import requests
url = "https://api.imagehq.io/v1/filter"
payload = {
"tool_slug": "viral-glow-filter",
"filters": [
{
"type": "viral_glow",
"intensity": 75
}
],
"output_format": "jpg",
"options": {
"quality": 92,
"strip_metadata": True
}
}
files = [("files[]", open("image.png", "rb"))]
data = {"request": json.dumps(payload)}
response = requests.post(url, files=files, data=data)
print(response.json())const form = new FormData();
form.append("files[]", file);
form.append("request", JSON.stringify({
"tool_slug": "viral-glow-filter",
"filters": [
{
"type": "viral_glow",
"intensity": 75
}
],
"output_format": "jpg",
"options": {
"quality": 92,
"strip_metadata": true
}
}));
const response = await fetch("https://api.imagehq.io/v1/filter", {
method: "POST",
headers: { "Idempotency-Key": crypto.randomUUID() },
body: form
});
const data = await response.json();
console.log(data);const form = new FormData();
form.append("files[]", file);
form.append("request", JSON.stringify({
"tool_slug": "viral-glow-filter",
"filters": [
{
"type": "viral_glow",
"intensity": 75
}
],
"output_format": "jpg",
"options": {
"quality": 92,
"strip_metadata": true
}
}));
const response = await fetch("https://api.imagehq.io/v1/filter", {
method: "POST",
headers: { "Idempotency-Key": crypto.randomUUID() },
body: form
});
const data = await response.json();
console.log(data);curl -X POST "https://api.imagehq.io/v1/filter" \
-H "Idempotency-Key: $(uuidgen)" \
-F "files[]=@image.png" \
-F 'request={"tool_slug":"viral-glow-filter","filters":[{"type":"viral_glow","intensity":75}],"output_format":"jpg","options":{"quality":92,"strip_metadata":true}}'$client = new GuzzleHttp\Client();
$response = $client->post("https://api.imagehq.io/v1/filter", [
"multipart" => [
["name" => "files[]", "contents" => fopen("image.png", "r")],
["name" => "request", "contents" => '{"tool_slug":"viral-glow-filter","filters":[{"type":"viral_glow","intensity":75}],"output_format":"jpg","options":{"quality":92,"strip_metadata":true}}']
]
]);require "faraday"
response = Faraday.post("https://api.imagehq.io/v1/filter") do |req|
req.headers["Idempotency-Key"] = SecureRandom.uuid
req.body = { "files[]" => Faraday::UploadIO.new("image.png", "image/png"), "request" => '{"tool_slug":"viral-glow-filter","filters":[{"type":"viral_glow","intensity":75}],"output_format":"jpg","options":{"quality":92,"strip_metadata":true}}' }
endbody := &bytes.Buffer{}
writer := multipart.NewWriter(body)
writer.WriteField("request", `{"tool_slug":"viral-glow-filter","filters":[{"type":"viral_glow","intensity":75}],"output_format":"jpg","options":{"quality":92,"strip_metadata":true}}`)
file, _ := writer.CreateFormFile("files[]", "image.png")
_ = file
writer.Close()
http.Post("https://api.imagehq.io/v1/filter", writer.FormDataContentType(), body)HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.imagehq.io/v1/filter"))
.header("Idempotency-Key", UUID.randomUUID().toString())
.POST(HttpRequest.BodyPublishers.ofString("multipart form data"))
.build();using var form = new MultipartFormDataContent();
form.Add(new StringContent('{"tool_slug":"viral-glow-filter","filters":[{"type":"viral_glow","intensity":75}],"output_format":"jpg","options":{"quality":92,"strip_metadata":true}}'), "request");
form.Add(new StreamContent(File.OpenRead("image.png")), "files[]", "image.png");
await httpClient.PostAsync("https://api.imagehq.io/v1/filter", form);var request = URLRequest(url: URL(string: "https://api.imagehq.io/v1/filter")!) request.httpMethod = "POST" request.setValue(UUID().uuidString, forHTTPHeaderField: "Idempotency-Key") // Attach multipart files[] and request fields before sending.
{
"queued": {
"id": "job_123",
"status": "queued",
"operation": "filter",
"tool_slug": "png-to-jpg",
"client_reference_id": "example-123",
"progress": 0,
"current_stage": "queued",
"poll_url": "/v1/jobs/job_123",
"created_at": "2026-05-02T00:00:00Z",
"expires_at": "2026-05-03T00:00:00Z"
},
"completed": {
"id": "job_123",
"status": "succeeded",
"progress": 100,
"inputs": [
{
"filename": "input.png",
"format": "png",
"mime_type": "image/png",
"size_bytes": 420122
}
],
"outputs": [
{
"id": "0",
"filename": "output.jpg",
"format": "jpg",
"mime_type": "image/jpeg",
"size_bytes": 161002
}
],
"warnings": [],
"stages": [
{
"name": "queued",
"status": "succeeded",
"progress": 100
},
{
"name": "processing",
"status": "succeeded",
"progress": 100
}
],
"download_url": "/v1/jobs/job_123/download",
"retention_policy": {
"ttl_hours": 24,
"clamp": true
},
"expires_at": "2026-05-03T00:00:00Z"
}
}Yes. Filters are applied sequentially in the order you provide.
No. The current filter system is non-AI and built from deterministic image operations.
No. They are inspired by common aesthetics and intentionally generic.