Per iniziare

Guida rapida

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. 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 per autenticazione, stati delle attività e tentativi.
Usa il Riferimento API quando ti servono dettagli sui campi di richiesta e risposta.

Eseguire l’esempio completo

Scarica e controlla l’esempio Python 3. 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