POST /v1/convert

Image Convert API

Convert images between PNG, JPG, WebP, AVIF, HEIC, TIFF, SVG, PDF, and more.

Opérations clés

PNG to JPG

JPG to WebP

HEIC to JPG

SVG to PNG

PDF to JPG

Cas d’utilisation

  • Website image optimization

  • Archive format normalization

  • Document to image rendering

Cycle de vie de la tâche async

Tous les endpoints de traitement ImageHQ sont asynchrones. Après un POST réussi, vous recevez une réponse 202 Acceptedavec un job_id. Interrogez l’endpoint de statut jusqu’à ce que l’état atteigne succeeded.

Exemple de requête

import requests

url = "https://api.imagehq.io/v1/convert"
payload = {
  "client_reference_id": "example-123",
  "input_format": "png",
  "output": {
    "background": "#ffffff",
    "output_format": "jpg",
    "quality": 90,
    "strip_metadata": True
  },
  "output_format": "jpg",
  "tool_slug": "png-to-jpg"
}
files = [("files[]", open("image.png", "rb"))]
data = {"request": json.dumps(payload)}

response = requests.post(url, files=files, data=data)
print(response.json())

Réponse réussie

{
  "completed": {
    "download_url": "/v1/jobs/job_123/download",
    "expires_at": "2026-05-03T00:00:00Z",
    "id": "job_123",
    "inputs": [
      {
        "filename": "input.png",
        "format": "png",
        "mime_type": "image/png",
        "size_bytes": 420122
      }
    ],
    "outputs": [
      {
        "filename": "output.jpg",
        "format": "jpg",
        "id": "0",
        "mime_type": "image/jpeg",
        "size_bytes": 161002
      }
    ],
    "progress": 100,
    "retention_policy": {
      "clamp": true,
      "ttl_hours": 24
    },
    "stages": [
      {
        "name": "queued",
        "progress": 100,
        "status": "succeeded"
      },
      {
        "name": "processing",
        "progress": 100,
        "status": "succeeded"
      }
    ],
    "status": "succeeded",
    "warnings": []
  },
  "queued": {
    "client_reference_id": "example-123",
    "created_at": "2026-05-02T00:00:00Z",
    "current_stage": "queued",
    "expires_at": "2026-05-03T00:00:00Z",
    "id": "job_123",
    "operation": "convert",
    "poll_url": "/v1/jobs/job_123",
    "progress": 0,
    "status": "queued",
    "tool_slug": "png-to-jpg"
  }
}

Questions fréquentes

What image formats can I convert?

You can convert between common raster formats and selected document/image bridge formats like PDF where supported.

Does the API run asynchronously?

Yes. Jobs are queued and processed asynchronously with polling and downloadable outputs.

Can I send S3 keys instead of uploads?

Yes. Requests can include S3 input references where configured.

How do I download converted files?

Poll the job status endpoint and call the returned download URL after success.


API associées

API optimizeAPI transformAPI pipelineAPI batch

ImageHQ

Outils d’image intelligents pour la conversion, la compression et l’automatisation.

Outils

Compresser une imageRedimensionner une imagePNG vers JPGFiltresAméliorer

© 2026 ImageHQ. Tous droits réservés.