API de PowerPoint a PDF#

La API de PowerPoint a PDF convierte presentaciones de Microsoft PowerPoint (.ppt, .pptx) a PDF mediante POST /v1/convert/ppt-to-pdf, usando el motor de renderizado de alta fidelidad de LibreOffice. El formato, las fuentes y el diseño de la propia presentación se conservan en el PDF de salida. La respuesta son los bytes del PDF en bruto por defecto, o metadatos JSON con una URL de descarga prefirmada cuando direct_download=false.

Endpoint#

POST /v1/convert/ppt-to-pdf

Content-Type: multipart/form-data

Entrada aceptada: archivos .ppt or .pptx

Formato de salida: .pdf (application/pdf)

Autenticación#

Requiere una clave API privada o un token JWT emitido a partir de una clave pública.

X-API-Key: sk_your_private_key

O bien:

Authorization: Bearer <jwt_token>

Parámetros de la solicitud#

Opciones de PDF#

Para los conversores de documentos basados en LibreOffice, el diseño de página (tamaño, márgenes, orientación) lo determinan los ajustes del propio documento. El único campo de pdf_options que aplica es:

Detalles de la conversión#

• Usa LibreOffice (vía unoserver) para el renderizado de documentos en el servidor
• Se conservan el formato, las fuentes, el diseño de página y los medios incrustados del propio documento
• Tiempo límite de conversión: 120 segundos
• La salida reproduce fielmente el documento tal y como se imprimiría desde LibreOffice

Respuesta#

Descarga directa (direct_download=true, por defecto)#

HTTP 200 OK
Content-Type: application/pdf
Content-Disposition: inline; filename="document_20260405_123456789.pdf"

Devuelve los bytes del PDF en bruto.

Respuesta con metadatos (direct_download=false)#

{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/ppt-to-pdf/document_20260405_123456789.pdf",
    "filename": "document_20260405_123456789.pdf",
    "file_size": 67890,
    "conversion_time_seconds": 3.5
}

Ejemplos de código#

Python#

import requests

with open("document.ppt", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/ppt-to-pdf",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("document.ppt", f)}
    )

with open("output.pdf", "wb") as out:
    out.write(response.content)

Node.js#

const form = new FormData();
form.append("file", fs.createReadStream("document.ppt"));

const response = await fetch("https://api.enconvert.com/v1/convert/ppt-to-pdf", {
    method: "POST",
    headers: { "X-API-Key": "sk_your_private_key" },
    body: form
});

fs.writeFileSync("output.pdf", Buffer.from(await response.arrayBuffer()));

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/ppt-to-pdf");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("document.ppt")]
]);
$pdf = curl_exec($ch);
curl_close($ch);
file_put_contents("output.pdf", $pdf);

Go#

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "document.ppt")
file, _ := os.Open("document.ppt")
io.Copy(part, file)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/ppt-to-pdf", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", "sk_your_private_key")
resp, _ := http.DefaultClient.Do(req)

Con salida en escala de grises#

import requests
import json

with open("document.ppt", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/ppt-to-pdf",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("document.ppt", f)},
        data={"pdf_options": json.dumps({"grayscale": True})}
    )

Respuestas de error#

Límites#

Preguntas frecuentes#

¿Cómo convierto una presentación PPTX a PDF con una API REST?#

Envía una solicitud multipart/form-data a POST /v1/convert/ppt-to-pdf con tu archivo .ppt o .pptx en el campo file, autenticada vía X-API-Key o un JWT Bearer. Por defecto la respuesta son los bytes del PDF en bruto con Content-Type: application/pdf.

¿La conversión de PowerPoint a PDF conserva el formato de las diapositivas y las fuentes?#

Sí. El endpoint usa LibreOffice (vía unoserver) para el renderizado en el servidor, por lo que se conservan el formato, las fuentes, el diseño de página y los medios incrustados de la propia presentación. La salida reproduce el documento tal y como se imprimiría desde LibreOffice.

¿Puedo definir el tamaño de página, los márgenes o la orientación al convertir PowerPoint a PDF?#

No. El diseño de página lo determinan los ajustes de la propia presentación, y el único campo de pdf_options soportado en este endpoint es grayscale. Para cambiar el diseño de página, modifica el archivo de origen antes de subirlo.

¿Por qué mi conversión de PowerPoint a PDF falló o expiró?#

Un 400 Bad Request significa que el archivo no es .ppt ni .pptx, está corrupto o no está soportado, o el JSON de pdf_options es inválido. Un 500 Internal Server Error significa que la conversión superó el tiempo límite de 120 segundos.

¿Puedo obtener una URL de descarga en lugar de los bytes del PDF?#

Sí. Establece direct_download=false y el endpoint devuelve metadatos JSON que incluyen presigned_url, object_key, filename, file_size y conversion_time_seconds.