Files
SnapOtter/apps/docs/vi/tools/pdf/ocr-pdf.md
T
SnapOtterandGitHub 4963ab3bbd feat(docs-i18n): translate all documentation into 20 languages
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
2026-07-11 13:52:47 +08:00

2.3 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Trích xuất văn bản từ tài liệu PDF bằng OCR hỗ trợ AI. 1431fcba180b human 49576592ebd9

PDF OCR

Trích xuất văn bản từ tài liệu PDF bằng nhận dạng ký tự quang học hỗ trợ AI. Hỗ trợ nhiều bậc chất lượng và ngôn ngữ. Yêu cầu cài đặt gói tính năng OCR.

API Endpoint

POST /api/v1/tools/pdf/ocr-pdf

Chấp nhận dữ liệu biểu mẫu multipart với một tệp PDF và một trường JSON settings tùy chọn.

Parameters

Tham số Kiểu Bắt buộc Mặc định Mô tả
quality string Không "balanced" Bậc chất lượng OCR: fast, balanced, best
language string Không "auto" Ngôn ngữ tài liệu: auto, en, de, fr, es, zh, ja, ko
pages string Không "all" Chọn trang, ví dụ "all", "1-3", "1,3,5"

Example Request

curl -X POST http://localhost:1349/api/v1/tools/pdf/ocr-pdf \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@scanned.pdf" \
  -F 'settings={"quality": "best", "language": "en", "pages": "1-5"}'

Example Response

Trả về 202 Accepted. Theo dõi tiến độ qua SSE tại /api/v1/jobs/{jobId}/progress.

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Notes

  • Định dạng đầu vào được chấp nhận: .pdf.
  • Đây là một công cụ AI yêu cầu cài đặt gói tính năng OCR. Nếu gói chưa được cài đặt, API trả về 501 Not Implemented.
  • Bậc chất lượng fast dùng một mô hình nhẹ hơn để xử lý nhanh hơn; best dùng một mô hình chính xác hơn nhưng đánh đổi bằng tốc độ.
  • Cài đặt ngôn ngữ auto cố gắng phát hiện ngôn ngữ tài liệu một cách tự động.
  • Bạn có thể nhắm đến các trang cụ thể bằng cách dùng phạm vi ("1-3"), danh sách ngăn cách bằng dấu phẩy ("1,3,5"), hoặc "all" cho mọi trang.
  • Đối với các PDF đã chứa văn bản có thể chọn được, hãy cân nhắc dùng công cụ PDF to Text nhanh hơn thay thế.