<!-- Source: https://9pic.ai/vi/blog/export-event-photo-data-json/ -->
![Nền họa tiết sọc trừu tượng](/images/stripes.svg)

[Quay lại blog](/vi/blog/)

![Cách xuất dữ liệu ảnh sự kiện dưới dạng JSON: mỗi ảnh một mục với số BIB, thẻ thủ công, tên tệp và đường dẫn](https://bgimg.9pic.ai/images/blog/export-event-photo-data-json.jpg?title=C%C3%A1ch+xu%E1%BA%A5t+d%E1%BB%AF+li%E1%BB%87u+%E1%BA%A3nh+s%E1%BB%B1+ki%E1%BB%87n+c%E1%BB%A7a+b%E1%BA%A1n+d%C6%B0%E1%BB%9Bi+d%E1%BA%A1ng+JSON&amp;subtitle=M%E1%BB%97i+%E1%BA%A3nh+m%E1%BB%99t+m%E1%BB%A5c%3A+s%E1%BB%91+BIB%2C+th%E1%BA%BB+th%E1%BB%A7+c%C3%B4ng%2C+t%C3%AAn+t%E1%BB%87p+v%C3%A0+%C4%91%C6%B0%E1%BB%9Dng+d%E1%BA%ABn%2C+trong+m%E1%BB%99t+t%E1%BB%87p.&amp;kicker=H%C6%B0%E1%BB%9Bng+d%E1%BA%ABn+d%E1%BB%AF+li%E1%BB%87u&amp;author=%C4%90%E1%BB%99i+ng%C5%A9+9Pic+AI&amp;readTime=7+ph%C3%BAt&amp;lang=vi)

**Tóm tắt**: mở sự kiện, vào **Photo**, rồi **Tools**, và chọn **Photos to Data Export**. Đánh dấu các trường trong **Fields to include**, chọn **Export**, rồi tải tệp JSON xuống khi hiện **Ready**. Mỗi ảnh đã xử lý có một mục, kể cả ảnh không có số BIB.

Tệp xuất cho bạn những gì
----------------------------------

Photos to Data Export trả lời một câu hỏi cho mỗi ảnh trong sự kiện: ảnh này có những thông tin gì? Tệp có một mục cho mỗi ảnh đã xử lý, dùng ID ảnh làm khóa, kèm các trường bạn đã chọn.

Đây là cách xuất phù hợp khi bạn bắt đầu từ ảnh:

- **Đối chiếu thẻ với ảnh gốc.** Tên tệp và đường dẫn cho biết mỗi mục ứng với tệp nào trong thư mục của nhiếp ảnh gia.
- **Tìm những ảnh không ai tìm thấy.** Ảnh không có số BIB vẫn nằm trong tệp với danh sách rỗng, sẵn sàng để xem lại.
- **Lưu hồ sơ của riêng bạn.** Bản sao thẻ của sự kiện tại một ngày cụ thể, để lưu trữ hoặc dùng cho hệ thống khác.


Nếu bạn bắt đầu từ vận động viên và cần từng số BIB kèm ảnh, hãy dùng [Bib to Data Export](/vi/blog/export-race-photos-by-bib-number/).

Bước 1: Mở công cụ
--------------------------

Trong bảng điều khiển, mở sự kiện, vào **Photo** và chọn tab **Tools**. Chọn **Photos to Data Export**. Công cụ này trước đây tên là Photos to Bib Export, và các đường liên kết cũ vẫn mở được.

Trang có hai cột. Bên trái là các trường và nút **Export**. Bên phải là **Latest export** và bản xem trước tệp. Trước lần xuất đầu tiên, bên phải hiển thị **Example file** để bạn thấy cấu trúc tệp.

Bước 2: Chọn trường dữ liệu
---------------------------------------

**Bibs** và **Manual tags** được đánh dấu sẵn. Thêm các trường khác nếu cần. Bạn phải chọn ít nhất một trường.

| Trường | Nội dung |
| --- | --- |
| **Bibs** | Các số BIB giúp người tham gia tìm thấy ảnh: số BIB được nhận diện cộng thẻ thủ công của bạn, trừ những số bạn đã xóa. |
| **Manual tags** | Số BIB bạn đã thêm thủ công trong Manual Tagging. |
| **Original file name** | Tên của ảnh khi được nhập vào. |
| **File path** | Vị trí của ảnh trong nguồn, gồm cả tên ảnh. Với ảnh tải lên 9Pic, đó là thư mục bên trong lượt tải lên. Với Google Drive, Dropbox, OneDrive, Box hoặc SharePoint, đó là đường dẫn bên trong thư mục được chia sẻ. Để trống với ảnh từ đường liên kết tùy chỉnh. |
| **Detected bibs** | Số BIB tìm thấy trên ảnh, trước khi bạn xóa bất kỳ số nào. |
| **Removed bibs** | Số BIB được nhận diện mà bạn đã xóa trong Manual Tagging. |
| **Detected text** | Toàn bộ chữ đọc được trên ảnh, như tên nhà tài trợ và biển hiệu. |

Mỗi trường thêm vào làm tệp lớn hơn. Detected text làm tệp tăng nhiều nhất, vì vậy hãy bỏ chọn nếu bạn không dùng đến.

Các ô đánh dấu mặc định theo các trường của lần xuất gần nhất. Nếu bạn thay đổi, một ghi chú sẽ nhắc bạn xuất lại để tệp khớp với lựa chọn.

Bước 3: Xuất và tải xuống
-----------------------------------

Chọn **Export**. Quá trình xuất chạy ở chế độ nền và hiển thị số ảnh đã đọc. Bạn có thể rời trang rồi quay lại. Một sự kiện lớn mất khoảng một phút.

Khi hiện **Ready**, ô **Latest export** cho biết thời điểm xuất, dung lượng tệp và ba con số: **Photos**, **Bibs** và **Photos without bibs**. Ô này cũng liệt kê các trường trong tệp. Chọn **Download JSON** để lưu tệp.

Mỗi sự kiện giữ lần xuất gần nhất của từng loại, vì vậy lần xuất mới sẽ thay thế lần xuất đang hiển thị trên trang.

Bước 4: Đọc tệp
-----------------------

Mọi tệp đều bắt đầu bằng cùng các thông tin: `event_id`, `export_type`, `generated_at`, `options` (các trường được đưa vào) và `counts`. Ảnh nằm trong `data`. Dưới đây là một tệp có tên tệp, đường dẫn tệp, số BIB và thẻ thủ công:

    {
      "event_id": 6109,
      "export_type": "photos_to_bib",
      "generated_at": "2026-11-13T09:30:00+00:00",
      "options": ["file_name", "file_path", "bibs", "manual_tags"],
      "counts": {"photos": 30240, "bibs": 7374, "photos_without_bibs": 2086},
      "data": {
        "3f2a...c91e": {
          "file_name": "IMG_4821.jpg",
          "file_path": "Habit Run 2026/Finish line/IMG_4821.jpg",
          "bibs": ["1024", "2210"],
          "manual_tags": ["2210"]
        },
        "9d03...6b7f": {
          "file_name": "IMG_4822.jpg",
          "file_path": "Habit Run 2026/Finish line/IMG_4822.jpg",
          "bibs": [],
          "manual_tags": []
        }
      }
    }

Một vài điểm cần biết khi đọc tệp:

- Khóa của mỗi mục là ID ảnh trong 9Pic AI, không phải tên tệp. Đánh dấu **Original file name** khi bạn cần tên tệp.
- Ảnh không có số BIB vẫn được liệt kê, với danh sách rỗng. Đó là cách `photos_without_bibs` được đếm.
- Ảnh từ đường liên kết tùy chỉnh có đường dẫn tệp là `null` vì ảnh không nằm trong thư mục nào.


Kiểm tra trước khi tải xuống
-------------------------------------

Bên dưới lần xuất gần nhất, **File preview** hiển thị phần đầu của tệp theo cùng bố cục. Chọn một khóa hoặc mũi tên của khóa để mở hoặc thu gọn, hoặc dùng **Expand all** và **Collapse all**. **Raw** hiển thị văn bản thuần với số dòng, còn **Copy** sao chép bản xem trước.

Bản xem trước chứa 20 ảnh đầu tiên, và danh sách dài được rút gọn bằng một dòng như "… 5 more items in the download". Các mục đã thu gọn cho biết số khóa hoặc phần tử chúng chứa trong tệp đầy đủ, nên các con số vẫn chính xác dù bản xem trước ngắn.

Ba cách dùng thực tế
--------------------------

### Đối chiếu thẻ với ảnh gốc của nhiếp ảnh gia

Đánh dấu **Original file name** và **File path**. Mỗi mục giờ cho biết ảnh đến từ tệp nào trong thư mục nào, để nhiếp ảnh gia hoặc biên tập viên tìm ảnh gốc của một số BIB mà không cần tìm trong thư viện ảnh.

### Tìm ảnh không có số BIB

Tìm các mục có danh sách `bibs` rỗng. Nhiều ảnh trong số đó là ảnh khán giả, phong cảnh hoặc vạch xuất phát. Số khác có thể là vận động viên bị che mất số BIB. Những ảnh này đáng được xem lại trong Manual Tagging; xem [cách gắn thẻ số BIB thủ công sau AI](/vi/blog/manual-bib-tagging-after-ai/).

### Kiểm tra những gì đã được sửa

Đánh dấu **Detected bibs** và **Removed bibs** để xem tính năng đọc số BIB đã tìm thấy gì và đội của bạn đã bỏ đi gì. Đây là cách nhanh để rà soát một lượt gắn thẻ, hoặc giải thích vì sao một vận động viên không còn tìm thấy một ảnh.

Thế nào được tính là số BIB
--------------------------------------

Chỉ ảnh **đã xử lý** mới có trong tệp. Trường **Bibs** tuân theo cùng quy tắc với tính năng tìm ảnh của người tham gia:

- Số BIB tìm thấy theo cài đặt nhận diện số BIB của sự kiện. Khi sự kiện dùng danh sách số BIB, chỉ những số có trong danh sách mới được tính.
- Trừ các số BIB được nhận diện mà bạn đã xóa.
- Cộng thẻ thủ công của bạn, kể cả trước khi chúng được công bố cho tính năng tìm ảnh của người tham gia.


Vì vậy tệp khớp với những gì người tham gia tìm thấy, và thẻ thủ công mới nhất của bạn được đưa vào sớm.

FAQ
---

### Tệp có tự cập nhật khi tôi thay đổi thẻ không?

Không. Tệp thể hiện các thẻ tại thời điểm xuất. Sau khi gắn thẻ, chọn **Export again**.

### Gói nào có tính năng này?

Mọi gói. Tính năng này vẫn hoạt động sau khi gói kết thúc, nên bạn vẫn mang dữ liệu của mình theo được.

### Xuất tệp thất bại. Tôi nên làm gì?

Chọn **Export again**. Nếu tải xuống thất bại, hãy thử lại một lần nữa: mỗi lần nhấn sẽ tạo một đường liên kết tải xuống mới.

### Tôi có thể mở tệp trong bảng tính không?

JSON được tạo ra cho phần mềm, nên cách đơn giản nhất là chuyển tệp cho người phụ trách hệ thống kết quả hoặc đăng ký của bạn. Hầu hết công cụ dữ liệu và tiện ích bổ sung cho bảng tính cũng nhập được JSON.

Bước tiếp theo
-------------------

Chạy lần xuất đầu tiên với các trường mặc định và mở File preview để xem cấu trúc dữ liệu của sự kiện. Sau đó thêm tên tệp và đường dẫn nếu bạn cần đối chiếu với ảnh gốc. Để có danh sách từng số BIB kèm ảnh, hãy đọc [cách xuất ảnh giải chạy theo số BIB](/vi/blog/export-race-photos-by-bib-number/). Việc đọc số BIB được giới thiệu trên trang [BibTrack](/vi/products/bibtrack/).

Sẵn sàng bắt đầu?
-------------------------

Tham gia cùng các đơn vị tổ chức sự kiện đã dùng 9Pic AI để lưu trữ ảnh, tìm ảnh bằng AI và phân phối hình ảnh, đưa hơn 100 triệu ảnh đến hơn 5 triệu người tham gia tại hơn 5.000 sự kiện.

[Bắt đầu](https://admin.9pic.ai/sign-up) [Đặt lịch demo](/vi/contact/)
