# Schnellstart

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

Übermitteln Sie in wenigen Minuten eine PDF-Konvertierungsaufgabe und rufen Sie das Ergebnis ab.


Diese Anleitung verwendet cURL und den Endpunkt PDF-zu-Markdown. Für die EPUB-Konvertierung gilt dasselbe Muster aus Übermitteln und Abfragen.

## 1. API-Schlüssel erstellen

Erstellen Sie einen API-Schlüssel in der [OOMOL Console](https://console.oomol.com/api-key). Bewahren Sie ihn auf Ihrem Server oder in einem Secret Manager auf; binden Sie ihn niemals in ein Browser-Bundle oder eine öffentliche Client-Anwendung ein.

## 2. Konvertierungsaufgabe übermitteln

Ersetzen Sie den Beispielschlüssel und die PDF-URL und senden Sie dann eine Anfrage an den Submit-Endpunkt.

```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"
  }'
```

Die Antwort enthält `sessionID`, also die Task-ID. Speichern Sie diesen Wert zusammen mit Ihrem eigenen Job-Datensatz und verwenden Sie ihn unten anstelle von `TASK_ID`, damit Wiederholungen und Downloads nachvollziehbar bleiben.

## 3. Ergebnis abfragen

Fragen Sie den Ergebnis-Endpunkt ab, bis der Status `completed` oder `failed` lautet oder Ihre maximale Anzahl von Versuchen beziehungsweise Ihre Frist erreicht ist. Behandeln Sie jede Nicht-2xx-Antwort als Fehler und beenden Sie die Abfrage bei einem unbekannten `state`. Starten Sie mit einer kurzen Wartezeit und verlängern Sie das Intervall bei längeren Dokumenten.

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

Lesen Sie den Task-Status aus `state`. Bei `completed` laden Sie die erzeugte Datei über `data.downloadURL` herunter; bei `failed` protokollieren und behandeln Sie den zurückgegebenen Fehlergrund.

## Nächste Schritte

- Lesen Sie die [API-Konzepte](https://pdfcraft.ai/de-DE/docs/api/overview/) für Authentifizierung, Task-Status und Wiederholungen.
- Nutzen Sie die [API-Referenz](https://pdfcraft.ai/de-DE/api/), wenn Sie Details zu Request- und Response-Feldern benötigen.

## Vollständiges Beispiel ausführen

Laden Sie das [Python-3-Beispiel](https://pdfcraft.ai/examples/api-quickstart.py) herunter und prüfen Sie es. Es liest `PDF_CRAFT_API_KEY` aus der Umgebung, startet eine kostenpflichtige Konvertierung, speichert die Aufgaben-ID und prüft das Ergebnis mit einem Zeitlimit. Setzen Sie eine unterbrochene Aufgabe fort, statt sie erneut einzureichen.

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