Hướng Dẫn Cài Đặt API Tạo Ảnh Miễn Phí Với Cloudflare Workers

Bước 1: Tạo Tài Khoản Cloudflare

1. Truy cập https://dash.cloudflare.com/sign-up
2. Đăng ký một tài khoản miễn phí và xác nhận email. (Nếu đã có tài khoản thì bỏ qua bước này).

Bước 2: Tạo Worker Mới

1. Đăng nhập vào Cloudflare, nhìn sang menu bên trái, chọn Workers & Pages.
2. Bấm nút Create application (Tạo ứng dụng).
3. Trong màn hình hiện ra, bấm chọn Start with Hello World! (dòng có biểu tượng quả địa cầu màu xanh lá).
4. Bấm nút Deploy (Triển khai) ở góc dưới cùng bên phải.
5. Sau khi màn hình báo thành công, bấm tiếp nút Edit code (Chỉnh sửa mã).

Bước 3: Dán Mã Nguồn (Code)

1. Xóa toàn bộ đoạn code cũ đang có trong màn hình soạn thảo.
2. Mở file worker.js nằm cùng thư mục với file hướng dẫn này (thư mục NTV/docs/worker.js). Bấm chuột phải vào file → Open with Notepad (hoặc bất kỳ trình soạn thảo nào).
3. Bấm Ctrl+A để chọn tất cả, sau đó Ctrl+C để copy toàn bộ nội dung.
4. Quay lại màn hình soạn thảo của Cloudflare, Ctrl+A chọn tất cả code cũ, rồi Ctrl+V dán code mới vào.
5. Bấm nút Deploy (ở góc phải phía trên) để lưu lại. Sau đó bấm nút Trở về (Back mũi tên ngang) để ra ngoài trang quản lý Worker.

Bước 4: Cài Đặt API Key Bảo Mật

Đừng để người khác xài ké API của bạn! Hãy đặt mật khẩu (API Key).

1. Trong trang quản lý Worker bạn vừa tạo, chuyển sang tab Settings (Cài đặt).
2. Chọn mục Variables and Secrets (hoặc Environment Variables).
3. Bấm Add variable (Thêm biến).
   • Ở ô chọn loại (mặc định là Text), hãy bấm vào và chọn Secret (để mã hoá bảo mật mật khẩu).
   • Ô Variable name: Nhập chính xác chữ API_KEY (viết hoa tất cả).
   • Ô Value: Nhập một mật khẩu tùy ý của bạn (ví dụ: ntv-secret-xyz-123). Hãy ghi nhớ mật khẩu này.
4. Bấm Deploy để lưu.

Bước 5: Cấp Quyền AI (Quan Trọng Nhất)

Nếu thiếu bước này, Worker sẽ không thể gọi được AI.

1. Chuyển sang tab Bindings (nằm ở hàng menu ngang phía trên cùng).
2. Bấm nút Add binding màu xanh lam.
3. Ở menu bên trái, chọn Workers AI, sau đó bấm tiếp nút Add Binding ở góc dưới cùng bên phải bảng đó.
4. Lúc này giao diện mới hiện ra ô nhập liệu. Ở ô Variable name: Nhập chữ AI (viết hoa).
5. Bấm lại nút Add binding (hoặc Save) ở góc dưới để hoàn tất lưu.

1. Sau khi cài đặt xong 5 bước trên, quay lại tab Triggers hoặc tab Overview của Worker, bạn sẽ thấy mục Routes hoặc một đường link có dạng:
   
   https://ntv-image-api.<tên-của-bạn>.workers.dev
   
   
2. Copy đường link đó.

Cấu Hình Vào Tool NTV:

1. Mở phần mềm NTV, vào tab Cài Đặt > chọn mục TTI (Nguồn Tạo Ảnh).
2. Chọn chế độ Cloudflare Workers AI (Custom API).
3. Ở ô Worker URL: Dán đường link bạn vừa copy ở trên vào. (Bắt buộc phải có https://)
4. Ở ô API Key: Nhập đúng mật khẩu bạn đã tạo ở Bước 4.
5. Bấm nút LƯU CÀI ĐẶT.