Documentación

Dyad

Dyad acepta cualquier endpoint compatible con OpenAI mediante Add Custom Provider: tres campos, una clave en la página del proveedor y luego una fila por cada ID de modelo que quiera en el selector.

Dyad acepta cualquier endpoint compatible con OpenAI mediante Settings → AI Providers → Add Custom Provider: API Base URL https://api.kunavo.com/v1, la clave en la propia página del proveedor y después una fila Add Custom Model por cada ID de modelo.

Configuración → Proveedores de IA → Añadir proveedor personalizado

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

La URL base conserva su /v1, pero no porque lo diga la documentación. La página de modelos personalizados solo dice «Normalmente encontrará la URL base de la API en la documentación del proveedor» y no muestra ningún ejemplo, así que no resuelve la cuestión. Dos elementos de la aplicación publicada sí lo hacen: el marcador de posición del propio cuadro de diálogo dice E.g., https://api.example.com/v1 y el proveedor personalizado se crea como cliente compatible con OpenAI, usando el valor que usted indique como baseURL sin modificarlo; Dyad añade la ruta, nunca /v1. Todos los endpoints compatibles con OpenAI que Dyad codifica directamente terminan igual. Si se omite, la URL base falla con un 404, no con un rechazo de la clave.

Hay dos campos que no aparecen en la página de documentación. En el cuadro de diálogo publicado, el primero se llama Provider ID, no ID, y se añade Environment Variable (Optional): un nombre de variable como KUNAVO_API_KEY, que solo se lee si no hay ninguna clave guardada en la configuración. El cuadro de diálogo no contiene la clave en sí: primero cree el proveedor, ábralo y use el campo Set Kunavo API Key de su página.

Introduzca Context Window; no lo deje en blanco. La única advertencia de Dyad es que los campos vacíos recurren a «valores predeterminados, que pueden ser menores de lo óptimo». El valor predeterminado publicado es 128,000 tokens, y Dyad compacta una conversación cuando se alcanza el menor de estos dos valores: el límite por proveedor o su ventana de contexto menos 25,000. Un proveedor personalizado se guarda con un ID custom::, así que no se le aplica el límite de Google ni el de OpenAI, sino el de 250,000. Si se deja en blanco, un modelo de un millón de tokens empieza a resumir a los 103,000 tokens en vez de a los 250,000; se realizan más pasadas de compactación sobre el mismo trabajo sin ninguna ventaja.

Esta configuración se ha extraído de la documentación propia de Dyad y de su código publicado en la fecha indicada abajo. Kunavo no ha ejecutado Dyad contra su endpoint: no se ha hecho ninguna compilación, edición con transmisión en streaming ni intercambio completo de herramientas en modo Agent, y lo mismo ocurre con todos los clientes de esta familia. Una página de configuración publicada no es una prueba de compatibilidad. Mantenga disponible la ruta que tenga funcionando mientras prueba esta y ejecute una función acotada antes de migrar un proyecto.

Kunavo no ofrece modelos de embeddings, de texto a voz ni de voz a texto, por lo que un proveedor personalizado añadido de esta forma responde a solicitudes de finalización de chat y nada más. El ciclo de compilación de Dyad no solicita ninguna de esas otras tres capacidades, así que aquí no pierde ninguna función; solo significa que el proveedor que acaba de añadir no sustituye directamente a una pila que también las necesite.

¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Dyad.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
En Dyad, vaya a Settings, busque la sección AI Providers y haga clic en Add Custom Provider. Complete los campos ID, Display Name y API Base URL como se muestra arriba. El ID se «usa internamente y no se puede cambiar más adelante», así que elija uno que le resulte adecuado; Display Name es lo que aparece en el selector y es solo visual.
Abra el proveedor que acaba de crear, pegue la clave en Set Kunavo API Key y haga clic en Save Key. Si deja vacía la URL base, Dyad rechaza la solicitud directamente con un error missing the API Base URL, en vez de producir un fallo de red.
En esa misma página, desplácese hasta abajo y haga clic en Add Custom Model. El Model ID debe ser exactamente el slug del catálogo. La documentación de Dyad dice que «debe coincidir exactamente con lo especificado en la documentación de la API del proveedor. Es el identificador que se envía a la API»; por tanto, use claude-sonnet-5, no un nombre para mostrar.
Rellena Máximo de tokens de salida y Ventana de contexto con los datos de /models en lugar de dejarlos en blanco; después, repite Añadir modelo personalizado para cada identificador que quieras incluir en el selector: aquí no hay importación masiva ni se obtiene ninguna lista.
Seleccione el nuevo modelo en el selector y asígnele una tarea real, como añadir un componente, no un saludo. El modo Build es un ciclo de agente que vuelve a enviar el conjunto de trabajo en cada paso, así que la transmisión en streaming y las ediciones repetidas son lo que conviene probar en la primera ejecución.

Comprobado con Página de modelos personalizados de Dyad el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Esta es la versión breve. El tutorial completo —elección del modelo, coste de una sesión real y modos de fallo— está en la guía de precios y costos de API de Dyad.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en 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-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Dónde encaja en Dyad
`claude-sonnet-5`	$1.40 / $7.00	el modelo predeterminado del modo Build: calidad de programación por dólar en un ciclo que funciona todo el día
`claude-opus-5`	$3.50 / $17.50	modo Plan para una refactorización en la que un plan incorrecto cuesta una sesión entera
`claude-haiku-4-5`	$0.70 / $3.50	modo Ask y preguntas rápidas sobre el código base, donde el volumen es lo que más pesa
`gpt-5-6-sol`	$2.00 / $12.00	una segunda opinión de otra familia; añádala como segundo modelo personalizado del mismo proveedor
`gpt-5-6-terra`	$0.70 / $4.20	un conjunto de trabajo grande, una vez rellenado correctamente el campo Context Window

La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Tres límites que conviene conocer antes de cambiar

Estas son reglas propias de Dyad, no de Kunavo, y cada una cambia a qué puede acceder una clave de cliente. Por eso esta página describe una ruta hacia los modelos, no hacia todo Dyad.

Por diseño, no se puede acceder a los modos Pro con una clave propia. La respuesta de las preguntas frecuentes sobre precios de Dyad es tajante: los modos Pro, como Smart Context, solo pueden usarse con créditos de IA de Dyad Pro, no con sus propias claves de API, porque requieren procesamiento del lado del servidor con varios modelos. Turbo Edits es el otro modo. Un proveedor personalizado le da acceso a los modelos y a los modos habituales, no a esos recursos.
El plan gratuito limita el uso del modo Agent. El límite es de 20 mensajes de Agent por cada período de 23 horas y se aplica independientemente de la clave que configure; Build, Ask y Plan no tienen límite. Así que una interrupción inesperada a mitad de una sesión puede deberse a la cuota de Dyad, no a su saldo ni a su endpoint.
No se puede acceder al protocolo Anthropic Messages desde Dyad. Un proveedor personalizado siempre se crea como cliente de chat completions de OpenAI, y el proveedor Anthropic integrado no permite anular la URL base. Por tanto, los modelos Claude llegan aquí a través de la interfaz compatible con OpenAI, que es la configuración descrita arriba y la razón por la que la solicitud de verificación de esta página tiene el formato de OpenAI.

Preguntas frecuentes

¿Cómo añado un proveedor de API personalizado a Dyad?

Vaya a Settings, busque la sección AI Providers y haga clic en Add Custom Provider. Indique un ID, que se usa internamente y no se puede cambiar más adelante; un Display Name para el selector; y la API Base URL de su endpoint. Guárdelo, abra el proveedor que acaba de crear y pegue la clave en el campo «Set <name> API Key» de su página; la clave no forma parte del cuadro de creación. Por último, desplácese hasta abajo de esa página y use Add Custom Model una vez por cada ID de modelo que quiera tener disponible. La documentación de Dyad resume en una línea el requisito para el endpoint: cualquier proveedor sirve siempre que ofrezca una API compatible con OpenAI.

¿La API Base URL de Dyad debe terminar en /v1?

Para un endpoint compatible con OpenAI, sí; por ejemplo, https://api.kunavo.com/v1. La documentación de modelos personalizados de Dyad no lo aclara: solo dice que normalmente se puede encontrar la API Base URL en la documentación del proveedor, sin mostrar ningún ejemplo. Lo confirma el propio cuadro de diálogo, cuyo marcador de posición dice «E.g., https://api.example.com/v1», y la forma en que Dyad crea el cliente: el valor se convierte, sin cambios, en la baseURL de un cliente compatible con OpenAI, al que solo se añade la ruta. Si falta /v1 en la URL base, se produce un error 404, no uno de autenticación; y ocurre lo mismo si la URL ya incluye /chat/completions.

¿Puedo usar modelos Claude con Dyad sin una cuenta de Anthropic?

Sí, mediante un proveedor personalizado, no a través de la entrada Anthropic integrada en Dyad. Dyad crea cada proveedor personalizado como cliente de chat completions de OpenAI, así que el ID de modelo que escriba se resuelve en el endpoint que haya configurado, no en la aplicación; por tanto, puede enviar un ID de Claude. El proveedor Anthropic integrado no sirve para esto: se crea sin argumento de URL base, así que no admite una anulación del tipo ANTHROPIC_BASE_URL y solo se conecta al endpoint propio de Anthropic.

¿Es distinto un proveedor personalizado en Dyad de usar OpenRouter?

Solo cambia la configuración, no el tipo de proveedor. OpenRouter es la única pasarela independiente con varios proveedores que cuenta con un ajuste predefinido en la lista de proveedores de Dyad; solo requiere una clave. Cualquier otra pasarela se añade mediante Add Custom Provider, donde también se introducen manualmente el ID de cada modelo, Max Output Tokens y Context Window. El responsable de mantenimiento de Dyad señaló precisamente esa ruta cuando una pasarela pidió que se añadiera un ajuste predefinido. Compare ambas opciones por precio, condiciones de financiación y los modelos que realmente quiere, no por cuál tiene un logotipo en la lista.

¿Por qué mi modelo personalizado de Dyad empieza a resumir la conversación tan pronto?

Probablemente porque dejó vacío el campo Context Window. Si está vacío, Dyad recurre a 128,000 tokens y compacta cuando se alcanza el menor de estos dos valores: el límite por proveedor o el tamaño de la ventana de contexto menos 25,000. A los proveedores personalizados se les aplica el límite de 250,000, no el de Google ni el de OpenAI. Por tanto, si se deja vacío, la compactación empieza alrededor de los 103,000 tokens incluso en un modelo con una ventana mucho mayor. Introduzca los valores reales del catálogo del proveedor en Max Output Tokens y Context Window, y el umbral pasará a ser el límite.