goose

Settings → Models → Configure providers → OpenAI: Host URL nhận origin thuần, vì goose tự thêm đường dẫn request (v1/chat/completions).

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

Từng bước

1. Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
2. Trong goose Desktop: thanh bên → Cài đặt → Mô hình → Cấu hình provider → OpenAI. Trong CLI: goose configure → Cấu hình provider → OpenAI.
3. Điền Khóa API và Host URL. Để trống ID tổ chức và Dự án — goose ghi rõ các trường này dùng để theo dõi mức sử dụng và quản lý tài nguyên trong tài khoản OpenAI của riêng bạn; Kunavo không có thông tin tương ứng để điền vào đó. Nhấp Gửi.
4. Chọn mô hình. Ghi chú của goose nêu rõ rằng goose configure “không hỗ trợ nhập tên mô hình tùy chỉnh” — vì vậy, nếu ID bạn cần không có trong danh sách được tải về, hãy nhập ID đó trong goose Desktop hoặc đặt GOOSE_MODEL trong config.yaml, thao tác này sẽ ghi đè tệp đối với tiến trình đó.
5. Bắt đầu một phiên và giao cho nó tác vụ thao tác với tệp. goose dựa vào việc gọi công cụ trong gần như mọi thao tác — trang provider của chính goose cảnh báo rằng mô hình không hỗ trợ gọi công cụ “chỉ có thể thực hiện chat completion” và khi dùng mô hình đó phải tắt các tiện ích mở rộng — vì vậy, lần chạy đầu tiên để đọc và chỉnh sửa nội dung sẽ cho bạn biết nhiều hơn chỉ một lời chào.

Đã kiểm tra đối chiếu với Trang Configure LLM Provider của goose vào 29 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong goose.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

Cách khác: tệp provider của Kunavo

goose cũng tải định nghĩa provider từ các tệp JSON trong thư mục custom_providers, và provider được thêm theo cách đó sẽ có mục riêng trong bộ chọn, khóa riêng và danh sách mô hình được lưu trữ, thay vì dùng chung vị trí mang tên OpenAI. Kunavo công bố một tệp tại kunavo.com/goose/kunavo.json. Tệp được tạo từ danh mục trực tiếp nên danh sách mô hình gồm những mô hình Kunavo đang cung cấp; tệp ghi tên biến khóa chứ không chứa khóa:

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Trên Windows, thư mục là %APPDATA%\Block\goose\config\custom_providers\. Trong goose Desktop, provider sẽ xuất hiện dưới mục Cấu hình provider với tên Kunavo; bạn có thể lưu khóa vào kho khóa thay vì biến môi trường.

1. Endpoint. Tệp đặt base_url thành https://api.kunavo.com/v1. Tài liệu goose không cho biết trường đó cần base /v1 hay /v1/chat/completions đầy đủ như trong ví dụ; mã nguồn của goose làm rõ điều này — derive_base_path chuyển cả hai thành cùng một đường dẫn v1/chat/completions.
2. Các ID GPT dùng Responses API. goose gửi các ID mô hình bắt đầu bằng gpt-5 hoặc gpt-6 đến /v1/responses, còn mọi ID khác đến /v1/chat/completions. Kunavo cung cấp cả hai, vì vậy các ID Claude và GPT trong tệp dùng chung một khóa.
3. Chỉ liệt kê các mô hình hỗ trợ gọi công cụ. goose dựa vào công cụ trong gần như mọi lượt, vì vậy các mô hình hình ảnh, video và âm thanh không có trong tệp dù cùng khóa vẫn có thể gọi chúng.

Lưu ý tương tự như phần còn lại của trang này: nội dung được đối chiếu với tài liệu và mã nguồn của goose, chứ chưa chạy thử. Muốn tự viết provider? Cấu hình provider → Thêm provider tùy chỉnh sẽ yêu cầu các thông tin tương tự — loại OpenAI Compatible, URL API https://api.kunavo.com/v1, khóa sk-kn- của bạn và danh sách mô hình phân tách bằng dấu phẩy.