Crispix JavaScript SDK & API Miễn Phí Cho Lập Trình Viên
Crispix cung cấp JavaScript SDK hoàn toàn miễn phí, giúp bạn tích hợp tính năng phóng to và làm nét ảnh bằng AI hàng đầu (Real-ESRGAN) trực tiếp vào trang web của mình.
Toàn bộ quá trình chạy ngay trên thiết bị người dùng: không cần API key, không giới hạn lượt gọi, và không tốn chi phí máy chủ GPU.
Tính Năng Nổi Bật
- Zero Server Compute: Chạy trên card đồ họa của người dùng qua WebGPU (tự động chuyển về WASM/CPU nếu máy không có WebGPU).
- Bảo Mật Tuyệt Đối (100% Private): Ảnh chỉ nằm trong RAM của trình duyệt, không bao giờ gửi ra server ngoài.
- Không Cần API Key: Tự do nhúng vào web cá nhân, ứng dụng SaaS hay công cụ nội bộ.
- Mô Hình Đa Dạng: Hỗ trợ Real-ESRGAN General (ảnh chụp thực tế) & Real-ESRGAN Anime (tranh vẽ/hoạt hình).
Hướng Dẫn Nhanh
1. Nhúng SDK vào Website
Import trực tiếp dưới dạng module ES:
import { CrispixSDK } from 'https://crispix.nibies.space/sdk.js';
// Khởi tạo SDK kết nối tới model CDN của Crispix
const crispix = new CrispixSDK({
baseUrl: 'https://crispix.nibies.space'
});
Tải trước mô hình vào cache (tùy chọn):
await crispix.preload('general');
Ví Dụ Sử Dụng
Làm Nét Ảnh từ File Upload
const fileInput = document.querySelector('input[type="file"]');
fileInput.addEventListener('change', async (e) => {
const file = e.target.files[0];
if (!file) return;
console.log('Đang làm nét ảnh...');
const result = await crispix.enhance(file, {
model: 'general', // 'general' (ảnh thường) hoặc 'anime' (tranh vẽ)
scale: 4, // Phóng to gấp 2 hoặc gấp 4
filters: {
sharpen: 15, // Tinh chỉnh độ sắc nét (0 - 100)
denoise: 10 // Khử nhiễu hạt (0 - 100)
},
outputFormat: 'image/png', // 'image/png' | 'image/jpeg' | 'image/webp'
onProgress: (percent) => {
console.log(`Tiến độ: ${Math.round(percent * 100)}%`);
}
});
console.log(`Hoàn thành bằng ${result.backend} (Kích thước: ${result.width}x${result.height})`);
// Hiển thị ảnh kết quả
const imgElement = document.getElementById('preview');
imgElement.src = result.dataUrl;
});
Tài Liệu Tham Khảo (API Reference)
new CrispixSDK(options)
options.baseUrl(tùy chọn): Đường dẫn lưu trữ file model (mặc định trỏ đếnhttps://crispix.nibies.space).
crispix.enhance(blob, options)
blob: Đối tượngFilehoặcBlobảnh đầu vào.options:model:'general'(mặc định) hoặc'anime'.scale:4(mặc định) hoặc2.filters: Đối tượng{ denoise, sharpen, brightness, contrast, saturation, autoLevels }.outputFormat:'image/png'(mặc định),'image/jpeg','image/webp'.quality: Chất lượng xuất cho JPEG/WebP từ0đến1(mặc định0.92).onProgress: Callback nhận giá trị tiến độ từ0đến1.signal:AbortSignaldùng để hủy tác vụ khi cần.