Hướng dẫn sử dụng

Mô hình và nhà cung cấp

NovelThread không khóa vào một mô hình. Dùng mô hình đám mây chính thức hoặc khóa API riêng để nối nhà cung cấp tương thích, kể cả mô hình trên máy.

Tải NovelThread · macOS và Windows · Xem chi tiết tải xuống

Cài đặt AI có mô hình tác vụ nhẹ, mô hình chính và nhà cung cấp riêng.

Các bước

Dễ nhất: đăng nhập và dùng ngay mô hình chính thức, không cần khóa hay thiết lập, kể cả gói Free.
Dùng mô hình riêng: Cài đặt → Cài đặt AI → “Thêm mô hình văn bản”, chọn DeepSeek, OpenRouter, OpenCode Zen, sub2api hoặc tùy chỉnh tương thích OpenAI.
Thiết lập sẵn điền Base URL và Model ID. Dán khóa từ trang nhà cung cấp, thử kết nối, rồi lưu khi thành công.
Sau khi lưu, gán mô hình cho tác vụ nhẹ, hằng ngày và phức tạp để mỗi việc dùng đúng mô hình.
Bìa và ảnh tham khảo được chọn từ máy, không gửi tới mô hình văn bản.

Hướng dẫn thiết lập BYOK

BYOK dùng tài khoản nhà cung cấp riêng thay điểm NovelThread, cần gói Plus trở lên còn hiệu lực. Nhà cung cấp tính phí trực tiếp; khóa mã hóa trong bộ nhớ an toàn cục bộ, yêu cầu không qua máy chủ NovelThread.

Ba bước từ đăng ký đến viết

Bước 1: đăng ký ở nhà cung cấp và tạo khóa API, thường bắt đầu sk-. Thường chỉ hiện đầy đủ một lần, hãy sao chép và lưu ngay.
Bước 2: Cài đặt → Cài đặt AI → Thêm mô hình → chọn thiết lập để điền URL và ID → dán khóa.
Bước 3: thử kết nối, lưu khi thành công rồi đặt làm mô hình hằng ngày để bắt đầu viết.

Ví dụ đầy đủ: nối DeepSeek

Các giá trị để nối API DeepSeek chính thức. Nhà cung cấp khác tương tự; chỉ thay URL, ID mô hình và trang lấy khóa.

Tên hiển thị: DeepSeek OfficialTên tùy ý để phân biệt nhà cung cấp
Nhà cung cấp: DeepSeekTự điền hai trường tiếp theo
URL gốc: https://api.deepseek.comThiết lập tự điền; không tự thêm /chat/completions
ID mô hình: deepseek-v4.1-flashTra danh sách nhà cung cấp; OpenRouter dùng provider/model-name
Khóa API: sk-•••••••• (tạo khóa tại platform.deepseek.com)Không hiện đầy đủ lại; mã hóa lưu trên máy
Số token cửa sổ ngữ cảnh: 128000Khớp giới hạn nhà cung cấp; quá thấp mất ngữ cảnh, quá cao lỗi yêu cầu
Chế độ API: Chat Completions APIGiữ mặc định trừ khi nhà cung cấp yêu cầu Responses API
Token tối đa: 65536Nâng cao; để trống dùng mặc định nhà cung cấp

Thử kết nối lỗi? Kiểm tra khóa đủ và không có khoảng trắng thừa, URL không kết thúc /chat/completions và tài khoản còn tiền.

Hướng dẫn cấu hình từng bước

Cài đặt → Cài đặt AI → Thêm mô hình văn bản. Chú ý các trường sau:

URL gốcBắt buộc · Thường kết thúc /v1: Địa chỉ gốc API, thiết lập sẽ điền sẵn; nếu tự nhập hãy chép tài liệu chính thức. Thường kết thúc /v1, như https://openrouter.ai/api/v1, https://opencode.ai/zen/v1, http://localhost:11434/v1. Không thêm /chat/completions vì đường dẫn sẽ lặp. DeepSeek nhận https://api.deepseek.com hoặc dạng /v1.
ID mô hìnhBắt buộc · Có trên trang nhà cung cấp: Tells NovelThread which model to call, for example deepseek-v4.1-flash. Presets fill it in; for custom setups, copy the exact ID from the provider’s model list (IDs are case-sensitive). Aggregators usually write it as provider/model-name (e.g. openai/gpt-4o-mini), and some free models end in :free.
Khóa APIBắt buộc · Tạo trên trang nhà cung cấp: Thông tin xác thực thường bắt đầu sk-. Tạo ở mục API Keys, thường chỉ hiện đầy đủ một lần nên sao chép ngay. NovelThread mã hóa trên máy, không hiện lại toàn bộ. Khi bị từ chối, kiểm tra thiếu ký tự, thừa khoảng trắng hoặc khóa đã xóa.
Số token cửa sổ ngữ cảnhBắt buộc · Theo giới hạn nhà cung cấp: Số token tối đa một yêu cầu gồm chỉ dẫn, lịch sử và câu trả lời. App dùng để quyết định rút lịch sử: quá thấp quên chương sớm, quá cao vượt giới hạn rồi lỗi. Tra trang mô hình, ví dụ DeepSeek 128000, Kimi và Gemini 128000 trở lên.
Chế độ APIGiữ mặc định: Có Chat Completions API và Responses API. Hầu hết DeepSeek, OpenRouter, OpenCode Zen, Moonshot, Ollama, vLLM và proxy dùng Chat Completions, nên giữ mặc định. Chỉ đổi khi nhà cung cấp yêu cầu Responses. Chọn sai thường lỗi HTTP 404 hoặc định dạng.
Token tối đaNâng cao · Giới hạn đầu ra mỗi lần: Token tối đa mỗi câu trả lời, gồm suy nghĩ và văn bản. Mặc định 65.536, để trống dùng mặc định nhà cung cấp. Nếu proxy giới hạn 4096 hay 8192, nhập đúng để tránh lỗi hạn mức. Giới hạn đủ lớn tránh cắt cảnh giữa câu.

Liên kết chính thức và khóa miễn phí

Các liên kết dẫn tới trang chính thức để đăng ký và tạo khóa. Gói miễn phí, ưu đãi theo điều khoản hiện hành của nhà cung cấp.

OpenCode ZenMiễn phí có thời hạn / điểm thử
A favorite among developers and writers, frequently offering free endpoints (such as deepseek-v4.1-flash-free). Create a key after signing up, then select the OpenCode Zen preset in NovelThread to fill in the address automatically.
Lấy khóa tại opencode.ai →
OpenRouterNhiều mô hình gắn :free
Trang tổng hợp có nhiều mô hình mở :free như Llama, Mistral, Qwen cùng hạn mức miễn phí mỗi ngày, phù hợp thử ít phí và so sánh ẩn tên. ID dạng provider/model-name:free.
Lấy khóa tại openrouter.ai →
Google AI StudioGói miễn phí chính thức cho nhà phát triển
Cổng nhà phát triển Google cung cấp Gemini Flash miễn phí với giới hạn mỗi phút, đủ thử sửa cảnh hoặc nghĩ dàn ý.
Lấy khóa tại aistudio.google.com →
Nền tảng DeepSeekTrực tiếp chính thức / trả theo dùng
If you would rather avoid free public routes, the official paid API is the simplest choice: data is not used for training by default (per its policy), and models such as deepseek-v4.1-flash are inexpensive enough for everyday drafting.
Lấy khóa tại platform.deepseek.com →
OllamaChạy cục bộ / không phí API
Chạy mô hình mở hoàn toàn ngoại tuyến trên máy, bản thảo không rời thiết bị. Dùng URL http://localhost:11434/v1 và ID mô hình đã tải bằng ollama pull.
Tải tại ollama.com →