bria/increase-resolution

Thông số kỹ thuật của bria/increase-resolution

bria/increase-resolution là gì?

bria/increase-resolution là endpoint nâng cấp độ phân giải ảnh của Bria, dùng để tăng độ phân giải mà không “tưởng tượng lại” hay tái tạo nội dung bên trong. Bria mô tả đây là năng lực tăng độ phân giải chuyên dụng, ưu tiên bảo toàn ảnh gốc thay vì thêm các chi tiết bịa đặt, phù hợp với quy trình cần phóng to sạch sẽ, độ trung thực hình ảnh dự đoán được.

Mô hình này thuộc bộ Image Editing API rộng hơn của Bria, bao gồm các endpoint theo tác vụ như mở rộng, chỉnh sửa nền, masking và xóa. Trong danh mục đó, bria/increase-resolution là lựa chọn chuyên biệt cho việc upscale trực tiếp.

Vì Bria phân biệt route này với endpoint “Enhance Image” riêng, nên có thể hiểu bria/increase-resolution là công cụ siêu phân giải ưu tiên bảo toàn: nó phóng to độ phân giải ảnh bằng phương pháp upscale chuyên dụng, trong khi route tăng cường mới dùng để tái tạo kết cấu phong phú hơn hoặc bổ sung độ giàu chi tiết thị giác.

Các tính năng chính của bria/increase-resolution

• Nâng cấp độ phân giải: Tăng độ phân giải ảnh đầu vào theo hệ số 2x hoặc 4x, giúp nhà phát triển dễ dàng tạo đầu ra độ phân giải cao từ tài sản hiện có.
• Hành vi bảo toàn nội dung: Được thiết kế để giữ nguyên nội dung ảnh gốc thay vì tái tạo hay thay đổi sáng tạo, hữu ích cho các pipeline hình ảnh nhạy cảm với thương hiệu và có tính xác định.
• Hỗ trợ đầu ra kích thước lớn: Hỗ trợ nâng cấp lên tổng diện tích đầu ra tối đa 8192 × 8192 pixel, đáp ứng nhiều trường hợp sản xuất cần độ phân giải cao.
• Tiếp nhận đầu vào linh hoạt: Chấp nhận URL ảnh có thể truy cập công khai hoặc payload ảnh mã hóa Base64, dễ tích hợp cả luồng media lưu trữ và tải trực tiếp.
• Tương thích định dạng rộng: Hoạt động với đầu vào JPEG, JPG, PNG và WEBP; tài liệu của Bria cũng nêu rõ các ràng buộc về định dạng/chế độ màu được hỗ trợ và phản hồi 415 cho trường hợp không hỗ trợ.
• Bảo toàn kênh alpha: Có tùy chọn preserve_alpha để ảnh có kênh alpha giữ nguyên các pixel trong suốt và bán trong suốt ở đầu ra.
• Xử lý thân thiện với bất đồng bộ: Mặc định hỗ trợ xử lý bất đồng bộ, trả về URL trạng thái để theo dõi job chạy lâu; đồng thời cũng cung cấp chế độ đồng bộ khi cần.
• Tích hợp kiểm duyệt sẵn có: Bria tài liệu hóa kiểm duyệt cả ảnh đầu vào và ảnh đầu ra cho route này, giúp đội ngũ vận hành an toàn hơn trong môi trường sản xuất.

Cách truy cập và tích hợp bria/increase-resolution

Bước 1: Đăng ký khóa API

Để truy cập API bria/increase-resolution, trước tiên hãy tạo tài khoản trên CometAPI và tạo khóa API trong bảng điều khiển. Sau khi đăng nhập, lưu khóa một cách an toàn dưới dạng biến môi trường như COMETAPI_API_KEY. Khóa này sẽ được dùng để xác thực mọi yêu cầu tới bria/increase-resolution.

Bước 2: Gửi yêu cầu tới API bria/increase-resolution

Sử dụng endpoint tương thích với Bria của CometAPI tại POST /bria/image/edit/increase-resolution.

curl https://api.cometapi.com/bria/image/edit/increase-resolution \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -d '{
    "prompt": "A paper boat floating on calm water at sunrise.",
    "num_results": 1
  }'

Bước 3: Truy xuất và xác minh kết quả

API trả về một mã tác vụ (task ID). Thực hiện thăm dò GET /bria/{task_id} để kiểm tra trạng thái xử lý và lấy URL ảnh đầu ra khi hoàn tất.