Replicate

Tạo Tài Khoản Và Lấy API Token

Đăng ký tài khoản Replicate và lấy token xác thực để gọi API.

Đăng ký tại replicate.com, vào Account Settings > API Tokens, copy token và lưu vào biến môi trường `REPLICATE_API_TOKEN`.

Không commit token vào git, dùng file .env và thêm .env vào .gitignore.

Chọn Model Phù Hợp Trên Replicate Explore

Tìm model tạo ảnh phù hợp nhu cầu và xem tài liệu input/output cụ thể của model đó.

Vào replicate.com/explore, tìm model như 'stability-ai/sdxl', xem tab API để biết định dạng tham số cần truyền vào.

Chạy thử model trực tiếp trên web UI của Replicate trước để hiểu rõ output trước khi viết code tích hợp.

Cài Đặt SDK Và Gọi Thử API

Cài thư viện client chính thức và gọi thử model từ code backend.

Chạy `npm install replicate`, sau đó gọi `replicate.run("stability-ai/sdxl:version-id", { input: { prompt: "..." } })`.

Luôn pin đúng version ID của model trong code để tránh output thay đổi bất ngờ khi model được cập nhật.

Xử Lý Bất Đồng Bộ Và Trạng Thái Xử Lý

Xử lý việc gọi model không trả kết quả ngay lập tức, cần theo dõi trạng thái prediction.

Dùng webhook hoặc polling qua `replicate.predictions.get(id)` để kiểm tra trạng thái 'starting', 'processing', 'succeeded'.

Ưu tiên dùng webhook thay vì polling liên tục để giảm tải và có kết quả nhanh hơn khi xử lý xong.

Lưu Kết Quả Và Giới Hạn Chi Phí

Lưu ảnh kết quả vào storage riêng và thiết lập giới hạn để kiểm soát chi phí sử dụng.

Tải ảnh từ URL kết quả về lưu vào S3/Supabase Storage, đồng thời đặt giới hạn số lượt gọi mỗi người dùng mỗi ngày trong code ứng dụng.

Theo dõi dashboard usage trên Replicate hàng tuần để phát hiện sớm nếu chi phí tăng bất thường.