Tổng quan về API GenAI của Bộ công cụ học máy

Các API GenAI của Bộ công cụ học máy khai thác sức mạnh của Gemini Nano để giúp các ứng dụng của bạn thực hiện các nhiệm vụ. Các API này cung cấp chất lượng sẵn có cho các trường hợp sử dụng phổ biến thông qua một giao diện cấp cao. Các API GenAI của Bộ công cụ học máy được xây dựng dựa trên AICore, một dịch vụ hệ thống Android cho phép thực thi các mô hình nền tảng GenAI trên thiết bị để hỗ trợ các tính năng như chức năng nâng cao của ứng dụng và cải thiện quyền riêng tư của người dùng bằng cách xử lý dữ liệu cục bộ.

Điều khoản dịch vụ bổ sung của API GenAI của Bộ công cụ học máy được áp dụng cho việc sử dụng các API GenAI. Nhà phát triển hoàn toàn chịu trách nhiệm về độ an toàn của ứng dụng API và trải nghiệm người dùng của ứng dụng.

Tính năng chính

Các API GenAI của Bộ công cụ học máy hỗ trợ những tính năng sau:

  • Tóm tắt: Tóm tắt các bài viết hoặc cuộc trò chuyện dưới dạng danh sách có dấu đầu dòng.
  • Hiệu đính: Chỉnh sửa nội dung ngắn bằng cách tinh chỉnh ngữ pháp và sửa lỗi chính tả.
  • Viết lại: Viết lại tin nhắn ngắn theo nhiều giọng điệu hoặc phong cách.
  • Nội dung mô tả hình ảnh: Tạo nội dung mô tả ngắn về một hình ảnh nhất định.
  • Câu lệnh: Tạo nội dung văn bản dựa trên câu lệnh tuỳ chỉnh chỉ có văn bản hoặc câu lệnh đa phương thức.

Lợi ích của API AI tạo sinh

Tương tự như các tính năng hiện có khác của Bộ công cụ học máy, các API GenAI chạy hoàn toàn trên thiết bị và do đó mang lại những lợi ích sau:

  • Dữ liệu đầu vào, dữ liệu suy luận và dữ liệu đầu ra được xử lý trên thiết bị
  • Chức năng vẫn giữ nguyên khi không có kết nối Internet ổn định
  • Không mất thêm chi phí máy chủ cho mỗi lệnh gọi API

Ngoài ra, vì các API GenAI được xây dựng dựa trên AICore và sử dụng Gemini Nano, nên mọi ứng dụng đều có thể sử dụng mô hình Gemini Nano dùng chung trên thiết bị. Điều này giúp bạn không cần phải đợi tải một mô hình xuống nếu mô hình đó đã có trên thiết bị, nhờ đó tiết kiệm được dung lượng lưu trữ. Tìm hiểu thêm về cách AICore tách biệt các yêu cầu để bảo vệ quyền riêng tư.

Truyền trực tuyến so với không truyền trực tuyến

Các API GenAI của Bộ công cụ học máy cung cấp cả lựa chọn phát trực tuyến và không phát trực tuyến để nhận kết quả. API truyền phát trực tiếp cung cấp các phản hồi tăng dần khi chúng được tạo, mang đến một luồng dữ liệu liên tục. Ngược lại, API không truyền trực tuyến sẽ đợi cho đến khi toàn bộ phản hồi hoàn tất rồi mới trả về phản hồi đó dưới dạng một khối duy nhất.

Chọn API truyền phát trực tiếp cho các câu trả lời dài vì API này cho phép nhận được ý kiến phản hồi ban đầu nhanh hơn. API không phát trực tuyến phù hợp hơn với các câu trả lời ngắn hoặc khi xử lý kết quả theo lô.

Hỗ trợ về thiết bị

Các API dành riêng cho tính năng GenAI (Tóm tắt, Hiệu đính, Viết lại và Mô tả hình ảnh) có khả năng hỗ trợ thiết bị khác với Prompt API, như mô tả trong các phần sau.

Hỗ trợ thiết bị API theo từng tính năng

Các API Tóm tắt, Hiệu đính, Viết lạiMô tả hình ảnh có trên các thiết bị sau đây, đồng thời chúng tôi có kế hoạch mở rộng phạm vi hỗ trợ sang các thiết bị khác:

  • Google: Pixel 10, Pixel 10 Pro, Pixel 10 Pro XL, Pixel 10 Pro Fold, Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL, Pixel 9 Pro Fold
  • Honor: Honor 400 Pro, Magic 6 Pro, Magic 6 RSR, Magic 7, Magic 7 Pro, Magic V3, Magic V5
  • iQOO: iQOO 13
  • Motorola: Razr 60 Ultra
  • OnePlus: OnePlus 13, OnePlus 13s, OnePlus Pad 3
  • OPPO: Find N5, Find X8, Find X8 Pro, Reno 14 Pro
  • POCO: POCO F7 Ultra, POCO X7 Pro
  • realme: realme GT 7 Pro, realme GT 7T
  • Samsung: Galaxy S25, Galaxy S25+, Galaxy S25 Ultra, Galaxy Z Fold7
  • vivo: vivo X200, vivo X200 Pro, vivo X Fold3 Pro, vivo X Fold5
  • Xiaomi: Xiaomi 15 Ultra, Xiaomi 15, Xiaomi 15T Pro, Xiaomi 15T, Xiaomi Pad mini

Phạm vi hỗ trợ ngôn ngữ cụ thể có thể thay đổi tuỳ theo cấu hình của thiết bị cụ thể và các mô hình đã được tải xuống thiết bị.

Hỗ trợ thiết bị Prompt API

Prompt API hiện được hỗ trợ trên các thiết bị sau:

nano-v2

  • Google: Pixel 9, Pixel 9 Pro, Pixel 9 Pro XL, Pixel 9 Pro Fold
  • Honor: Magic V5, Magic 7, Magic 7 Pro
  • iQOO: iQOO 13
  • Motorola: Razr 60 Ultra
  • OnePlus: OnePlus 13, OnePlus 13s, OnePlus Pad 3
  • OPPO: Find N5
  • POCO: POCO F7 Ultra
  • realme: realme GT 7 Pro
  • Samsung: Galaxy Z Fold7
  • Xiaomi: Xiaomi 15 Ultra, Xiaomi 15

nano-v3

  • Google: Pixel 10, Pixel 10 Pro, Pixel 10 Pro XL, Pixel 10 Pro Fold

Truy xuất phiên bản Gemini Nano

Các phiên bản Gemini Nano khác nhau sẽ chạy trên các thiết bị khác nhau. Để trả về phiên bản Gemini Nano trên một thiết bị, hãy dùng getBaseModelName().

Hạn mức cho mỗi ứng dụng

AICore áp dụng hạn mức suy luận cho mỗi ứng dụng. Việc gửi quá nhiều yêu cầu GenAI API trong một khoảng thời gian ngắn sẽ dẫn đến phản hồi ErrorCode.BUSY. Khi gặp phải lỗi như vậy, hãy cân nhắc sử dụng thuật toán thời gian đợi luỹ thừa để thử lại yêu cầu. Ngoài ra, ErrorCode.PER_APP_BATTERY_USE_QUOTA_EXCEEDED có thể được trả về nếu một ứng dụng vượt quá hạn mức trong thời gian dài (ví dụ: hạn mức hằng ngày).

Mức sử dụng trong nền

Bạn chỉ được phép suy luận bằng GenAI API khi ứng dụng là ứng dụng trên nền trước hàng đầu. Việc sử dụng API khi ứng dụng không ở trên nền trước (kể cả khi sử dụng một dịch vụ trên nền trước) sẽ dẫn đến phản hồi ErrorCode.BACKGROUND_USE_BLOCKED.

Mã mẫu

Để lấy mã này, hãy xem các mẫu sau: