Chuyển đến nội dung chính
PPDF123

Chèn ảnh vào tệp PDF

Chèn ảnh đặt một hình PNG, JPEG hoặc SVG lên PDF tại vị trí x và y bạn nhập, tính bằng điểm từ góc dưới bên trái. Công cụ chỉ đóng lên trang đầu, trừ khi bạn chọn mọi trang.

Kéo tệp vào đây, hoặc nhấp để chọn

Nhận PDF · tối đa 500.0 MB mỗi tệp · tối đa 20 tệp mỗi lần

Bạn cũng có thể dán tệp bằng Ctrl/Cmd+V hoặc từ menu clipboard.

Chèn ảnh đặt `imageFile` chồng lên trang tại `(x,y)` tính bằng điểm PDF (gốc ở góc dưới bên trái). Tệp raster trở thành một XObject Flate. SVG được in qua WeasyPrint rồi nhập vào dưới dạng Form. `everyPage=true` đóng lên mọi trang; nếu không thì chỉ trang đầu.

Tệp tải về có tên `overlayed_{base}.pdf`. Tệp có mật khẩu được mở khóa giúp bạn ngay trên trang này khi bạn nhập mật khẩu; người gọi API chạy Gỡ mật khẩu trước.

Không có trường co giãn; kích thước là chiều rộng/cao gốc của ảnh trong ma trận `cm`. Độ trong suốt không phải là tham số.

Muốn đóng dấu chữ thì dùng Thêm dấu. Muốn dùng một PDF khác làm lớp phủ thì dùng Chồng PDF.

Ảnh được vẽ lên trên nội dung trang hiện có, ở vị trí cuối cùng trong thứ tự vẽ của trang. Về mặt cấu trúc, nó không thay thế hay giấu đi thứ nằm bên dưới: chữ và hình bên dưới vẫn còn trong tệp, chỉ bị che ở chỗ ảnh đặc. Vì vậy nó hợp để đặt logo ở góc trống, và không phù hợp để che nội dung mật, việc đó cần công cụ bôi đen thật sự.

Vị trí chỉ là một điểm neo. `x` và `y` cho góc dưới bên trái của ảnh, tính bằng điểm từ góc dưới bên trái của trang, và ảnh trải sang phải và lên trên từ đó. Bạn không chọn được kích thước: ảnh raster được đặt với một điểm PDF cho mỗi điểm ảnh, nên một PNG 300 x 100 điểm ảnh chiếm 300 x 100 điểm, khoảng 4.2 x 1.4 inch. Trang letter là 612 x 792 điểm, nên ảnh rộng hơn nhiều sẽ tràn khỏi trang. Hãy đổi kích thước ảnh theo ý muốn trước khi tải lên.

Ảnh raster (PNG và JPEG) được giải mã và lưu lại dưới dạng RGB 8 bit. Độ trong suốt không được giữ, nên PNG có nền trong suốt có thể hiện một khối đặc thay cho vùng xuyên thấu. Nếu cần logo hòa với trang, hãy xuất nó với nền trắng hoặc nền khớp trước, hoặc chỉ đặt ở vùng trắng.

`everyPage=false` đặt ảnh chỉ ở trang 1; `everyPage=true` lặp lại ở cùng tọa độ trên mọi trang. Các trang khác khổ nhận cùng một điểm neo, nên trên tệp trộn khổ, dấu có thể rơi vào những chỗ khác nhau về mặt thị giác. Không có cách chọn riêng trang 2 và 5; hãy tách tệp, đóng ảnh vào phần bạn cần rồi gộp lại nếu cần việc đó.

Nếu tải lên thất bại, nguyên nhân thường gặp là tệp không phải ảnh mà bộ giải mã hiểu được, khi đó sẽ có thông báo loại tệp không được hỗ trợ, hoặc thiếu `imageFile`. Hãy xuất lại ảnh thành PNG hoặc JPEG rồi thử lại.

Tính năng

  • XObject raster, hoặc Form SVG qua WeasyPrint
  • `x`,`y` tính bằng điểm; trang đầu hoặc mọi trang
  • Không có điều khiển độ trong suốt hay tỷ lệ
  • API ẩn danh: /api/v1/misc/add-image

Khi nào nên dùng

  • Đặt logo PNG lên trang 1
  • Lặp một dấu trên mọi trang tại một điểm cố định
  • Thả một SVG qua WeasyPrint khi bạn chấp nhận độ trung thực như bản in
  • Thêm ảnh chữ ký quét vào dòng ký tên của một thỏa thuận một trang
  • Đặt con dấu công ty ở chân trang của mọi trang trong báo cáo có khổ trang đồng nhất

Làm thế nào để chèn ảnh vào PDF?

  1. Tải lên PDF và một ảnh (PNG, JPEG hoặc SVG).
  2. Đặt x và y bằng điểm từ góc dưới trái.
  3. Chọn chỉ trang đầu hoặc mọi trang.
  4. Tải overlayed_*.pdf và kiểm tra điểm neo.

Giới hạn và ngoại lệ

  • Không có trường co giãn/độ trong suốt
  • Chỉ một điểm neo: không chọn theo từng trang ngoài trang đầu hoặc mọi trang
  • Không gỡ hay giấu nội dung nằm dưới ảnh
  • Ảnh raster khổng lồ sẽ thành vị trí đặt khổng lồ trong PDF
  • Vùng trong suốt của PNG không được giữ: ảnh được chuyển sang RGB, nên điểm ảnh trong suốt lấy màu lưu bên dưới, thường là đen
  • Tệp có mật khẩu cần mật khẩu; người gọi API chạy Gỡ mật khẩu trước
  • Giới hạn tải lên trên trang web này: 500 MB mỗi tệp, tệp lớn hơn khoảng 95 MB được gửi theo từng phần. Một yêu cầu API trực tiếp bị giới hạn ở 100 MB.

Ví dụ

  • x=0 y=0 đặt góc dưới trái của ảnh vào góc dưới trái của trang
  • everyPage false giữ nguyên các trang từ 2 trở đi
  • Logo PNG 200 x 80 điểm ảnh với x=400, y=20 và everyPage=true nằm ở góc dưới bên phải của mọi trang letter, rộng 200 điểm, và tệp tải về tên overlayed_report.pdf với đầu vào tên report.pdf
  • Một ảnh chụp rộng 1800 điểm ảnh đặt tại x=0, y=0 phủ rộng hơn nhiều so với trang rộng 612 điểm, cho thấy kích thước đặt theo số điểm ảnh; hãy thu nhỏ ảnh còn khoảng 150 điểm ảnh rộng trước

Quyền riêng tư của công cụ này

Tệp được tải lên qua HTTPS, xử lý trong bộ nhớ hoặc thư mục tạm ngắn hạn trên máy chủ của chúng tôi, rồi bị xóa khi kết quả sẵn sàng. Chúng tôi không giữ bản sao để duyệt sau, huấn luyện hay lập hồ sơ quảng cáo. Thời hạn lưu giữ và thông báo cookie AdSense nằm trong Chính sách quyền riêng tư.

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

Sao logo to quá?
Ma trận cm dùng chiều rộng và cao theo điểm ảnh của ảnh làm đơn vị PDF. Một PNG 2000px rộng 2000 điểm.
y có tính từ trên xuống không?
Không. Không gian PDF có gốc ở góc dưới trái trên các trang thông thường.
Tôi đặt được độ trong suốt không?
Không. Lớp phủ là các lệnh vẽ đặc.
SVG có giữ vector không?
SVG được WeasyPrint in thành PDF một trang, rồi đặt vào dưới dạng form. Hãy kỳ vọng một bản in, không phải SVG chỉnh sửa được.
Làm sao để ảnh nhỏ lại?
Hãy đổi kích thước trước khi tải lên. Không có trường co giãn, và kích thước đặt vào theo số điểm ảnh của ảnh, nên logo 150 x 50 điểm ảnh chiếm 150 x 50 điểm.
Vì sao PNG trong suốt của tôi hiện hộp đen hoặc hộp đặc?
Ảnh được chuyển sang RGB và kênh alpha bị bỏ. Hãy xuất lại logo trên nền trắng, hoặc đặt nó ở phần trang màu trắng.
Tôi có thể đặt ảnh chỉ ở trang 3 không?
Không trực tiếp. Lựa chọn chỉ là trang 1 hoặc mọi trang. Hãy tách trang bạn cần, thêm ảnh ở đó rồi gộp các tệp lại theo thứ tự.
Tôi có thể dùng công cụ này để giấu chữ trên trang không?
Không an toàn. Chữ vẫn nằm trong tệp dưới ảnh và vẫn có thể được chọn hoặc trích xuất. Hãy dùng Bôi đen chữ khi nội dung cần bị gỡ đi.
Ảnh nằm ngoài trang. Làm sao tìm đúng tọa độ?
Đo từ góc dưới bên trái bằng điểm. Trên trang letter là 612 x 792, nên x=450 và y=40 đặt góc dưới trái của logo gần phía dưới bên phải, miễn là logo vừa trong 162 điểm chiều rộng còn lại.

Cập nhật lần cuối:

Gọi bằng mã

Mỗi công cụ trên trang là một API REST thông thường. Dùng ẩn danh không cần tài khoản hay API key. Trình duyệt, lập trình viên và agent đều gọi được.

curl -X POST "https://pdf123.xyz/api/v1/misc/add-image" \
  -F "[email protected]" \
  -F "[email protected]" \
  -F "x=0" \
  -F "y=0" \
  -F "everyPage=false" \
  -o output.pdf

Cũng có dạng công cụ MCP cho client dùng Model Context Protocol (JSON-RPC 2.0, POST /mcp). Tài liệu API đầy đủ

Dùng từ AI agent

Skill

Với skill này, Claude Code, Codex, Cursor và các AI agent khác có thể chạy "Chèn ảnh" thay bạn: /skills/pdf123-add-image.md

Tất cả skill cho agent

Tệp chỉ dùng cho lần xử lý này, xong là tự xóa.