Documentação

Dyad

O Dyad aceita qualquer endpoint compatível com OpenAI por meio de Add Custom Provider: são três campos, uma chave na página do provedor e, depois, uma linha por ID de modelo desejado no seletor.

O Dyad aceita qualquer endpoint compatível com OpenAI por meio de Settings → AI Providers → Add Custom Provider: API Base URL https://api.kunavo.com/v1, a chave na própria página do provedor e depois uma linha Add Custom Model para cada ID de modelo.

Settings → AI Providers → Add Custom Provider

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

A URL base mantém seu /v1 — mas não porque a documentação diga isso. A página de modelos personalizados diz apenas “You can usually find the API Base URL in the provider's documentation” e não mostra nenhum exemplo, portanto não esclarece a questão. Dois elementos do aplicativo disponível em produção esclarecem: o espaço reservado da própria caixa de diálogo mostra E.g., https://api.example.com/v1, e um provedor personalizado é criado como um cliente compatível com OpenAI, usando o valor informado como baseURL sem alterações — o Dyad acrescenta a rota, nunca o /v1. Todos os endpoints compatíveis com OpenAI que o próprio Dyad define terminam da mesma forma. Uma URL base sem esse sufixo falha com um 404, não por rejeição da chave.

Há dois campos que não aparecem na página da documentação. Na caixa de diálogo do aplicativo disponível em produção, o primeiro se chama Provider ID, em vez de ID, e também há Environment Variable (Optional) — um nome de variável, como KUNAVO_API_KEY, que só é lido quando nenhuma chave está salva nas configurações. A própria chave não aparece nessa caixa de diálogo: primeiro crie o provedor, abra-o e use o campo Set Kunavo API Key na página dele.

Preencha o campo Context Window; não o deixe em branco. O único aviso do Dyad é que campos vazios usam “default values, which may be smaller than optimal”. O valor padrão em produção é de 128,000 tokens, e o Dyad compacta uma conversa no menor valor entre o limite por provedor e o tamanho do contexto menos 25,000. Um provedor personalizado é armazenado com um ID custom::, então não se aplica a ele o limite do Google nem o da OpenAI, mas sim o de 250,000. Se ficar em branco, um modelo com um milhão de tokens começará a resumir aos 103,000 tokens, em vez de 250,000 — haverá mais rodadas de compactação para o mesmo trabalho, sem necessidade.

Esta configuração foi consultada na documentação do próprio Dyad e no código-fonte disponível em produção na data abaixo. A Kunavo não executou o Dyad contra seu endpoint — não testou uma compilação, uma edição com streaming nem uma chamada de ferramenta de ponta a ponta no modo Agent —, e o mesmo vale para todos os clientes desta família. Uma página de configuração publicada não é um teste de compatibilidade. Mantenha disponível a rota que já funciona enquanto experimenta esta e execute um recurso de escopo limitado antes de migrar um projeto para ela.

A Kunavo não oferece modelos de embeddings, de conversão de texto em fala nem de conversão de fala em texto, então um provedor personalizado adicionado dessa forma responde a solicitações de conclusão de chat e nada mais. O ciclo de compilação do Dyad não solicita nenhum dos outros três, então isso não elimina nenhum recurso aqui — apenas significa que o provedor que você acabou de adicionar não substitui diretamente uma stack que também dependa deles.

Ainda não tem uma chave? Crie uma conta na Kunavo, gere uma chave (ela começa com sk-kn-) e adicione crédito a partir de $10 — as chamadas são pagas com esse saldo, e chamadas malsucedidas não são cobradas. O painel então abre na configuração de Dyad.

Passo a passo

Crie uma chave em /app/keys e copie-a — ela é exibida uma única vez.
No Dyad, acesse Settings, localize a seção AI Providers e clique em Add Custom Provider. Preencha ID, Display Name e API Base URL conforme indicado acima. O ID é “used internally and cannot be changed later”, então escolha um que você possa manter; o Display Name é exibido no seletor e serve apenas para apresentação.
Abra o provedor que acabou de criar, cole a chave em Set Kunavo API Key e clique em Save Key. Se deixar a URL base em branco, o Dyad recusará a solicitação diretamente com o erro missing the API Base URL, em vez de ocorrer uma falha de rede.
Nessa mesma página, role até o fim e clique em Add Custom Model. O Model ID deve corresponder exatamente ao slug do catálogo — a documentação do Dyad diz que ele “must match exactly what's specified in the provider's API documentation. It's the identifier sent to the API” —, portanto use claude-sonnet-5, não um nome de exibição.
Preencha Max Output Tokens e Context Window com base em /models, em vez de deixá-los em branco. Depois, repita Add Custom Model para cada ID que quiser no seletor — não há importação em lote nem lista carregada automaticamente.
Selecione o novo modelo no seletor e atribua a ele uma tarefa real — por exemplo, adicionar um componente, em vez de apenas cumprimentar. O modo Build é um ciclo agêntico que reenvia um conjunto de trabalho a cada etapa, então a primeira execução deve exercitar o streaming e as edições repetidas.

Verificado em Página de Custom Models do Dyad em 21 de setembro de 2026. As configurações de terceiros podem mudar; se o nome de um campo aqui já não corresponder ao que você vê, aquela página é a autoridade, não esta.

Esta é a versão resumida. O guia completo — escolha do modelo, custo de uma sessão real e modos de falha — está em o guia de preços e custos de API do Dyad.

Verifique antes de depurar o cliente

Uma solicitação determina se a falha está no endpoint, na chave ou no arquivo de configuração. Se isto retornar JSON, a mesma URL base e a mesma chave funcionarão em 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-..."

Qual ID de modelo inserir no campo

Todo modelo de texto pode ser acessado como um ID de modelo — a lista atual está em GET /v1/models, e o catálogo com preços está na página de modelos. As tarifas são em USD por 1 milhão de tokens, entrada / saída.

ID do modelo	Entrada / saída da Kunavo	Onde se encaixa em Dyad
`claude-sonnet-5`	$1.40 / $7.00	o modelo padrão do modo Build — qualidade de programação por dólar em um ciclo que roda o dia todo
`claude-opus-5`	$3.50 / $17.50	modo Plan para uma refatoração em que um plano errado custa uma sessão inteira
`claude-haiku-4-5`	$0.70 / $3.50	perguntas rápidas e modo Ask sobre a base de código, em que o volume predomina
`gpt-5-6-sol`	$2.00 / $12.00	uma segunda opinião de outra família — adicione-a como um segundo modelo personalizado, no mesmo provedor
`gpt-5-6-terra`	$0.70 / $4.20	um grande conjunto de trabalho, depois de preencher corretamente o campo Context Window

A cobrança é por token, usando um saldo pré-pago e sem tarifa mensal — consulte billing. Em contextos repetidos — que representam a maior parte do que um editor ou cliente de chat envia — o cache de prompt altera a conta mais do que a escolha do modelo.

Três limites que você precisa conhecer antes de mudar

Estas são regras do próprio Dyad, não da Kunavo, e cada uma muda o que uma chave de cliente pode acessar. Por isso, esta página descreve uma rota até os modelos, não até todo o Dyad.

Não é possível acessar os modos Pro com sua própria chave; isso é intencional. A resposta na seção de perguntas frequentes sobre preços do Dyad é direta: modos Pro como Smart Context só podem ser usados com os créditos de IA do Dyad Pro, não com suas próprias chaves de API, pois exigem processamento no servidor que usa vários modelos. Turbo Edits é o outro recurso nessa situação. Um provedor personalizado dá acesso aos modelos e aos modos comuns, não a esses recursos.
O uso do modo Agent é limitado no plano gratuito. O limite é de 20 mensagens do Agent em um período de 23 horas e se aplica independentemente da chave configurada — Build, Ask e Plan não têm limite. Portanto, se a sessão parar inesperadamente no meio, pode ser por causa da cota do Dyad, não do seu saldo nem do endpoint.
Não é possível acessar o protocolo Anthropic Messages pelo Dyad. Um provedor personalizado é sempre criado como um cliente de chat completions da OpenAI, e o provedor Anthropic integrado não aceita uma substituição da URL base. Portanto, os modelos Claude chegam aqui pela interface compatível com OpenAI — é isso que a configuração acima faz e por que a solicitação de verificação nesta página segue o formato da OpenAI.

Perguntas frequentes

Como adiciono um provedor de API personalizado ao Dyad?

Acesse Settings, localize a seção AI Providers e clique em Add Custom Provider. Preencha um ID, usado internamente e que não pode ser alterado depois, um Display Name para o seletor e a API Base URL do seu endpoint. Salve; em seguida, abra o provedor que acabou de criar e cole sua chave no campo "Set <name> API Key" da página — a chave não faz parte da caixa de diálogo de criação. Por fim, role até o fim dessa página e use Add Custom Model uma vez para cada ID de modelo que quiser disponibilizar. A documentação do Dyad resume em uma linha o requisito para o endpoint: qualquer provedor serve, desde que ofereça uma API compatível com OpenAI.

A API Base URL do Dyad precisa terminar em /v1?

Para um endpoint compatível com OpenAI, sim — por exemplo, https://api.kunavo.com/v1. A documentação de Custom Models do Dyad não esclarece isso: ela apenas diz que geralmente é possível encontrar a API Base URL na documentação do provedor e não mostra nenhum exemplo. A resposta está na própria caixa de diálogo, cujo espaço reservado mostra "E.g., https://api.example.com/v1", e na forma como o Dyad cria o cliente — o valor informado se torna a baseURL de um cliente compatível com OpenAI, sem alterações; somente a rota é acrescentada. Se faltar /v1 na URL base, haverá um 404, não um erro de autenticação; se ela já incluir /chat/completions, ocorrerá a mesma falha.

Posso usar modelos Claude no Dyad sem ter uma conta Anthropic?

Sim, por meio de um provedor personalizado, não da entrada Anthropic integrada do Dyad. O Dyad cria todos os provedores personalizados como clientes de chat completions da OpenAI, então o ID do modelo digitado é resolvido no endpoint configurado, não no aplicativo; por isso, um ID Claude pode ser enviado para lá. O provedor Anthropic integrado não ajuda nesse caso: ele é criado sem um argumento de URL base, então não há uma substituição no estilo ANTHROPIC_BASE_URL e ele acessa apenas o endpoint próprio da Anthropic.

Um provedor personalizado no Dyad é diferente de usar o OpenRouter?

A diferença está apenas na configuração, não no tipo de provedor. O OpenRouter é o único gateway independente para vários fornecedores com uma predefinição integrada na lista de provedores do Dyad, então exige apenas uma chave; todos os outros gateways são adicionados por meio de Add Custom Provider, onde também é preciso digitar manualmente o ID, Max Output Tokens e Context Window de cada modelo. O mantenedor do Dyad apontou exatamente esse caminho quando um gateway pediu para ser adicionado como predefinição. Compare os dois pelo preço, pelas condições de financiamento e pelos modelos que você realmente quer usar, não pela presença de um logotipo na lista.

Por que meu modelo personalizado do Dyad começa a resumir a conversa tão cedo?

Provavelmente porque o campo Context Window ficou em branco. Quando ele está vazio, o Dyad usa o valor padrão de 128,000 tokens e compacta no menor valor entre o limite por provedor e o tamanho do contexto menos 25,000 — um provedor personalizado usa o limite de 250,000, não o do Google nem o da OpenAI. Portanto, mesmo em um modelo com uma janela muito maior, deixar o campo em branco significa que a compactação começa por volta de 103,000 tokens. Preencha Max Output Tokens e Context Window com os valores reais do catálogo do provedor; assim, o limite passa a ser o teto.