Đăng ký & kết nối API ngoài

KKAuto dùng API bên ngoài cho hai nhóm việc: tạo nội dung (AI Chat / AI Image) và ra quyết định (AI Decisions). Mỗi nhà cung cấp đều cần một API Key / Token do bạn tự đăng ký và tự trả phí trực tiếp cho họ.

Tổng quan

Có hai loại API cần phân biệt

Loại	Dùng cho	Cấu hình tại
AI Provider	Viết bài, viết bình luận, sinh hashtag, sinh mô tả, sinh ảnh	Setup Wizard (Bước 1) hoặc Cài đặt tự động > Cài đặt FB > AI Providers (/wtadmin/fb/settings/api)
AI Decisions	Phân loại cực nhanh: bài viết có nên tương tác, nhóm có nên tham gia, bình luận nên trả lời thế nào	Setup Wizard (Bước 1) hoặc AI Decisions (/wtadmin/fb/settings/api)
Captcha	Giải captcha tự động khi tác vụ gặp thử thách	Cài đặt tự động > Cài đặt FB > Captcha (/wtadmin/fb/settings/captcha)

Cặp mặc định được khuyến nghị

• DeepSeek cho AI Provider — giá rẻ, phần lớn nội dung tiếng Việt chạy tốt với deepseek-flash.
• TypeSafe.ai (Jev) cho AI Decisions — tính tiền theo input, độ trễ thấp, phù hợp với hàng nghìn lượt phân loại mỗi ngày.

Bạn hoàn toàn có thể dùng cặp khác (OpenAI, Gemini, Claude, MiniMax). Chỉ cần mỗi loại có đúng một cấu hình đang là mặc định và đã kiểm tra kết nối thành công.

Làm nhanh nhất

Đăng nhập Website quản lý, mở Setup Wizard:

1. Bước 1: dán token DeepSeek và TypeSafe.ai.
2. Bước 2: mô tả ngành hàng của bạn để AI soạn hướng dẫn chung.
3. Bước 3: duyệt danh sách hashtag kèm mô tả + hướng dẫn cho AI.
4. Bước 4: xem tổng kết và bắt đầu.

Mọi bước dưới đây chỉ là hướng dẫn lấy token ở từng nhà cung cấp.

DeepSeek (Khuyên dùng cho AI Provider / AI Chat)

1. Tạo tài khoản

1. Mở platform.deepseek.com.
2. Đăng ký bằng email hoặc số điện thoại, xác nhận mã OTP.

2. Nạp tiền

1. Vào mục Top up (nạp tiền) trong menu tài khoản.
2. Chọn số tiền và thanh toán. DeepSeek không có bậc miễn phí lâu dài — tài khoản chưa nạp sẽ báo lỗi khi gọi API.

3. Tạo API Key

1. Mở API Keys trong menu bên trái.
2. Bấm Create new API key, đặt tên gợi nhớ (ví dụ kkauto-wtadmin).
3. Sao chép key ngay — key chỉ hiện đầy đủ một lần. Dạng: sk-....

4. Dán vào KKAuto

1. Mở Setup Wizard → Bước 1 → Nhập API Token (AI Provider), hoặc mở Cài đặt tự động > Cài đặt FB > AI Providers (/wtadmin/fb/settings/api).
2. Chọn loại API DeepSeek, dán key, chọn model:

Model	Dùng khi nào
deepseek-flash	Mặc định. Viết bài, viết bình luận, đọc ảnh (vision), sinh hashtag — nhanh và rẻ nhất
deepseek-v4-pro	Cần suy luận sâu hơn: phân tích dài, nội dung nhiều ràng buộc

3. Bấm Kiểm tra & Lưu — KKAuto gọi thử một lượt và báo kết nối thành công trước khi đặt làm mặc định.

TypeSafe.ai / Jev (Khuyên dùng cho AI Decisions)

TypeSafe.ai

AI Decisions trả lời những câu hỏi ngắn kiểu "bài này có phù hợp để tương tác không?", "nhóm này có nên tham gia không?" — chạy rất nhiều lần mỗi ngày. TypeSafe.ai trả về kết quả dạng điểm số / lựa chọn thay vì sinh văn bản, nên:

• Tính tiền theo lượng input, không tính output → chi phí thấp và dễ đoán.
• Độ trễ thấp, không bị cắt cụt giữa câu.
• Hỗ trợ train data (dạy bằng ví dụ) để tăng độ chính xác theo ngành của bạn.

1. Tạo tài khoản

1. Mở typesafe.ai và đăng ký.
2. Xem danh mục model và giới hạn tại docs.typesafe.ai/models.

2. Tạo API Key

1. Trong dashboard, mở mục API Keys.
2. Bấm tạo key mới và sao chép ngay.

3. Dán vào KKAuto

1. Mở Setup Wizard → Bước 1 → Nhập API Token (AI Decisions), hoặc mở AI Decisions trong Cài đặt FB > API.
2. Chọn loại TypeSafe.ai / Jev, dán key, chọn model:

Model	Dùng khi nào
jev-latest	Mặc định. Nên dùng cho mọi cấu hình mới
jev-preview	Thử tính năng mới. Không dùng cho vận hành thật

3. Bấm Kiểm tra & Lưu. Có thể bấm Preview để xem thử một lượt phân loại trước khi đặt mặc định.

Giới hạn cần biết

Mỗi lượt hỏi tối đa 32.000 ký tự cho phần dữ liệu đưa vào, tối đa 20 câu hỏi mỗi lượt. KKAuto tự cắt bớt dữ liệu dài trước khi gửi.

OpenAI (AI Chat, AI Image & OpenAI Decisions)

1. Tạo tài khoản và nạp tiền

1. Đăng ký tại platform.openai.com.
2. Vào Settings > Billing, thêm phương thức thanh toán và nạp credit. Tài khoản chưa nạp sẽ báo insufficient_quota.

2. Tạo API Key

1. Mở platform.openai.com/api-keys.
2. Bấm Create new secret key, đặt tên, sao chép key (sk-...).

3. (Tuỳ chọn) Organization ID

Nếu key thuộc một tổ chức cụ thể, lấy org-... tại Settings > Organization > General và dán vào ô Organization trong KKAuto. Bỏ trống nếu dùng tài khoản cá nhân.

4. Dùng ở đâu trong KKAuto

Vai trò	Cấu hình tại	Model gợi ý
AI Chat	AI Providers	gpt-5.4-mini, gpt-4.1-mini, gpt-5.4
AI Image	AI Image Providers	gpt-image-2, gpt-image-1-mini
AI Decisions	AI Decisions	gpt-6-luna

Google Gemini (AI Chat & Vision)

1. Mở Google AI Studio và đăng nhập bằng tài khoản Google.
2. Bấm Create API key, chọn project (hoặc để Google tạo project mới).
3. Sao chép key dạng AIza....
4. Dán vào KKAuto tại AI Providers, chọn loại Gemini. Model gợi ý: gemini-3-flash (mặc định, rẻ), gemini-2.5-flash, gemini-2.5-pro.

Gemini nhận được ảnh đầu vào trên tất cả model ở trên, phù hợp khi cần AI đọc ảnh chụp màn hình hoặc ảnh sản phẩm.

Anthropic Claude (AI Chat & Vision)

1. Đăng ký tại console.anthropic.com.
2. Vào Settings > Billing để nạp credit.
3. Mở console.anthropic.com/settings/keys → Create Key, sao chép key (sk-ant-...).
4. Dán vào KKAuto tại AI Providers, chọn loại Claude. Model gợi ý: claude-haiku-4-5 (rẻ, nhanh), claude-sonnet-4-6, claude-opus-4-6.

MiniMax (AI Chat & AI Image)

1. Đăng ký tại platform.minimax.io.
2. Vào mục API Keys, tạo key và sao chép.
3. Dán vào KKAuto:

Vai trò	Model
AI Chat	MiniMax-M3
AI Image	image-01 (tỉ lệ ảnh cấu hình riêng, mặc định 1:1)

CapSolver (Giải Captcha tự động)

1. Đăng ký tại capsolver.com và nạp tiền.
2. Mở dashboard.capsolver.com, vào mục API Keys và sao chép key.
3. Trên KKAuto, mở Cài đặt tự động > Cài đặt FB > Captcha (/wtadmin/fb/settings/captcha).
4. Thêm dịch vụ với provider capsolver, dán key, bấm Kiểm tra, rồi đặt làm mặc định.

Captcha chỉ dùng khi tác vụ gặp thử thách — không cần cấu hình để chạy các tác vụ thông thường.

Sau khi có token

• Mỗi nhà cung cấp đều có nút Kiểm tra kết nối. Chỉ đặt làm mặc định sau khi kiểm tra thành công.
• Key được lưu theo từng tenant, chỉ Super Admin và người có quyền Cài đặt FB xem/sửa được.
• Nếu một tính năng báo thiếu AI, quay lại Sức khỏe thiết lập để xem mục nào còn thiếu.