Convert images to PDF and render PDF pages as images.
image_to_pdf
pdf_to_image
pdf_to_jpg
pdf_to_png
Photo-to-PDF exports
PDF page thumbnails
Document preview generation
For advanced PDF workflow orchestration, see PDFHQ placeholders in docs and footer links.
Wszystkie punkty końcowe przetwarzania ImageHQ są asynchroniczne. Po pomyślnym wykonaniu POST otrzymasz plik 202 Acceptedodpowiedź z A job_id. Sonduj punkt końcowy stanu, aż do osiągnięcia stanu succeeded.
Poproś o przykład
import requests
url = "https://api.imagehq.io/document"
payload = {
"tool_slug": "image-to-pdf",
"operation": "image_to_pdf",
"options": {
"page_size": "auto",
"orientation": "auto",
"merge_images": 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": "image-to-pdf",
"operation": "image_to_pdf",
"options": {
"page_size": "auto",
"orientation": "auto",
"merge_images": true
}
}));
const response = await fetch("https://api.imagehq.io/document", {
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": "image-to-pdf",
"operation": "image_to_pdf",
"options": {
"page_size": "auto",
"orientation": "auto",
"merge_images": true
}
}));
const response = await fetch("https://api.imagehq.io/document", {
method: "POST",
headers: { "Idempotency-Key": crypto.randomUUID() },
body: form
});
const data = await response.json();
console.log(data);curl -X POST "https://api.imagehq.io/document" \
-H "Idempotency-Key: $(uuidgen)" \
-F "files[]=@image.png" \
-F 'request={"tool_slug":"image-to-pdf","operation":"image_to_pdf","options":{"page_size":"auto","orientation":"auto","merge_images":true}}'$client = new GuzzleHttp\Client();
$response = $client->post("https://api.imagehq.io/document", [
"multipart" => [
["name" => "files[]", "contents" => fopen("image.png", "r")],
["name" => "request", "contents" => '{"tool_slug":"image-to-pdf","operation":"image_to_pdf","options":{"page_size":"auto","orientation":"auto","merge_images":true}}']
]
]);require "faraday"
response = Faraday.post("https://api.imagehq.io/document") do |req|
req.headers["Idempotency-Key"] = SecureRandom.uuid
req.body = { "files[]" => Faraday::UploadIO.new("image.png", "image/png"), "request" => '{"tool_slug":"image-to-pdf","operation":"image_to_pdf","options":{"page_size":"auto","orientation":"auto","merge_images":true}}' }
endbody := &bytes.Buffer{}
writer := multipart.NewWriter(body)
writer.WriteField("request", `{"tool_slug":"image-to-pdf","operation":"image_to_pdf","options":{"page_size":"auto","orientation":"auto","merge_images":true}}`)
file, _ := writer.CreateFormFile("files[]", "image.png")
_ = file
writer.Close()
http.Post("https://api.imagehq.io/document", writer.FormDataContentType(), body)HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.imagehq.io/document"))
.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":"image-to-pdf","operation":"image_to_pdf","options":{"page_size":"auto","orientation":"auto","merge_images":true}}'), "request");
form.Add(new StreamContent(File.OpenRead("image.png")), "files[]", "image.png");
await httpClient.PostAsync("https://api.imagehq.io/document", form);var request = URLRequest(url: URL(string: "https://api.imagehq.io/document")!) 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": "document",
"tool_slug": "png-to-jpg",
"client_reference_id": "example-123",
"progress": 0,
"current_stage": "queued",
"poll_url": "/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": "/jobs/job_123/download",
"retention_policy": {
"ttl_hours": 24,
"clamp": true
},
"expires_at": "2026-05-03T00:00:00Z"
}
}Yes. In this API surface, document operations are grouped under /v1/document.
Yes. Use options like page_range for targeted rendering.
Yes. Completed jobs expose output download URLs.