Einführung
Die AI Processing API ermöglicht die Verarbeitung von Texten und Dateien mittels verschiedener KI-Modelle. Mit dieser API können Sie:
- Texte analysieren und verarbeiten
- Dokumente und Bilder verarbeiten
- KI-gestützte Antworten generieren
Base URL
https://api.scanpdf.de/index.php
Authentifizierung
Alle API-Anfragen erfordern einen API-Key, der im Header mitgesendet werden muss.
X-Api-Key: 123-your-api-key
API-Key erhalten
Um einen API-Key zu erhalten, senden Sie uns einfach eine E-Mail an post@mr-money.de
Wichtig:
Behandeln Sie Ihren API-Key vertraulich und teilen Sie ihn nicht mit anderen. Bei Verlust oder Kompromittierung, melden Sie sich umgehend bei uns.
KI-Models
Request Parameter ai_variant und ai_model
| ai_variant | ai_model | Name | Beschreibung |
|---|---|---|---|
| chatgpt | 4o | ChatGPT-4o | |
| chatgpt | o4-mini | ChatGPT-o4-Mini | |
| chatgpt | 4.1 | ChatGPT-4.1 | |
| chatgpt | 4.1-mini | ChatGPT-4.1-Mini | |
| chatgpt | 4o-mini | ChatGPT-4o-Mini | |
| claude | sonnet | Claude-4-Sonnet | |
| claude | haiku | Claude-3-5-Haiku | |
| gemini | pro25 | Gemini 2.5 Pro preview-05-06 | |
| gemini | flash25 | Gemini 2.5 Flash preview-04-17 | |
| fireworks | deepseek-v3 | DeepSeek V3 KI über Fireworks | Kann nur reine Text-PDFs verarbeiten, ggf. OCR aktivieren |
| mistral | small | Mistral Small Latest | PDFs werden vorher OCR extrahiert und der Text wird übertragen |
| mistral | medium | Mistral Medium Latest | PDFs werden vorher OCR extrahiert und der Text wird übertragen |
| mistral | large | Mistral Large Latest | PDFs werden vorher OCR extrahiert und der Text wird übertragen |
OCR Text-Extraktion
Für KI-Modelle die keine Bilder verarbeiten können, kann OCR aktiviert werden.
"use_ocr" => true,
Wichtig:
Die gesamte Verarbeitungszeit verlängert sich dadurch.
Sollte nur im Notfall verwendet werden.
Beispiele
Request Beisiel
' PHP Beispiel mit cURL
$apiKey = "IHR_API_KEY";
$url = "https://api.scanpdf.de/index.php";
$data = array(
"ai_variant" => "chatgpt",
"ai_model" => "4o-mini",
"prompt" => "Ermittle die Anzahl der Obstsorten aus dem Text der Dokumente",
"files" => [
"base64_encoded_file1",
"base64_encoded_file2",
"base64_encoded_file3",
]
);
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Api-Key: " . $apiKey
],
CURLOPT_POSTFIELDS => json_encode($data)
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$result = json_decode($response, true);
curl_close($ch);
if ($httpCode == 200) {
echo "Ergebnis: " . $result["response"]["content"];
} else {
echo "Fehler: " . print_r($result, 1);
}
Response Beispiel
{
"status":200,
"message":"",
"response":{
"...": "...",
"content":"ANTWORT_VON_DER_KI",
"...": "...",
"usage":{
"input_tokens":1586,
"output_tokens":291,
"...": "...",
}
"...": "...",
}
}
Rate Limits
Um unseren Service stabil zu halten, gelten folgende Limitierungen:
| Plan | Requests/Stunde |
|---|---|
| Default | 100 |
Rate Limit Headers
Jede API-Antwort enthält die folgenden Header:
x-rate-limit: 100
x-rate-usage: 34
x-rate-limit-remaining: 66
Fehlercodes
Die API verwendet Standard HTTP-Statuscodes und zusätzliche Fehlermeldungen im JSON-Format.
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Die Anfrage wurde erfolgreich verarbeitet |
| 400 | Bad Request | Ungültige Anfrageparameter oder Fehler bei der Verarbeitung etc. Bitte Fehlermeldung beachten |
| 401 | Unauthorized | Fehlender oder ungültiger API-Key |
| 429 | Too Many Requests | Rate Limit überschritten |
| 500 | Internal Server Error | Serverfehler bei der Verarbeitung |
Beispiel-Fehlerantwort
{
"status": "429",
"message": "Rate limit exceeded.",
}
Support
Geschäftszeiten
Unser Support-Team ist für Sie da:
- Montag - Freitag: 9:00 - 16:00 Uhr
- Notfall-Support: 24/7 für Enterprise-Kunden