# Guida rapida

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

Invia un'attività di conversione PDF e recupera il risultato in pochi minuti.


Questa guida usa cURL e l'endpoint da PDF a Markdown. Lo stesso modello di invio e interrogazione vale per la conversione in EPUB.

## 1. Crea una chiave API

Crea una chiave API nella [OOMOL Console](https://console.oomol.com/api-key). Conservala sul server o in un gestore di segreti; non inserirla mai in un bundle del browser o in un'applicazione client pubblica.

## 2. Invia un'attività di conversione

Sostituisci la chiave e l'URL PDF di esempio, quindi invia una richiesta all'endpoint di invio.

```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 risposta contiene `sessionID`, ovvero l'ID attività. Salva questo valore insieme al tuo record di lavoro e usalo al posto di `TASK_ID` qui sotto, così tentativi e download rimarranno tracciabili.

## 3. Interroga il risultato

Richiedi l'endpoint del risultato finché lo stato non è `completed` o `failed`, oppure finché non viene raggiunto il numero massimo di tentativi o la scadenza. Tratta ogni risposta non 2xx come un errore e interrompi l'interrogazione se `state` è sconosciuto. Inizia con un breve ritardo e aumenta l'intervallo tra i tentativi per documenti più lunghi.

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

Leggi lo stato dell'attività da `state`. Quando è `completed`, scarica il file generato da `data.downloadURL`; quando è `failed`, registra e gestisci il motivo di errore restituito.

## Passaggi successivi

- Consulta i [concetti API](https://pdfcraft.ai/it-IT/docs/api/overview/) per autenticazione, stati delle attività e tentativi.
- Usa il [Riferimento API](https://pdfcraft.ai/it-IT/api/) quando ti servono dettagli sui campi di richiesta e risposta.

## Eseguire l’esempio completo

Scarica e controlla l’[esempio Python 3](https://pdfcraft.ai/examples/api-quickstart.py). Legge `PDF_CRAFT_API_KEY` dall’ambiente, avvia una conversione che può consumare crediti, salva l’ID e verifica il risultato entro una scadenza. Dopo un’interruzione riprendi la stessa attività senza inviarla di nuovo.

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