# Inicio rápido

[HTML](https://pdfcraft.ai/es-ES/docs/getting-started/quickstart/) · [Site index](https://pdfcraft.ai/llms.txt)

Envía una tarea de conversión de PDF y recupera el resultado en pocos minutos.


Esta guía utiliza cURL y el endpoint de PDF a Markdown. El mismo patrón de envío y consulta se aplica a la conversión a EPUB.

## 1. Crea una clave de API

Crea una clave de API en [OOMOL Console](https://console.oomol.com/api-key). Guárdala en tu servidor o en un gestor de secretos; no la incluyas nunca en un bundle del navegador ni en una aplicación cliente pública.

## 2. Envía una tarea de conversión

Sustituye la clave y la URL de PDF de ejemplo y envía una solicitud al endpoint de envío.

```bash
curl --request POST "https://fusion-api.oomol.com/v1/pdf-transform-markdown/submit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "pdfURL": "https://pdfcraft.ai/examples/api-quickstart.pdf",
    "model": "gundam"
  }'
```

La respuesta contiene `sessionID`, que es el ID de tarea. Guárdalo junto con tu propio registro de trabajo y úsalo en lugar de `TASK_ID` a continuación para que los reintentos y las descargas sean rastreables.

## 3. Consulta el resultado

Solicita el endpoint de resultado hasta que el estado sea `completed` o `failed`, o hasta alcanzar el número máximo de intentos o la fecha límite. Trata cualquier respuesta que no sea 2xx como un error y deja de consultar si `state` es desconocido. Empieza con una espera breve y aumenta el intervalo entre intentos para documentos más largos.

```bash
curl --request GET "https://fusion-api.oomol.com/v1/pdf-transform-markdown/result/TASK_ID" \
  --header "Authorization: Bearer YOUR_API_KEY"
```

Lee el estado de la tarea desde `state`. Cuando sea `completed`, descarga el archivo generado desde `data.downloadURL`; cuando sea `failed`, registra y gestiona la razón de error devuelta.

## Siguientes pasos

- Revisa los [conceptos de la API](https://pdfcraft.ai/es-ES/docs/api/overview/) para conocer la autenticación, los estados y los reintentos.
- Usa la [Referencia de la API](https://pdfcraft.ai/es-ES/api/) cuando necesites detalles de campos de solicitudes y respuestas.

## Ejecutar el ejemplo completo

Descarga y revisa el [ejemplo de Python 3](https://pdfcraft.ai/examples/api-quickstart.py). Lee `PDF_CRAFT_API_KEY` del entorno, envía una conversión que puede consumir créditos, guarda el identificador y verifica el resultado con un plazo máximo. Reanuda la misma tarea tras una interrupción; no la envíes de nuevo.

```bash
python3 api-quickstart.py
python3 api-quickstart.py --resume pdf-craft-task.json
```