Dyad

Dyad는 Settings → AI Providers → Add Custom Provider에서 모든 OpenAI 호환 엔드포인트를 지원합니다: API Base URL https://api.kunavo.com/v1, 제공자 페이지의 키, 모델 ID마다 하나의 Add Custom Model 행을 추가합니다

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

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. Dyad에서 Settings로 이동해 AI Providers 섹션을 찾고 Add Custom Provider를 클릭합니다. 위와 같이 ID, Display Name 및 API Base URL을 입력합니다. ID는 “내부적으로 사용되며 나중에 변경할 수 없으므로” 계속 사용할 수 있는 값을 선택하세요. Display Name은 선택기에 표시되는 이름으로, 외관상 용도입니다.
3. 방금 만든 공급자를 열고 Set Kunavo API Key에 키를 붙여 넣은 다음 Save Key를 클릭합니다. 기본 URL을 비워 두면 Dyad가 네트워크 오류가 아니라 missing the API Base URL 오류를 표시하며 요청을 바로 거부합니다.
4. 같은 페이지에서 아래로 스크롤해 Add Custom Model을 클릭합니다. Model ID에는 카탈로그 슬러그를 정확히 입력해야 합니다. Dyad 문서에 따르면 이 값은 “공급자의 API 문서에 지정된 값과 정확히 일치해야 하며 API로 전송되는 식별자”입니다. 따라서 표시 이름이 아닌 claude-sonnet-5를 입력하세요.
5. Max Output Tokens 및 Context Window에 /models의 값을 입력하고 비워 두지 않습니다. 그런 다음 선택기에서 사용할 각 ID마다 Add Custom Model을 반복합니다. 일괄 가져오기 기능은 없고 목록을 가져오는 기능도 없습니다.
6. 모델 선택기에서 새 모델을 선택하고 인사말이 아닌 실제 작업, 예를 들어 추가할 컴포넌트를 요청합니다. Build 모드는 매 단계마다 작업 세트를 다시 전송하는 에이전트 루프이므로, 첫 실행에서는 스트리밍과 반복 편집을 시험해야 합니다.

Dyad의 사용자 지정 모델 페이지에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 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-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

전환 전에 알아야 할 세 가지 제한

이는 Kunavo가 아닌 Dyad 자체의 규칙이며, 각각 고객 키로 접근할 수 있는 범위에 영향을 줍니다. 따라서 이 페이지에서는 모든 Dyad 기능이 아니라 모델에 접근하는 경로를 설명합니다.

1. 설계상 자체 키로 Pro 모드에 접근할 수 없습니다. Dyad 가격 FAQ에는 Smart Context 같은 Pro 모드는 여러 모델에 걸친 서버 측 처리가 필요하기 때문에 자체 API 키가 아닌 Dyad Pro AI 크레딧으로만 사용할 수 있다고 명시되어 있습니다. Turbo Edits도 해당합니다. 사용자 지정 공급자로는 모델과 일반 모드에 접근할 수 있지만, 해당 기능은 사용할 수 없습니다.
2. 무료 요금제에서는 Agent 모드 사용량이 제한됩니다. 23시간 동안 Agent 메시지를 최대 20개까지 보낼 수 있으며, 어떤 키를 설정했는지와 관계없이 적용됩니다. Build, Ask 및 Plan에는 제한이 없습니다. 따라서 세션 도중 예상치 못하게 중단되면 잔액이나 엔드포인트 문제가 아니라 Dyad의 사용량 한도 때문일 수 있습니다.
3. Dyad에서는 Anthropic Messages 프로토콜에 접근할 수 없습니다. 사용자 지정 공급자는 항상 OpenAI 채팅 완성 클라이언트로 생성되고, 기본 제공 Anthropic 공급자에서는 기본 URL을 재정의할 수 없습니다. 따라서 Claude 모델은 OpenAI 호환 인터페이스를 통해 사용해야 합니다. 위 설정이 바로 그 방식이며, 이 페이지의 검증 요청도 OpenAI 형식인 이유입니다.