# Guide de démarrage

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

Envoyez une tâche de conversion PDF et récupérez le résultat en quelques minutes.


Ce guide utilise cURL et l’endpoint PDF-vers-Markdown. Le même modèle d’envoi puis d’interrogation s’applique à la conversion EPUB.

## 1. Créer une clé API

Créez une clé API dans [OOMOL Console](https://console.oomol.com/api-key). Conservez-la sur votre serveur ou dans un gestionnaire de secrets ; ne l’incluez jamais dans un bundle navigateur ou une application cliente publique.

## 2. Envoyer une tâche de conversion

Remplacez la clé et l’URL de PDF d’exemple, puis envoyez une requête à l’endpoint d’envoi.

```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 réponse contient `sessionID`, qui correspond à l’identifiant de tâche. Enregistrez cette valeur avec votre propre enregistrement de travail et utilisez-la à la place de `TASK_ID` ci-dessous afin que les nouvelles tentatives et les téléchargements restent traçables.

## 3. Interroger le résultat

Interrogez l’endpoint de résultat jusqu’à ce que le statut soit `completed` ou `failed`, ou jusqu’à atteindre votre nombre maximal de tentatives ou votre délai maximal. Traitez toute réponse non 2xx comme une erreur et arrêtez l’interrogation si `state` est inconnu. Commencez avec un court délai, puis augmentez l’intervalle entre les tentatives pour les documents plus longs.

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

Lisez l’état de la tâche dans `state`. Lorsqu’il vaut `completed`, téléchargez le fichier généré depuis `data.downloadURL` ; lorsqu’il vaut `failed`, journalisez et traitez le motif d’échec retourné.

## Étapes suivantes

- Consultez les [concepts de l’API](https://pdfcraft.ai/fr-FR/docs/api/overview/) pour l’authentification, les états de tâche et les tentatives.
- Utilisez la [Référence API](https://pdfcraft.ai/fr-FR/api/) pour les détails des champs de requête et de réponse.

## Exécuter un exemple complet

Téléchargez et vérifiez l’[exemple Python 3](https://pdfcraft.ai/examples/api-quickstart.py). Il lit `PDF_CRAFT_API_KEY` dans l’environnement, lance une conversion pouvant consommer des crédits, enregistre son identifiant et vérifie le résultat avec une échéance. Reprenez la même tâche après une interruption sans la soumettre à nouveau.

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