PDF do JPG, PNG i WebP API
Wybierz pomiędzy rasteryzacją całych stron PDF a wyodrębnianiem osadzonych obrazów. Są to różne operacje o różnych wynikach.
Semantyka punktów końcowych i zadań#
Kod operacji: pdf_to_image
Rozpocznij tę operację za pomocą POST /v1/tasks oraz kod narzędzia pokazany powyżej. Prześlij i dołącz źródłowe pliki PDF (lub użyj punktów końcowych przesyłania o zakresie zadań), a następnie zadzwoń POST /v1/tasks/{task_id}/process z ustawieniami operacyjnymi.
Renderuj podglądy dokumentów lub odzyskuj obrazy osadzone w pliku PDF w celu ponownego wykorzystania.
Wejścia: 1–12 zweryfikowanych przesłanych plików PDF.
Konfiguracja i dodatkowe parametry#
| Ustawienie | Typ | Zachowanie |
|---|---|---|
| mode | pages | extract | strony rasteryzują całe strony; ekstrakt pobiera osadzone zasoby obrazu. Domyślnie: pages. |
| quality | normal | high | Żądana jakość renderowania strony. Domyślnie: normal. |
| output_format | jpg | png | webp | Format produkowanych plików obrazu rastrowego. Domyślnie: jpg. |
Opcje są sprawdzane przez API. Nieznane ustawienia i nieobsługiwane wartości zwracają błąd zamiast być ignorowane.
Robocza sekwencja żądań#
Programming language: cURL
Wybierz język · przewiń w poziomie, aby zobaczyć wszystkie 10 języków SDK
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"tool":"pdf_to_image"}'
# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'
# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
-H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
-d '{"options":{"mode":"pages","quality":"high","output_format":"jpg"}}'
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.
Wygenerowane pakiety do pobrania obejmują wyłącznie przebieg zadania. Zestawy SDK z pełną obsługą wymagają zweryfikowanej specyfikacji OpenAPI środowiska wykonawczego; przesyłanie strumieniowych plików SDK zadań Python, JavaScript i TypeScript; inne języki wymagają podpisanego przesyłania wieloczęściowego realizowanego przez osobę wywołującą.
Zwrócony identyfikator zadania jest używany zarówno do odpytywania stanu, jak i pobierania. Po pomyślnym wykonaniu zadania poproś o podpisany wyjściowy adres URL, zamiast osadzać klucz tajny pobierania.
Dane wyjściowe i ważne szczegóły#
Archiwum ZIP powstałych obrazów.
Ekstrakcja nie renderuje tekstu ani pełnych stron; użyj mode=pages, gdy potrzebujesz kompletnych obrazów stron.
Błędy, ponowne próby i rozliczenia