Tài liệu

Dyad

Dyad chấp nhận mọi endpoint tương thích với OpenAI thông qua Add Custom Provider: ba trường, một khóa trên trang của nhà cung cấp, rồi mỗi ID mô hình bạn muốn có một hàng riêng trong bộ chọn.

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.

Cài đặt → Nhà cung cấp AI → Thêm nhà cung cấp tùy chỉnh

Settings → AI Providers → Add Custom Provider
  ID                  kunavo
  Display Name        Kunavo
  API Base URL        https://api.kunavo.com/v1

Then on the new provider's own page
  Set Kunavo API Key  sk-kn-...            → Save Key

Provider page → bottom → Add Custom Model
  Model ID            claude-sonnet-5
  Name                Claude Sonnet 5 (Kunavo)
  Description         Kunavo, OpenAI-compatible
  Max Output Tokens   128000
  Context Window      1000000

URL cơ sở vẫn cần có /v1 — nhưng không phải vì tài liệu nói vậy. Trang về mô hình tùy chỉnh chỉ ghi “Bạn thường có thể tìm URL cơ sở API trong tài liệu của nhà cung cấp” và không đưa ra ví dụ, nên không giải đáp được câu hỏi. Có hai điều trong ứng dụng đang phát hành giúp xác định điều này: văn bản gợi ý trong chính hộp thoại là E.g., https://api.example.com/v1, và nhà cung cấp tùy chỉnh được tạo dưới dạng ứng dụng khách tương thích với OpenAI, với giá trị bạn nhập được dùng nguyên vẹn làm baseURL — Dyad thêm đường dẫn, chứ không thêm /v1. Mọi endpoint tương thích với OpenAI mà Dyad tự đặt cố định đều kết thúc theo cùng cách. URL cơ sở thiếu phần này sẽ gây lỗi 404, chứ không phải lỗi từ chối khóa.

Có hai trường không xuất hiện trên trang tài liệu. Hộp thoại trong ứng dụng đang phát hành gọi trường thứ nhất là ID nhà cung cấp thay vì ID, và bổ sung Biến môi trường (Tùy chọn) — tên một biến, chẳng hạn KUNAVO_API_KEY, chỉ được đọc khi không có khóa nào được lưu trong phần cài đặt. Khóa không nằm trong hộp thoại đó: trước tiên hãy tạo nhà cung cấp, mở trang của nhà cung cấp rồi dùng hộp Đặt khóa API Kunavo trên trang đó.

Hãy nhập Kích thước cửa sổ ngữ cảnh, đừng để trống. Cảnh báo duy nhất của Dyad là các trường để trống sẽ dùng “giá trị mặc định, có thể thấp hơn mức tối ưu”. Giá trị mặc định trong ứng dụng đang phát hành là 128.000 token, và Dyad nén hội thoại khi đạt mức thấp hơn giữa giới hạn của nhà cung cấp và kích thước ngữ cảnh trừ đi 25.000. Nhà cung cấp tùy chỉnh được lưu dưới ID custom::, nên không chịu giới hạn của Google hay OpenAI mà là giới hạn 250.000. Vì vậy, nếu để trống, mô hình có cửa sổ một triệu token sẽ bắt đầu tóm tắt ở mức 103.000 token thay vì 250.000 — thực hiện thêm các lượt nén trên cùng một khối lượng công việc mà không được lợi gì.

Cấu hình này được đối chiếu với tài liệu và mã nguồn đang phát hành của chính Dyad vào ngày bên dưới. Kunavo chưa chạy Dyad với endpoint của mình — chưa chạy bản dựng, chưa chỉnh sửa qua luồng truyền phát, chưa có lượt trao đổi công cụ ở Chế độ Agent — và điều tương tự cũng đúng với mọi ứng dụng khách trong nhóm này. Trang hướng dẫn thiết lập đã xuất bản không phải là bài kiểm tra khả năng tương thích. Hãy giữ sẵn tuyến đang hoạt động trong khi thử tuyến này, rồi chạy một tính năng có phạm vi giới hạn trước khi chuyển dự án sang dùng nó.

Kunavo không cung cấp mô hình embedding, chuyển văn bản thành giọng nói hay chuyển giọng nói thành văn bản, vì vậy nhà cung cấp tùy chỉnh được thêm theo cách này chỉ trả lời các yêu cầu hoàn tất chat. Vòng lặp xây dựng của Dyad không yêu cầu ba loại còn lại, nên việc này không làm mất tính năng nào ở đây — chỉ có nghĩa là nhà cung cấp bạn vừa thêm không thể thay thế trực tiếp một ngăn xếp cũng cần các loại đó.

Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Dyad.

Từng bước

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.
Trong Dyad, vào Cài đặt, tìm phần Nhà cung cấp AI rồi nhấp Thêm nhà cung cấp tùy chỉnh. Điền ID, Tên hiển thị và URL cơ sở API như trên. ID được “dùng nội bộ và không thể thay đổi sau này”, nên hãy chọn một tên phù hợp để sử dụng lâu dài; Tên hiển thị xuất hiện trong bộ chọn và chỉ mang tính hình thức.
Mở nhà cung cấp bạn vừa tạo, dán khóa vào Đặt khóa API Kunavo, rồi nhấp Lưu khóa. Nếu để trống URL cơ sở, Dyad sẽ từ chối yêu cầu ngay lập tức với lỗi thiếu URL cơ sở API, chứ không phải lỗi mạng.
Trên cùng trang đó, cuộn xuống cuối rồi nhấp Thêm mô hình tùy chỉnh. ID mô hình phải khớp chính xác với slug trong danh mục — tài liệu Dyad ghi rằng ID “phải khớp chính xác với thông tin trong tài liệu API của nhà cung cấp. Đây là mã định danh được gửi đến API” — vì vậy hãy dùng claude-sonnet-5, không phải tên hiển thị.
Điền Số token đầu ra tối đa và Kích thước cửa sổ ngữ cảnh theo /models thay vì để trống, rồi lặp lại thao tác Thêm mô hình tùy chỉnh cho mỗi ID bạn muốn có trong bộ chọn — không có chức năng nhập hàng loạt hay lấy danh sách mô hình tại đây.
Chọn mô hình mới trong bộ chọn mô hình rồi giao cho nó một tác vụ thực tế — thêm một thành phần, chứ không phải lời chào. Chế độ Build là một vòng lặp tác tử gửi lại tập hợp nội dung đang xử lý ở mỗi bước, vì vậy lượt chạy đầu tiên nên kiểm tra khả năng truyền phát và chỉnh sửa lặp lại.

Đã kiểm tra đối chiếu với Trang Mô hình tùy chỉnh của Dyad vào 21 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.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong hướng dẫn về giá và chi phí API của Dyad.

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 Dyad.

# 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.

ID mô hình	Kunavo vào / ra	Phù hợp ở đâu trong Dyad
`claude-sonnet-5`	$1.40 / $7.00	mô hình Chế độ Build mặc định — chất lượng lập trình trên mỗi đồng chi cho một vòng lặp chạy cả ngày
`claude-opus-5`	$3.50 / $17.50	Chế độ Plan trong một lần tái cấu trúc mà kế hoạch sai có thể khiến mất cả buổi làm việc
`claude-haiku-4-5`	$0.70 / $3.50	Chế độ Ask và các câu hỏi nhanh về cơ sở mã, nơi khối lượng sử dụng là yếu tố chi phối
`gpt-5-6-sol`	$2.00 / $12.00	lấy ý kiến thứ hai từ một họ mô hình khác — thêm thành mô hình tùy chỉnh thứ hai, dùng chung nhà cung cấp
`gpt-5-6-terra`	$0.70 / $4.20	một tập hợp nội dung đang xử lý lớn, sau khi điền đúng trường Kích thước cửa sổ ngữ cảnh

Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

Ba giới hạn cần biết trước khi chuyển đổi

Đây là các quy tắc của Dyad, không phải của Kunavo; mỗi quy tắc đều ảnh hưởng đến những gì khóa khách hàng có thể truy cập. Đó là lý do trang này mô tả đường dẫn đến các mô hình, chứ không phải đến toàn bộ Dyad.

Cố ý không cho phép truy cập các chế độ Pro bằng khóa riêng của bạn. Câu hỏi thường gặp về giá của Dyad trả lời dứt khoát: các chế độ Pro như Smart Context chỉ dùng được bằng tín dụng AI của Dyad Pro, không dùng được bằng khóa API riêng, vì chúng cần xử lý phía máy chủ trên nhiều mô hình. Turbo Edits cũng thuộc nhóm này. Nhà cung cấp tùy chỉnh cho phép bạn dùng các mô hình và chế độ thông thường, chứ không cung cấp cơ chế đó.
Gói miễn phí giới hạn mức sử dụng Chế độ Agent. Giới hạn là 20 tin nhắn Agent trong mỗi khoảng thời gian 23 giờ và áp dụng bất kể bạn cấu hình khóa nào — Build, Ask và Plan không bị giới hạn. Vì vậy, nếu phiên làm việc dừng bất ngờ giữa chừng, nguyên nhân có thể là hạn mức của Dyad chứ không liên quan đến số dư hay endpoint của bạn.
Dyad không thể truy cập giao thức Anthropic Messages. Nhà cung cấp tùy chỉnh luôn được tạo dưới dạng ứng dụng khách hoàn tất chat của OpenAI, còn nhà cung cấp Anthropic tích hợp sẵn không cho phép ghi đè URL cơ sở. Vì vậy, các mô hình Claude được gọi tại đây thông qua giao diện tương thích với OpenAI — đó là cách thiết lập bên trên hoạt động, và cũng là lý do yêu cầu xác minh trên trang này có định dạng của OpenAI.

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

Làm cách nào để thêm nhà cung cấp API tùy chỉnh vào Dyad?

Vào Cài đặt, tìm phần Nhà cung cấp AI rồi nhấp Thêm nhà cung cấp tùy chỉnh. Điền ID, được dùng nội bộ và không thể thay đổi sau này; Tên hiển thị dùng trong bộ chọn; và URL cơ sở API của endpoint. Lưu lại, rồi mở nhà cung cấp bạn vừa tạo và dán khóa vào hộp "Đặt khóa API <name>" trên trang đó — khóa không nằm trong hộp thoại tạo nhà cung cấp. Cuối cùng, cuộn xuống cuối trang và dùng Thêm mô hình tùy chỉnh một lần cho mỗi ID mô hình bạn muốn sử dụng. Tài liệu Dyad nêu yêu cầu đối với endpoint trong một câu: mọi nhà cung cấp đều dùng được miễn là cung cấp API tương thích với OpenAI.

URL cơ sở API của Dyad có cần kết thúc bằng /v1 không?

Có, với endpoint tương thích với OpenAI — ví dụ https://api.kunavo.com/v1. Tài liệu Mô hình tùy chỉnh của Dyad không giải đáp được điều này: tài liệu chỉ nói rằng bạn thường có thể tìm URL cơ sở API trong tài liệu của nhà cung cấp, nhưng không đưa ra ví dụ. Câu trả lời nằm ở chính hộp thoại, nơi có gợi ý "E.g., https://api.example.com/v1", và ở cách Dyad tạo ứng dụng khách — giá trị bạn nhập trở thành baseURL của ứng dụng khách tương thích với OpenAI nguyên vẹn, chỉ có đường dẫn được nối thêm. URL cơ sở thiếu /v1 sẽ gây lỗi 404 chứ không phải lỗi xác thực; URL đã có /chat/completions cũng gây lỗi tương tự.

Tôi có thể dùng Dyad với các mô hình Claude mà không cần tài khoản Anthropic không?

Có, thông qua nhà cung cấp tùy chỉnh chứ không phải mục Anthropic tích hợp sẵn của Dyad. Dyad tạo mọi nhà cung cấp tùy chỉnh dưới dạng ứng dụng khách hoàn tất chat của OpenAI, nên ID mô hình bạn nhập sẽ được phân giải tại endpoint bạn đã cấu hình chứ không phải trong ứng dụng; do đó, ID Claude có thể được gửi đến endpoint đó. Nhà cung cấp Anthropic tích hợp sẵn không giúp được trong trường hợp này: nó được tạo mà không có tham số URL cơ sở, nên không có tùy chọn ghi đè kiểu ANTHROPIC_BASE_URL và chỉ truy cập endpoint riêng của Anthropic.

Nhà cung cấp tùy chỉnh trong Dyad có khác với việc dùng OpenRouter không?

Chỉ khác về cách thiết lập, không khác về bản chất. OpenRouter là cổng đa nhà cung cấp độc lập duy nhất có cấu hình sẵn trong danh sách nhà cung cấp của Dyad, nên chỉ cần khóa là đủ; mọi cổng khác đều được thêm qua Thêm nhà cung cấp tùy chỉnh, nơi bạn cũng phải nhập thủ công ID, Số token đầu ra tối đa và Kích thước cửa sổ ngữ cảnh cho từng mô hình. Người duy trì Dyad đã chỉ đúng vào cách này khi một cổng yêu cầu được thêm làm cấu hình sẵn. Hãy so sánh hai lựa chọn về giá, điều khoản nạp tiền và các mô hình bạn thực sự muốn dùng, thay vì dựa vào lựa chọn nào có logo trong danh sách.

Vì sao mô hình tùy chỉnh Dyad của tôi bắt đầu tóm tắt hội thoại quá sớm?

Có thể bạn đã để trống trường Kích thước cửa sổ ngữ cảnh. Khi trường này trống, Dyad dùng mặc định 128.000 token và nén nội dung khi đạt mức thấp hơn giữa giới hạn của nhà cung cấp và kích thước ngữ cảnh trừ đi 25.000 — còn nhà cung cấp tùy chỉnh chịu giới hạn 250.000, không phải giới hạn của Google hay OpenAI. Vì vậy, để trống đồng nghĩa với việc quá trình nén bắt đầu ở khoảng 103.000 token, kể cả với mô hình có cửa sổ lớn hơn nhiều. Nhập số liệu thực tế từ danh mục của nhà cung cấp vào Số token đầu ra tối đa và Kích thước cửa sổ ngữ cảnh để ngưỡng chuyển lên mức giới hạn.