Esegui nella sandbox

Endpoint di Conversione File#

Convert è la metà deterministica di EnConvert: 51 endpoint che prendono un file o un URL e restituiscono lo stesso contenuto in un altro formato. Ognuno è un POST verso /v1/convert/<id>, quindi una volta che ne hai chiamato uno sai come chiamare tutti gli altri.

Un'unica forma di richiesta#

Tra una conversione e l'altra cambiano tre cose: l'id nel percorso, cosa invii e cos'è il risultato. Nient'altro si muove.

Percorso. POST https://api.enconvert.com/v1/convert/<id>, dove <id> indica la coppia di conversione: url-to-pdf, doc-to-pdf, csv-to-json, heic-to-webp.

Input. Un file oppure un URL.

Le conversioni di file, 46 delle 51, accettano multipart/form-data con il file nel campo file.
Le conversioni di pagine web, le altre cinque, accettano application/json con un campo url che accetta un singolo URL o un array di URL.

Output. Ogni conversione scrive il risultato su object storage e risponde con un URL di download firmato valido per 15 minuti. Gli endpoint che supportano direct_download possono invece restituire i byte in streaming nel corpo della risposta; ogni pagina di famiglia indica il proprio valore predefinito. Consulta URL firmati.

Esempio#

Invia un URL, ottieni un PDF:

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \
  -H "X-API-Key: sk_your_private_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

{
    "presigned_url": "https://spaces.example.com/...signed...",
    "object_key": "live/files/4127/url-to-pdf/example_20260405_123456789.pdf",
    "filename": "example_20260405_123456789.pdf",
    "file_size": 48213,
    "conversion_time_seconds": 2.41
}

La stessa chiamata in forma di upload, per i 46 endpoint di file:

curl -X POST https://api.enconvert.com/v1/convert/doc-to-pdf \
  -H "X-API-Key: sk_your_private_key" \
  -F "[email protected]"

Scegli una famiglia#

Pagina	Endpoint	Cosa copre
Matrice di Conversione	tutti e 51	Ogni formato di input e ogni formato di output in un'unica tabella, con l'id dell'endpoint per ciascuna coppia. Parti da qui quando sai cosa hai e cosa vuoi.
Pagine Web	5	Renderizza un URL live in PDF, in un PNG a pagina intera o in Markdown, oppure scansiona un intero sito e ricevi un unico ZIP.
Documenti	13	Word, Excel, PowerPoint, Pages, Numbers, OpenDocument, HTML e Markdown in PDF, più `anything-to-pdf` (36 estensioni di input) e `anything-to-markdown` (22).
Formati Dati	11	JSON, XML, YAML, CSV e TOML in entrambe le direzioni, più Markdown in HTML.
Immagini	22	JPEG, PNG, SVG, HEIC e WebP tra loro, pagine PDF renderizzate in JPEG e compressione nello stesso formato.

Ogni pagina di famiglia elenca i suoi endpoint in una tabella con il percorso esatto di ciascuno. Poi ogni endpoint ha la sua pagina: parametri della richiesta, risposta, casi di errore che può restituire ed esempi di codice.

Gli endpoint Office ignorano la geometria di pagina. I nove endpoint basati su LibreOffice (doc-to-pdf, excel-to-pdf, ppt-to-pdf, odt-to-pdf, ods-to-pdf, odp-to-pdf, ots-to-pdf, pages-to-pdf, numbers-to-pdf) accettano pdf_options ma rispettano solo grayscale. Dimensione della pagina, orientamento e margini vengono presi dal documento sorgente, quindi impostarne uno esplicitamente restituisce 400.

Cosa hanno in comune tutti gli endpoint convert#

Credenziali e content type sono gli stessi su tutta l'API. Consulta Endpoint.
Async e batch sono disponibili solo sui cinque endpoint delle pagine web. Gli upload di file vengono sempre eseguiti in modo sincrono, un file per richiesta. Consulta Job sincroni e asincroni e Elaborazione batch.
La dimensione di upload è limitata per piano, a partire da 5 MB sul piano Founding. Oltre il tetto ricevi 413 con la dimensione del tuo file e il limite massimo nel corpo della risposta. Consulta Rate limit e quote.
Il costo è di una op per conversione. Un batch di 10 URL sono 10 ops, e l'intero batch viene verificato rispetto alla quota rimanente prima che venga renderizzata qualsiasi pagina.
I timeout sono reali. Le conversioni LibreOffice vengono interrotte a 120 secondi e restituiscono 504; il gateway stesso abbandona qualsiasi richiesta dopo 300 secondi.
Gli errori usano gli stessi codici di stato in tutte le famiglie: 400 per input non valido, 401 per credenziali errate, 402 per la quota, 403 per una funzionalità limitata dal piano, 413 per un upload troppo grande. Consulta Codici di errore.

Domande frequenti#

Quali endpoint accettano un URL invece di un file?#

I cinque endpoint delle pagine web: url-to-pdf, url-to-screenshot, url-to-markdown, website-to-pdf e website-to-screenshot. Gli altri 46 accettano solo upload, anything-to-pdf incluso. Per convertire un documento che si trova a un URL, scaricalo tu e carica i byte.

Posso convertire più file in un'unica richiesta?#

Non come upload. Il batch funziona sugli endpoint URL, dove il campo url accetta un array, e richiede una chiave privata più un piano con accesso al batch; il limite di batch del piano Founding è 0. Consulta Elaborazione batch.

E se la mia coppia di formati non è tra le 51?#

Controlla prima anything-to-pdf: accetta 36 estensioni di input e copre coppie che non hanno un endpoint dedicato. Per testo che vuoi leggere anziché stampare, anything-to-markdown ne accetta 22. Nessuno dei due fa OCR, quindi un'immagine passata a anything-to-markdown restituisce 400.

Come trovo l'endpoint per una coppia di formati specifica?#

Apri la Matrice di Conversione. Elenca ogni formato di input su un asse e ogni output sull'altro, con l'id dell'endpoint nella cella.

← Ingest Conversion Matrix →

API Documentation