Documentación API

Convierte archivos desde tu propio código: sube un archivo, consulta su estado y descarga el resultado. Tres peticiones y una clave de API.

Obtener clave APIEmpezar
curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Empezando

De cero al primer archivo convertido:

  1. Elige un plan de pago (Starter, Pro o Business) en 1-converter.com. En Free no hay claves de API.
  2. Crea una clave en Panel → Ajustes → Claves de API y cópiala: solo se muestra una vez.
  3. Envía la clave con tu primera subida, como se muestra en Autenticación.

Autenticación

Envía tu clave de API en cada solicitud, en cualquiera de estas dos cabeceras:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Se aceptan las dos cabeceras y llevan la misma clave: usa la que le resulte más cómoda a tu cliente HTTP.

No compartas nunca tu clave de API ni la subas al control de versiones.

Mantenga su clave API segura y nunca la exponga en el código del lado del cliente.

URL base

Todas las solicitudes de API deben realizarse a:

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

Puntos finales API

Cargar y convertir

Cargue un archivo y conviértalo al formato especificado

POST/api/v1/convert/upload

Encabezados de solicitud

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Cuerpo de la solicitud

  • fileel archivo a convertir (obligatorio)
  • target_formatformato de destino (por ejemplo, 'pdf', 'jpg', 'png') (obligatorio)

Respuesta

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Verificar estado

Comprobar el estado de una conversión

GET/api/v1/convert/status/:id

Respuesta

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Descargar resultado

Descargue el archivo convertido

GET/api/v1/convert/download/:id

Límites de tarifas

Cada plan de pago incluye un número mensual de llamadas a la API, el mismo que aparece en la página de precios.

PlanLlamadas a la API al mes
FreeSin claves de API
Starter1000 llamadas a la API al mes
Pro10.000 llamadas a la API al mes
BusinessAPI ilimitada

Cuando se excedan los límites de tarifas, recibirá una respuesta 429 Demasiadas solicitudes.

Códigos de error

La API utiliza códigos de estado HTTP estándar para indicar éxito o fracaso:

CódigoDescripción
400 Solicitud incorrectaParámetros de solicitud no válidos
401 No autorizadoClave API no válida o faltante
403 ProhibidoPermisos insuficientes
404 no encontradoRecurso no encontrado
429 Demasiadas solicitudesLímite de tarifa excedido
500 Error interno del servidorError del servidor, inténtelo de nuevo

Ejemplos de código

A continuación se muestran ejemplos en diferentes lenguajes de programación:

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Pitón

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

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

rizo

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

¿Necesitar ayuda?

¿Una petición falla de una forma que esta documentación no explica? Escríbenos con la petición y la respuesta que recibiste.

Contactar con soporteAdministrar claves API