Trích xuất hình ảnh từ tài liệu PDF bằng C#

Mon, 12 Oct 2026 17:04:44 +0000

Việc trích xuất hình ảnh từ tài liệu PDF là một yêu cầu thường gặp khi xây dựng các quy trình xử lý tài liệu, đặc biệt là để tạo thumbnail hoặc tái sử dụng đồ họa ở nơi khác. GroupDocs.Parser Cloud SDK for .NET cung cấp một API mạnh mẽ giúp công việc này trở nên đơn giản trong C#. Trong hướng dẫn này, bạn sẽ học cách tải lên một tệp PDF, lấy tất cả các hình ảnh nhúng, lưu chúng cục bộ và tùy chọn xóa tệp trên máy chủ, kèm theo mã đầy đủ và các ví dụ REST.

Các bước để trích xuất hình ảnh từ tài liệu PDF trong C#

Upload PDF to GroupDocs Cloud storage: Sử dụng StorageApi.UploadFile để đặt tệp PDF nguồn lên đám mây.

var uploadRequest = new UploadFileRequest(remotePdfPath, File.ReadAllBytes(localPdfPath));
storageApi.UploadFile(uploadRequest);

Lệnh này đảm bảo tệp có thể truy cập để phân tích.

Yêu cầu hình ảnh tài liệu: Gọi ParserApi.GetDocumentImages với một GetDocumentImagesRequest.

var imagesRequest = new GetDocumentImagesRequest(remotePdfPath);
ImagesResult imagesResult = parserApi.GetDocumentImages(imagesRequest);

Phản hồi chứa một tập hợp các đối tượng ImageInfo, mỗi đối tượng chứa dữ liệu Base64 và siêu dữ liệu. Xem Tham chiếu API để biết chi tiết đầy đủ.

Giải mã và lưu mỗi hình ảnh: Duyệt qua imagesResult.Images, chuyển chuỗi Base64 thành mảng byte và ghi tệp ra đĩa.

foreach (ImageInfo imgInfo in imagesResult.Images)
{
    byte[] imageBytes = Convert.FromBase64String(imgInfo.Base64Data);
    string extension = imgInfo.FileExtension?.TrimStart('.').ToLower() ?? "bin";
    string fileName = $"extracted_page{imgInfo.PageNumber}_img{imgInfo.ImageIndex}_{imageCounter}.{extension}";
    File.WriteAllBytes(fileName, imageBytes);
}

Bảng điều khiển ghi lại tên tệp đã lưu, kích thước và DPI để xác minh.

(Tùy chọn) Dọn dẹp PDF từ xa: Sau khi trích xuất, bạn có thể xóa tệp đã tải lên để giữ cho bộ nhớ sạch sẽ.

var deleteRequest = new DeleteFileRequest(remotePdfPath);
storageApi.DeleteFile(deleteRequest);

Bước này được bọc trong khối try‑catch để bỏ qua bất kỳ lỗi dọn dẹp nào.

Xem lại đầu ra: Bảng điều khiển sẽ hiển thị một bản tóm tắt như Total images extracted: 12, xác nhận việc trích xuất thành công.

Ví dụ mã hoàn chỉnh: Trích xuất hình ảnh từ tài liệu PDF bằng GroupDocs.Parser

Ví dụ sau đây trình bày quy trình làm việc đầy đủ đã mô tả ở trên. Nó bao gồm cấu hình, tải lên, trích xuất hình ảnh, lưu và dọn dẹp tùy chọn.

using System;
using System.IO;
using System.Collections.Generic;
using GroupDocs.Parser.Cloud.Sdk.Api;
using GroupDocs.Parser.Cloud.Sdk.Client;
using GroupDocs.Parser.Cloud.Sdk.Model;
using GroupDocs.Parser.Cloud.Sdk.Model.Requests;

namespace ExtractImagesFromPdf
{
    class Program
    {
        static void Main(string[] args)
        {
            // Configuration – replace with your actual credentials
            var config = new Configuration
            {
                ClientId = "YOUR_CLIENT_ID",
                ClientSecret = "YOUR_CLIENT_SECRET"
            };

// APIs
            var storageApi = new StorageApi(config);
            var parserApi = new ParserApi(config);

// Input PDF path (local) and remote name in storage
            const string localPdfPath = "input.pdf";
            const string remotePdfPath = "input.pdf";

try
            {
                // -------------------------------------------------
                // 1. Upload PDF to GroupDocs Cloud storage (if not already there)
                // -------------------------------------------------
                if (!File.Exists(localPdfPath))
                    throw new FileNotFoundException($"Local file not found: {localPdfPath}");

var uploadRequest = new UploadFileRequest(remotePdfPath, File.ReadAllBytes(localPdfPath));
                storageApi.UploadFile(uploadRequest);

// -------------------------------------------------
                // 2. Retrieve document images (all pages)
                // -------------------------------------------------
                var imagesRequest = new GetDocumentImagesRequest(remotePdfPath);
                ImagesResult imagesResult = parserApi.GetDocumentImages(imagesRequest);

// -------------------------------------------------
                // 3. Save each extracted image to disk
                // -------------------------------------------------
                int imageCounter = 0;
                foreach (ImageInfo imgInfo in imagesResult.Images)
                {
                    // Image data is returned as Base64 string
                    byte[] imageBytes = Convert.FromBase64String(imgInfo.Base64Data);

// Build a descriptive file name
                    string extension = imgInfo.FileExtension?.TrimStart('.').ToLower() ?? "bin";
                    string fileName = $"extracted_page{imgInfo.PageNumber}_img{imgInfo.ImageIndex}_{imageCounter}.{extension}";
                    File.WriteAllBytes(fileName, imageBytes);

Console.WriteLine($"Saved: {fileName} ({imgInfo.Width}x{imgInfo.Height} px, {imgInfo.Resolution} DPI)");
                    imageCounter++;
                }

Console.WriteLine($"Total images extracted: {imageCounter}");
            }
            catch (ApiException apiEx)
            {
                Console.Error.WriteLine($"GroupDocs API error: {apiEx.ErrorCode} - {apiEx.Message}");
            }
            catch (Exception ex)
            {
                Console.Error.WriteLine($"Unexpected error: {ex.Message}");
            }
            finally
            {
                // -------------------------------------------------
                // 4. Optional cleanup – delete the uploaded PDF from storage
                // -------------------------------------------------
                try
                {
                    var deleteRequest = new DeleteFileRequest(remotePdfPath);
                    storageApi.DeleteFile(deleteRequest);
                }
                catch
                {
                    // Ignored – cleanup is optional
                }
            }
        }
    }
}

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Trích xuất hình ảnh qua REST API bằng cURL

Các thao tác tương tự có thể được thực hiện bằng các cuộc gọi REST trực tiếp. Dưới đây là quy trình cURL tối thiểu.

Lấy token truy cập (OAuth 2.0 client credentials grant).

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Phản hồi chứa access_token.

Tải lên PDF đến bộ nhớ đám mây.

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

Yêu cầu hình ảnh cho tài liệu đã tải lên.

curl -X GET "https://api.groupdocs.cloud/v2.0/parser/input.pdf/images" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Phản hồi JSON bao gồm một mảng các hình ảnh với base64Data, fileExtension, pageNumber, v.v.

Lưu mỗi hình ảnh cục bộ (ví dụ sử dụng jq và base64).

curl -X GET "https://api.groupdocs.cloud/v2.0/parser/input.pdf/images" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" | \
     jq -r '.images[] | "\(.pageNumber)_\(.imageIndex).\(.fileExtension) \(.base64Data)"' | \
     while read filename b64; do
         echo "$b64" | base64 -d > "$filename"
     done

Để biết thêm chi tiết về các điểm cuối và tham số, xem tài liệu API chính thức.

Chuẩn bị môi trường

Cài đặt thư viện khách hàng .NET thông qua NuGet:

dotnet add package GroupDocs.Parser-Cloud

Gói có sẵn từ trang tải xuống chính thức.

Đảm bảo rằng bạn đã cài đặt .NET 6.0 hoặc phiên bản mới hơn và có một tài khoản GroupDocs Cloud hợp lệ với thông tin xác thực client.

(Tùy chọn) Sao chép kho mẫu để tham khảo:

git clone https://github.com/groupdocs-parser-cloud/groupdocs-parser-cloud-dotnet.git

Điều gì làm cho GroupDocs.Parser phù hợp cho việc trích xuất hình ảnh

Truy xuất hình ảnh trực tiếp: Lệnh GetDocumentImages trả về hình ảnh ở định dạng gốc mà không cần các bước chuyển đổi bổ sung.
Cung cấp dưới dạng Base64: Hình ảnh được cung cấp dưới dạng chuỗi Base64, giúp dễ dàng giải mã trong bất kỳ ngôn ngữ nào.
Siêu dữ liệu cấp trang: Mỗi ImageInfo bao gồm số trang, kích thước, độ phân giải và chỉ mục, giúp tổ chức các tài sản đã trích xuất.
Hỗ trợ tất cả các định dạng raster phổ biến: PNG, JPEG, BMP, GIF, TIFF và nhiều định dạng khác được giữ nguyên như khi lưu trong PDF.
Xử lý đám mây có khả năng mở rộng: Các PDF lớn được xử lý trên máy chủ GroupDocs, giảm áp lực bộ nhớ cho ứng dụng của bạn.

Cấu hình tùy chọn trích xuất hình ảnh

Trong khi ví dụ cơ bản hoạt động ngay lập tức, bạn có thể tinh chỉnh yêu cầu:

Xác định phạm vi trang: Thêm pages = "1-5" vào GetDocumentImagesRequest để giới hạn việc trích xuất.
Đặt chất lượng hình ảnh: Sử dụng tham số imageQuality (0‑100) nếu bạn cần đầu ra đã nén.
Lọc theo định dạng: Cung cấp fileExtensions = ["png","jpeg"] để nhận chỉ các định dạng đã chọn.

Các tùy chọn này được ghi lại trong Tham chiếu API.

Kết luận

Việc trích xuất hình ảnh từ tài liệu PDF trong C# trở nên đơn giản và đáng tin cậy khi bạn sử dụng GroupDocs.Parser Cloud SDK for .NET. SDK xử lý việc tải lên, phân tích và chuyển đổi sang Base64, cho phép bạn tập trung vào việc lưu tệp và tích hợp chúng vào quy trình làm việc của mình. Hãy nhớ bảo mật thông tin xác thực client, tuân thủ các điều khoản cấp phép, và cân nhắc sử dụng giấy phép tạm thời để đánh giá tại trang giấy phép tạm thời. Với mã và các ví dụ REST được cung cấp, bạn đã sẵn sàng thêm chức năng trích xuất hình ảnh PDF mạnh mẽ vào bất kỳ ứng dụng .NET nào.

Câu hỏi thường gặp

Làm thế nào để tôi trích xuất hình ảnh từ tài liệu PDF bằng C#?
Sử dụng phương thức GetDocumentImages của Parser API sau khi tải lên PDF bằng StorageApi.UploadFile. Giải mã các chuỗi Base64 trả về và ghi chúng vào đĩa, như được minh họa trong ví dụ mã.

Nếu PDF được bảo vệ bằng mật khẩu thì sao?
Bao gồm mật khẩu trong mô hình yêu cầu. SDK sẽ giải mã tệp trước khi trích xuất hình ảnh. Xem tài liệu để biết tên thuộc tính chính xác.

Tôi có thể giới hạn việc trích xuất chỉ ở các trang cụ thể không?
Có, hãy đặt thuộc tính pages trên GetDocumentImagesRequest thành danh sách hoặc phạm vi phân tách bằng dấu phẩy (ví dụ, "1-3,5"). API sẽ trả về hình ảnh chỉ từ các trang đó.

Có giới hạn kích thước nào cho các hình ảnh đã trích xuất không?
SDK trả về dữ liệu hình ảnh gốc mà không thay đổi kích thước. Nếu bạn cần các tệp nhỏ hơn, hãy xử lý hậu kỳ các hình ảnh đã lưu bằng bất kỳ thư viện xử lý hình ảnh nào.

image extraction techniques on Document Processing REST APIs | GroupDocs Cloud