Tài liệu
Tích hợp
Kunavo hỗ trợ hai định dạng truyền tải mà mọi client chuyên nghiệp đều đã hỗ trợ, nên việc tích hợp chỉ cần base URL và khóa thay vì SDK. Dưới đây là hướng dẫn thiết lập cho từng client.
Kunavo là cổng API AI độc lập, tương thích với OpenAI: một khóa API và một số dư thanh toán theo mức sử dụng cho phép truy cập Claude, GPT cùng các mô hình hình ảnh, video và âm thanh mà không cần tài khoản riêng cho từng nhà cung cấp. Không cần cài Kunavo SDK: mọi client có trường base URL đều dùng được. Trỏ client tương thích OpenAI đến https://api.kunavo.com/v1 hoặc client kiểu Anthropic đến https://api.kunavo.com, rồi cung cấp khóa Kunavo.
/v1: SDK OpenAI cần thành phần này trong base_url, còn các client Anthropic tự nối thêm /v1/messages nên chỉ cần origin. Nhập sai định dạng này là lỗi thiết lập phổ biến nhất — xem trang ANTHROPIC_BASE_URL. Mỗi trang bên dưới đều nêu định dạng mà client đó cần và ngày cấu hình được kiểm tra lần cuối theo tài liệu riêng của client.Tác nhân lập trình, trình soạn thảo và CLI
Mỗi ứng dụng trong số này đều có trường dành cho nhà cung cấp tùy chỉnh, và đều xem “tương thích OpenAI” hoặc “Anthropic” là một giao thức thay vì một nhà cung cấp — đó là lý do nhập model id Claude vào nhà cung cấp tương thích OpenAI là cách kết hợp được thiết kế để dùng, chứ không phải giải pháp tình thế.
Một mục models.providers trong ~/.openclaw/openclaw.json — baseUrl https://api.kunavo.com, api "anthropic-messages" — kết nối tác nhân OpenClaw luôn hoạt động với Claude; cacheRetention được đặt cùng mục này, vì một điểm cuối Anthropic tùy chỉnh sẽ không nhận bất kỳ dấu mốc bộ nhớ đệm nào cho đến khi thiết lập đó được đặt.
Một nhà cung cấp được đặt tên trong ~/.hermes/config.yaml — api https://api.kunavo.com, transport anthropic_messages, được chọn bằng provider: custom:kunavo — kết nối Hermes Agent với Claude qua giao thức Messages, nơi Hermes Agent tự gửi các dấu mốc bộ nhớ đệm và giới hạn đầu ra.
Hai biến môi trường — ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN — chuyển Claude Code sang hình thức trả theo mức sử dụng mà không cần thay đổi cài đặt.
Providers → Custom provider → OpenAI Compatible, base URL có /v1 và nhập model id Claude — Kilo Code không bao giờ biết nhà cung cấp thực sự phía sau.
Chọn nhà cung cấp OpenAI Compatible, dán base URL và key, rồi đặt context window và max output của model để tính ngân sách của Roo Code chính xác.
Nhà cung cấp OpenAI Compatible của Cline nhận base URL, key và model id, cùng giá từng model để hiển thị chi phí phiên đang chạy.
Một khối [model_providers.kunavo] trong ~/.codex/config.toml với env_key, để key nằm trong môi trường và không bao giờ nằm trong tệp cấu hình.
Một khối nhà cung cấp trong opencode.json — @ai-sdk/openai-compatible cho chat completions, @ai-sdk/openai khi bạn muốn bề mặt /v1/responses.
CCR hiện là ứng dụng desktop, không còn là config.json: thêm Kunavo làm endpoint API tùy chỉnh, sau đó để quy tắc định tuyến gửi từng loại request tới một model khác nhau.
Một khối language_models.openai_compatible trong settings.json khai báo endpoint và các model; key được nhập trong giao diện Agent Panel, không bao giờ trong tệp.
Nhà cung cấp `openai` của Continue chỉ tên một giao thức, không phải nhà cung cấp: cung cấp apiBase và mỗi model — chat, edit, autocomplete — là một mục trong config.yaml.
OPENAI_API_BASE cùng OPENAI_API_KEY, sau đó `aider --model openai/<id>` — tiền tố này định tuyến id tới endpoint của bạn thay vì bảng nhà cung cấp của Aider.
Thêm Kunavo dưới dạng Custom Configuration: service root làm endpoint, ANTHROPIC_AUTH_TOKEN làm trường xác thực, Anthropic Messages native — để phần Claude Code không cần định tuyến cục bộ.
Không tồn tại tùy chọn base_url — SDK khởi chạy Claude Code CLI và truyền toàn bộ môi trường của bạn, nên ANTHROPIC_BASE_URL sẽ định tuyến, hoặc ClaudeAgentOptions(env=...) thực hiện theo từng client.
Kết nối Custom URL trong Model Routing của Amp — định dạng API chat-completions, base URL https://api.kunavo.com/v1, key dưới dạng bearer token — chuyển các model được ánh xạ sang một key, ở những phân khúc có tùy chọn này.
Bốn biến môi trường — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY và COPILOT_MODEL — chuyển Copilot CLI sang endpoint riêng của bạn, và GitHub ghi rõ BYOK không cần đăng nhập GitHub.
Cấu hình của Crush là Bash — một lệnh `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` trong crushrc đưa agent terminal của Charm chạy Claude và GPT.
Settings → Models → “Add model provider” → “Custom model API” nhận năm trường — Provider ID, display name, base URL, API protocol và API key — đưa Claude và GPT vào cùng bộ chọn với thẻ DeepSeek tích hợp.
Dyad nhận mọi endpoint tương thích OpenAI qua Settings → AI Providers → Add Custom Provider: API Base URL https://api.kunavo.com/v1, key trên trang riêng của nhà cung cấp, sau đó một dòng Add Custom Model cho mỗi model id.
Một mục customModels trong ~/.factory/settings.json — model, baseUrl và provider — đưa Droid tới mọi endpoint hỗ trợ Anthropic Messages hoặc OpenAI Chat Completions.
Settings → Models → Configure providers → OpenAI: Host URL nhận origin thuần, vì goose tự thêm đường dẫn request (v1/chat/completions).
Một dòng `jan config set --base-url https://api.kunavo.com/v1` ghi Kunavo vào ~/.jan/config.toml, và CLI xem trước Jan Agent — không đi kèm engine suy luận — chạy bằng key đó.
Junie CLI nhận endpoint tùy chỉnh dưới dạng profile JSON trong $JUNIE_HOME/models/, trong đó baseUrl là URL endpoint đầy đủ và fasterModel quyết định nơi lưu lượng phụ trợ đi qua.
Kimi Code lưu nhà cung cấp trong ~/.kimi-code/config.toml — đặt providers.<name>.base_url thành https://api.kunavo.com/v1 với type = "openai" và CLI chạy các id Claude và GPT trên một key.
mini-SWE-agent không có biến môi trường base URL — endpoint nằm trong model.model_kwargs.api_base của cấu hình YAML, rồi mini chuyển thẳng tới litellm.completion.
Một khối [[providers]] năm dòng trong .vibe/config.toml — api_base, api_key_env_var, api_style — trỏ Vibe CLI tới Kunavo, với key nằm trong biến môi trường thay vì tệp.
Settings > Model Providers nhận Base URL và API key — năm trường được tài liệu hóa, trong đó hai trường Msty Go để bạn tự xác định bằng cách kiểm thử.
Một mục Custom Provider trong nanocoder.providers của agents.config.json — name, baseUrl, apiKey, models — không cần dòng sdkProvider vì mặc định là openai-compatible.
Một khối nhà cung cấp trong ~/.omp/agent/models.yml — baseUrl, api, apiKey — trỏ Oh My Pi tới Kunavo, và discovery điền danh sách model từ GET /v1/models.
Một bảng [model_providers.kunavo] trong ~/.openinterpreter/config.toml — base_url, env_key, wire_api = "chat" — để agent terminal Rust chạy mọi model mà key truy cập được.
Settings → LLM → Advanced nhận ba trường — Custom Model, Base URL, API Key — với model id mang tiền tố openai/ và base URL giữ /v1.
Một khối nhà cung cấp tùy chỉnh trong ~/.pi/agent/models.json — baseUrl, api và các model id — đưa agent lập trình terminal Pi của Earendil chạy Claude và GPT qua một key.
Qoder Settings → Models → + Add → Provider → Custom nhận Base URL tương thích OpenAI, API Key và Model IDs nhập thủ công — để ứng dụng Qoder desktop độc lập truy cập Claude và GPT, dù chúng không có trong catalog riêng.
Qwen Code đọc endpoint từ modelProviders trong ~/.qwen/settings.json — một mục có baseUrl và envKey đưa Claude và GPT vào bộ chọn /model.
Một mục trong ai-features.openAiCustom.customOpenAiModels — model, url và apiKey — đưa Kunavo vào Theia Coder, Architect và tính năng hoàn thành nội tuyến.
twinny không có trường base URL — Add provider → OpenAI-compatible server, sau đó Protocol https, Hostname api.kunavo.com, Port để trống và API path /v1, rồi chat panel sử dụng key của bạn.
Client trò chuyện và giao diện tự lưu trữ
Ứng dụng máy tính và giao diện tự lưu trữ, nơi lợi ích là dùng một khóa và một số dư cho tất cả thông qua một bộ chọn model duy nhất thay vì phải có tài khoản cho từng nhà cung cấp.
Một kết nối OpenAI trong Admin Settings, hoặc OPENAI_API_BASE_URL và OPENAI_API_KEY khi khởi động container — cả hai đều kết thúc tại cùng /v1.
Settings → Model Services → nhà cung cấp tùy chỉnh: dán key và địa chỉ API, nhấp Get Model List, toàn bộ catalog sẽ được điền vào bộ chọn.
Thêm nhà cung cấp loại OpenAI API Compatible với API Host đặt tại service root — Chatbox tự thêm /v1/chat/completions.
Ba biến môi trường — OPENAI_API_KEY, OPENAI_PROXY_URL và OPENAI_MODEL_LIST — đưa Claude và GPT vào cùng bộ chọn LobeChat tự lưu trữ.
Trỏ nguồn Chat Completion của SillyTavern tới Kunavo bằng endpoint tùy chỉnh và một API key — Claude và GPT trong cùng danh sách model.
API Settings → Proxy → Add Configuration: Proxy URL là đường dẫn đầy đủ /v1/chat/completions, còn Model Name phải khớp chính xác với catalog id.
Bề mặt tương thích OpenAI của Ollama và Kunavo có cùng cấu trúc, nên các công cụ viết cho Ollama cục bộ chỉ cần đổi base URL.
AnythingLLM truy cập endpoint không có nhà cung cấp được đặt tên thông qua Generic OpenAI — Base URL có /v1, key và model id do bạn tự nhập vì nó không tải danh sách.
Settings → Providers → "+" tạo nhà cung cấp tùy chỉnh từ ba trường — Provider name, API Base URL đặt thành https://api.kunavo.com/v1 và API Key — sau đó Fetch đọc danh sách model từ endpoint.
Một trường bắt buộc — API Base URL trong biểu mẫu Add Model của plugin tương thích OpenAI API — trỏ mọi nút LLM trong workspace Dify tới Kunavo.
LibreChat nhận gateway dưới dạng khối endpoints.custom trong librechat.yaml — bốn trường bắt buộc, key từ .env và cần khởi động lại trước khi bộ chọn hiển thị.
Model Hub > Model Providers > Add Provider > Open AI Compatible: API Key và Inference Endpoint là https://api.kunavo.com/v1 — ghi chú của ứng dụng cho biết hầu hết endpoint tương thích OpenAI cần /v1.
Trường Base URL của thông tin xác thực OpenAI — https://api.kunavo.com/v1, giữ /v1 — đưa mọi OpenAI Chat Model trong workflow n8n tới Kunavo; bản thân nút model không có trường endpoint.
Ba biến môi trường — OPENAI_API_KEY, BASE_URL (origin thuần) và CUSTOM_MODELS — đưa NextChat tự lưu trữ tới Claude và GPT qua một key.
Settings → Copilot → BYOK → Add a custom provider: Display name, key của bạn và https://api.kunavo.com/v1 — Quick Chat luôn khả dụng, Agent Chat nằm dưới opencode khi nhà cung cấp được hiển thị ở đó.
Settings → OpenAI Compatible API → Add Provider → Custom: Provider Name, Base URL giữ /v1 và key — sau đó chọn các model id từ danh sách Page Assist tự tải.
Models → Add custom model: Endpoint URL đầy đủ https://api.kunavo.com/v1/chat/completions, header Authorization với Bearer và key của bạn, Model ID cùng context length — mỗi model một mục, được gọi trực tiếp từ trình duyệt.
Các ứng dụng khác
Một client không có trong danh sách này gần như chắc chắn vẫn hoạt động. Hãy kiểm tra xem bạn có thể thay đổi endpoint hay không: nếu có cài đặt “base URL”, “custom endpoint” hoặc “OpenAI-compatible provider”, bạn có thể dùng Kunavo. Bắt đầu với hướng dẫn bắt đầu nhanh, sau đó xem chat completions hoặc Messages API tùy theo định dạng client sử dụng. Model id có tại GET /v1/models, cũng là nguồn dữ liệu để điền menu thả xuống model trong các client có tính năng đó — còn đặc tả OpenAPI 3.1 đầy đủ, ở định dạng máy đọc được, là mô tả OpenAPI 3.1, mà hầu hết trình tạo client và framework tác nhân có thể sử dụng trực tiếp.