# Schnellstart

Führen Sie Ihren ersten API-Aufruf aus und laden Sie eine Excel-Datei herunter.

Offizielle Dokumentation: https://img2excel.net/de/docs/api/getting-started

Die IMG2Excel API wandelt Tabellenbilder in bearbeitbare Excel-Arbeitsmappen um. Wir empfehlen den synchronen Endpunkt: Bild hochladen, Konvertierung abwarten und die XLSX-Datei über die zurückgegebene URL herunterladen. Asynchrone Endpunkte bleiben verfügbar.

| Parameter | Wert |
| --- | --- |
| Basis-URL | `https://img2excel.net` |
| Authentifizierung | `Authorization: Bearer $IMG2EXCEL_API_KEY` |
| API-Zugang | Business- oder Professional-Credit-Paket |
| Eingabe | Ein PNG-, JPG- oder JPEG-Bild, maximal 4 MB |
| Ausgabe | Eine bearbeitbare `.xlsx`-Datei |

## 1. API-Schlüssel einrichten

Kopieren Sie Ihren Schlüssel aus den [API-Einstellungen](https://img2excel.net/de/settings/api) und speichern Sie ihn in einer serverseitigen Umgebungsvariable:

```bash
export IMG2EXCEL_API_KEY="your_api_key"
```

Halten Sie den Schlüssel geheim. Er gehört weder in Browsercode noch in ein öffentliches Repository.

## 2. Tabellenbild hochladen

Wählen Sie den passenden Endpunkt für Ihr Bild:

| Bild | Endpunkt |
| --- | --- |
| Gedruckte Tabelle, Screenshot oder gescanntes Tabellenblatt | [Bild zu Excel](https://img2excel.net/de/docs/api/image-to-excel) |
| Handschriftliche Tabelle, Protokoll oder Aufzeichnung | [Handschrift zu Excel](https://img2excel.net/de/docs/api/handwriting-to-excel) |

Das Beispiel sendet eine gedruckte Tabelle. Ersetzen Sie `table.png` durch Ihren Bildpfad. Für Handschrift verwenden Sie `/api/v1/handwriting-to-excel`.

```bash
curl --fail-with-body --max-time 330 -i https://img2excel.net/api/v1/image-to-excel \
  -H "Authorization: Bearer $IMG2EXCEL_API_KEY" \
  -H "Idempotency-Key: table-import-001" \
  -F "file=@table.png"
```

Verwenden Sie für jedes neue Bild einen neuen `Idempotency-Key`. Nutzen Sie denselben Wert nur bei Wiederholungen desselben Uploads.

Nach erfolgreicher synchroner Konvertierung erhalten Sie **200 OK** mit `result.download_url`. Die folgende URL ist ein Beispiel; verwenden Sie die URL aus Ihrer Antwort.

```json
{
  "id": "job_0123456789abcdef0123456789abcdef",
  "type": "image-to-excel",
  "status": "succeeded",
  "credits_reserved": 1,
  "credits_used": 1,
  "created_at": "2026-10-04T09:00:00.000Z",
  "completed_at": "2026-10-04T09:00:08.000Z",
  "result": {
    "filename": "table_result.xlsx",
    "content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "size_bytes": 17330,
    "download_url": "https://signed-storage-url.example/...",
    "download_url_expires_in": 900
  }
}
```

Der synchrone Endpunkt wartet auf die Konvertierung. Setzen Sie das HTTP-Client-Timeout auf 330 Sekunden. Bei einem Verbindungs-Timeout wiederholen Sie den Aufruf mit demselben `Idempotency-Key`. Ein neuer Schlüssel startet eine neue Konvertierung.

## 3. Excel-Datei herunterladen

Kopieren Sie `result.download_url` aus der erfolgreichen Antwort:

```bash
curl --fail --location "PASTE_RESULT_DOWNLOAD_URL_HERE" --output table.xlsx
```

Die Download-URL gilt 15 Minuten. Ergebnisse bleiben nach Abschluss 24 Stunden verfügbar. Rufen Sie den Auftrag in diesem Zeitraum erneut ab, um eine neue URL zu erhalten. Fehlgeschlagene Konvertierungen verbrauchen keine Credits.

## Asynchrone Konvertierung (optional)

Für Hintergrundverarbeitung ergänzen Sie den Endpunkt um `/jobs`. Neue Aufträge liefern `202`, ihre ID und den Header `Location`. Fragen Sie diese URL alle 2–3 Sekunden ab, bis `succeeded`, `failed` oder `expired` erreicht ist. Ein Polling-Skript finden Sie unter [Aufträge und Fehler](https://img2excel.net/de/docs/api/jobs).

Eine fehlgeschlagene synchrone Konvertierung liefert `422` mit `error.code` und `error.message`. Derselbe Idempotenzschlüssel liefert bei Wiederholung den ursprünglichen Auftrag. Läuft dieser noch, erhalten Sie `202`; fragen Sie die `Location`-URL ab. Ein abgelaufenes Ergebnis liefert `410`.

## KI-Programmierassistent verwenden

Wählen Sie oben **Für KI kopieren** und fügen Sie die Anweisungen in ChatGPT, Claude, Gemini, Cursor oder einen anderen Assistenten ein. Geben Sie Ihre serverseitige Programmiersprache und den Tabellentyp an: gedruckt oder handschriftlich. Jede Endpunktseite bietet ebenfalls eine Kopierfunktion und Python-/Node.js-Beispiele.

Die vollständige API-Definition finden Sie in der [OpenAPI-Spezifikation](https://img2excel.net/api/openapi.json) oder der [vollständigen API-Dokumentation](https://img2excel.net/de/docs/api/text/llms-full.txt).

---

OpenAPI 3.1: https://img2excel.net/api/openapi.json
Vollständige API-Dokumentation: https://img2excel.net/de/docs/api/text/llms-full.txt