Cài đặt API tùy chỉnh cho Wyvern Chat: một provider, mọi model.

Updated 2026-07-29

WyvernChat là nền tảng roleplay bring-your-own-key miễn phí: nó không host model nào của riêng mình, và cài đặt provider của nó liệt kê OpenRouter, OpenAI, và Google bên cạnh tùy chọn tạo một provider tùy chỉnh. Đăng ký https://api.apisrouter.com/v1 làm provider tùy chỉnh đó với một key, và toàn bộ catalog, DeepSeek, Kimi, GLM, Claude, đều chọn được theo từng chat, cùng thẻ nhân vật V2 và lorebook được mang theo từ bất cứ nơi nào bạn viết chúng.

Câu trả lời nhanh: đăng ký một provider tùy chỉnh.

Trong cài đặt của WyvernChat, mở phần provider hoặc kết nối, và thay vì chọn một dịch vụ có tên sẵn, hãy tạo một provider tùy chỉnh. Các giá trị là bộ ba tiêu chuẩn của mọi frontend tương thích OpenAI: base URL https://api.apisrouter.com/v1, key sk-... của bạn, và chính xác model id bạn muốn chat chạy, chẳng hạn deepseek-v4-flash hoặc claude-sonnet-4-6. Nhãn field thay đổi khi app phát triển, nên hãy coi tên linh hoạt còn giá trị thì chính xác. Tài liệu của WyvernChat đóng khung khả năng này thẳng thắn: nếu provider của bạn không có trong danh sách tích hợp sẵn, bạn tạo một provider mới và dùng model mà nó cung cấp. Đó là cơ chế mà toàn bộ trang này dựa vào, và nó nghĩa là lựa chọn model bên trong Wyvern không còn giới hạn ở các dịch vụ nhà phát triển đã đấu nối sẵn.

Base URL:  https://api.apisrouter.com/v1
API key:   sk-...              (from APIsRouter)
Model:     deepseek-v4-flash   (typed exactly; any catalog id works)

WyvernChat là gì, và vì sao nó cần key của bạn.

WyvernChat (app.wyvern.chat) là một nền tảng roleplay web thuộc dòng dõi SillyTavern nhưng được hosted: thẻ nhân vật, lorebook, group chat, và một thư viện nhân vật công khai, không cần tự host. Các review và bài viết cộng đồng liên tục mô tả hai điều về nó: nền tảng cốt lõi miễn phí không có tường phí tính năng, và nó chủ động không cung cấp model nào, nên bạn mang một key từ một provider và trả tiền trực tiếp cho provider đó. Thiết kế BYOK đó là phiên bản trung thực của thỏa thuận mà hầu hết các nền tảng nhân vật che giấu. Không có hạn ngạch đóng gói để dùng hết và không có tier model cao cấp để upsell; chi phí của bạn là bất cứ gì provider của bạn đo lường, hiển thị trong log của provider đó thay vì ẩn trong một subscription. Mặt trái là quyết định provider hoàn toàn thuộc về bạn, đó chính xác là quyết định mà một gateway đa họ đơn giản hóa: một entry provider tùy chỉnh, một key, và câu hỏi model trở thành một dropdown theo từng chat thay vì một tài khoản mới cho mỗi vendor. Wyvern hỗ trợ cấu hình theo từng kết nối vượt ngoài những điều cơ bản, bao gồm preset sampler và template instruct, nên một cấu hình đã tinh chỉnh cho một họ model có thể nằm cạnh một cái khác. Nơi tài liệu không nêu rõ một chi tiết (nhãn chính xác, hay liệu một phương ngữ Anthropic-native có được phơi bày song song với dạng OpenAI hay không), hãy giả định provider tùy chỉnh tương thích OpenAI là con đường đáng tin cậy; đó là con đường mà tài liệu của chính nền tảng cam kết.

Hướng dẫn cài đặt từng bước.

Debug tuân theo mẫu hình phổ quát của frontend. Một thất bại âm thầm hoặc lỗi ngay lập tức với giá trị trông có vẻ đúng thường là một trong ba điều: một URL dán kèm đường dẫn completions trong khi app muốn một base URL, một key kèm khoảng trắng thừa, hoặc một chặn CORS phía trình duyệt, thấy được trong developer console. Vì Wyvern là một web app hosted, đường đi request chạy từ app tới endpoint của bạn; chứng minh cùng ba giá trị hoạt động trong một lệnh curl tách vấn đề endpoint khỏi vấn đề app trong chưa đầy một phút.

  • Tạo hoặc đăng nhập tài khoản WyvernChat của bạn tại app.wyvern.chat.
  • Mở cài đặt và tìm phần provider / kết nối API.
  • Chọn thêm một provider tùy chỉnh thay vì một preset có tên sẵn.
  • Nhập base URL https://api.apisrouter.com/v1 và dán key của bạn.
  • Đặt model id chính xác như catalog liệt kê; nếu app lấy danh sách model từ endpoint, hãy chọn từ đó, nếu không thì gõ id thủ công.
  • Lưu, mở bất kỳ nhân vật nào, và gửi một tin nhắn test ngắn để xác nhận round trip.

Thẻ nhân vật: import V2 có ý nghĩa gì trong thực tế.

Wiki của Wyvern ghi lại thẻ nhân vật như những tài sản di động: thẻ tải xuống ở định dạng thẻ V2 nhúng trong file PNG, và import một ảnh mang metadata thẻ (chẳng hạn một bản export từ SillyTavern) sẽ nhắc bạn kéo chi tiết nhân vật vào tự động. Lorebook cũng là hạng nhất, import được, export được, và gắn được vào bất kỳ nhân vật nào thay vì bị khóa vào cấu hình của người tạo ra chúng. Hệ quả thực tế: khoản đầu tư của bạn vào nhân vật và ghi chú thế giới không bị con tin bởi bất kỳ frontend nào. Một thẻ viết cho SillyTavern chơi được trong Wyvern, và một thẻ Wyvern export ngược trở lại. Kết hợp với một key gateway, điều đó khiến toàn bộ cài đặt di động theo cả hai chiều cùng lúc, nhân vật di chuyển giữa các frontend, và model hoán đổi bên dưới chúng, mà không cần làm lại cả hai nửa. Một thói quen đáng mang theo từ thế giới SillyTavern: giữ thẻ và lorebook ổn định trong một câu chuyện dài và để khả năng theo chỉ dẫn của model làm việc. Đổi model giữa chừng an toàn vì lịch sử đi theo chat; viết lại thẻ giữa chừng tốn nhiều mạch lạc hơn là nó mang lại.

Chọn model cho các phiên Wyvern.

Hỗn hợp catalog phù hợp với roleplay ánh xạ gọn gàng lên lựa chọn model theo từng chat của Wyvern. deepseek-v4-flash là lựa chọn hàng ngày mặc định của cộng đồng: đối thoại tự nhiên, cảnh tiến triển về phía trước, và mức giá đủ thấp để một buổi tối chơi nặng tốn một phần nhỏ của cent mỗi tin nhắn. deepseek-v4-pro nâng cấp mật độ mô tả cho các campaign đáng ghim lại. kimi-k2.6 và glm-5.2 phá vỡ sự nhàm chán cùng giọng văn khi xoay vòng, với khả năng theo chỉ dẫn chân trời dài của GLM xứng đáng với các cảnh chi tiết nặng bất chấp độ trễ lý luận của nó. claude-sonnet-4-6 vẫn là trần văn xuôi cho kể chuyện an toàn-cho-công-việc, định giá tương xứng. Chính sách nội dung, nói thẳng: điều khoản riêng của Wyvern chi phối nền tảng, và chính sách của mỗi họ model chi phối những gì model đó sẽ viết; không endpoint tùy chỉnh nào thay đổi được cả hai. Trang so sánh chính sách liên kết bên dưới bao phủ bối cảnh đó một cách khách quan, và tóm tắt trung thực là mức phù hợp chính sách là một tiêu chí chọn model như giá cả hay văn phong, không phải thứ một hướng dẫn cài đặt có thể cấu hình để né tránh.

Trả theo mức sử dụng · thấp hơn giá chính thức

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Mô hìnhGiá chính thứcGiá của chúng tôi
DeepSeek V4 Flash$0.14 / $0.28 per M$0.10 / $0.30 per M
DeepSeek V4 Pro$0.43 / $0.87 per M$0.40 / $0.90 per M
Kimi K2.6$0.95 / $4.00 per M$1.00 / $4.00 per M
Claude Sonnet 4.6$3.00 / $15.00 per M$2.40 / $12.00 per M

Hình dạng chi phí: một nền tảng BYOK thực sự tính tiền gì.

Vì Wyvern không tự tính phí gì, toàn bộ chi phí của bạn là key trả theo lượng dùng, và hình dạng chi phí của roleplay bị chi phối bởi input: frontend gửi lại lịch sử chat hiển thị với mỗi tin nhắn, nên một phiên dài tính tiền lại context tích lũy của nó lặp đi lặp lại. Điều đó khiến hai cài đặt quan trọng hơn bất kỳ so sánh subscription nào. Giữ context làm việc có chủ đích thay vì tối đa, tóm tắt các sự kiện cũ vào entry lorebook theo cách hướng dẫn độ dài context bên dưới mô tả. Và khớp model với cảnh: xoay vòng giữa một model hàng ngày giá trị và một model cao cấp cho cảnh cao trào cắt giảm hóa đơn một bậc so với luôn chạy model flagship. Khoản credit khởi đầu ở đây bao phủ giai đoạn đánh giá mà không cần thẻ: đủ cho các prompt giống hệt nhau qua deepseek-v4-flash, kimi-k2.6, và claude-sonnet-4-6 để biết giọng văn nào câu chuyện của bạn muốn, với số lượng token theo từng request trong log sử dụng nên chi phí ổn định là một phép tính số học trước bất kỳ lần nạp thêm nào.

Câu hỏi thường gặp

WyvernChat có hỗ trợ endpoint API tùy chỉnh không?

Có. Cài đặt provider của nó liệt kê các dịch vụ có tên sẵn (OpenRouter, OpenAI, Google) và ghi lại việc tạo một provider tùy chỉnh cho bất cứ gì không có trong danh sách. Một provider tùy chỉnh trỏ vào https://api.apisrouter.com/v1 với một key khiến mọi model trong catalog chọn được.

WyvernChat có miễn phí không?

Nền tảng thì có, theo tài liệu của nó và các review độc lập: không tường phí tính năng và không hạn ngạch model đóng gói. Đây là bring-your-own-key, nên việc dùng model tính tiền qua bất kỳ provider nào key của bạn thuộc về. Khoản credit khởi đầu ở đây bao phủ những phiên đầu tiên đó mà không cần thẻ.

Tôi có thể import nhân vật SillyTavern của mình vào Wyvern không?

Có. Wyvern dùng định dạng thẻ nhân vật V2 nhúng trong PNG, và import một ảnh có metadata thẻ sẽ đề nghị kéo nhân vật vào tự động. Lorebook cũng import và export được, nên toàn bộ cài đặt SillyTavern di trú thay vì phải làm lại từ đầu.

Tôi nên chọn model nào cho roleplay trên Wyvern?

Vòng xoay hoạt động tốt trên mọi frontend: deepseek-v4-flash làm lựa chọn hàng ngày, deepseek-v4-pro cho campaign, kimi-k2.6 hoặc glm-5.2 để đa dạng giọng văn, claude-sonnet-4-6 cho văn xuôi an toàn-cho-công-việc ở phong độ cao nhất. Với một key gateway đó là lựa chọn theo từng chat, không phải một cam kết.

Một endpoint tùy chỉnh có thay đổi những gì nội dung model cho phép không?

Không. Nơi request được định tuyến không ảnh hưởng tới chính sách nội dung model hay điều khoản nền tảng; cả hai vẫn áp dụng đúng như đã viết. Trang chính sách nội dung liên kết trên trang này so sánh các chính sách bằng văn bản theo từng provider, nên câu hỏi về mức phù hợp được giải quyết trước khi một câu chuyện dài bắt đầu.

Provider tùy chỉnh của tôi lưu được nhưng chat không nhận phản hồi. Giờ sao?

Tách vấn đề: chạy cùng URL, key, và model id trong một request curl. Nếu curl hoạt động, vấn đề ở phía app (URL dán kèm một đường dẫn thừa, khoảng trắng trong key, hoặc một chặn CORS thấy được trong console trình duyệt). Nếu curl cũng thất bại, key hoặc id sai, và nội dung lỗi sẽ cho biết là cái nào.