Documentación
Amp
Amp enruta los modelos en el servidor, así que no hay ninguna variable de URL base que debas configurar en tu equipo: añades una conexión de URL personalizada en Model Routing y la nube de Amp llama al endpoint. Esta función está detrás de un plan de pago, así que lo primero es comprobar el plan.
Una conexión Custom URL en Model Routing de Amp — formato de API chat-completions, URL base https://api.kunavo.com/v1 y clave como token bearer — traslada los modelos asignados a una sola clave, en las categorías que ofrecen la opción.
Connection type Custom URL (Model Routing → Add)
API format chat-completions OpenAI Chat Completions API, the default
Base URL https://api.kunavo.com/v1
Key sk-kn-... sent as Authorization: Bearer <key>
Headers — nothing extra is needed
Query Parameters — nothing extra is needed
Model mapping anthropic/claude-opus-4-6 -> claude-opus-4-6
anthropic/claude-fable-5 -> claude-fable-5
openai/gpt-5.6-sol -> gpt-5-6-solchat-completions conserva el sufijo /v1 en la URL base, porque Amp solo añade la ruta. Su propio ejemplo práctico lo deja claro: «una URL base https://api.example.com/v1 con chat-completions envía solicitudes a https://api.example.com/v1/chat/completions». La misma página añade que se «acepta y no se duplica» una URL base que ya termina en /v1, y que el formulario de conexión muestra la URL de la solicitud mientras escribes, así que puedes revisar la URL resultante antes de guardarla.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 Amp.Paso a paso
- Cree una clave en
/app/keysy cópiela: se muestra una sola vez. - Abre Model Routing en la configuración personal (los administradores del espacio de trabajo pueden usar Workspace Model Routing para compartir una conexión con todos los miembros), abre el menú Add y elige Custom URL.
- Establece el formato de API en
chat-completions, pegahttps://api.kunavo.com/v1como URL base y tu clavesk-kn-como clave. Amp la envía comoAuthorization: Bearer <key>en todos los formatos, que es el encabezado con el que se autentica Kunavo, así que deja vacíos Headers y Query Parameters. - Escribe la asignación de modelos, con un patrón por línea. El lado izquierdo es el ID de modelo canónico de Amp y el lado derecho, después de
->, es el ID que recibe Kunavo: los nombres difieren (Amp escribeopenai/gpt-5.6-soly Kunavo responde agpt-5-6-sol), así que aquí la flecha es imprescindible. Usa el selector Models para insertar los ID canónicos en vez de escribirlos de memoria. - Pulsa Check Access. Amp muestra los modelos del endpoint cuando la asignación es amplia y envía una solicitud de un token cuando la asignación especifica exactamente un modelo. Después, confirma que el gráfico de enrutamiento debajo de la lista de conexiones muestra a Kunavo sirviendo los modelos que asignaste y que todo lo que no asignaste sigue indicando Amp.
Comprobado con Documentación de Model Routing de Amp 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.
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 Amp.
# 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 Amp |
|---|---|---|
gpt-5-6-sol | $2.00 / $12.00 | el agente principal del modo Medium y Puck — el modelo de trabajo predeterminado de Amp |
gpt-6-astra | $4.00 / $20.00 | el agente principal del modo High y el subagente Oracle en la mayoría de los modos |
claude-fable-5-1 | $7.00 / $35.00 | el agente principal del modo Ultra, reservado para tareas abiertas difíciles |
gpt-5-6-terra | $0.70 / $4.20 | el subagente Search — recuperación de información del código base, donde predomina el volumen |
claude-haiku-4-5 | $0.70 / $3.50 | View Media, el modelo de Amp para imágenes, PDF y vídeo — Claude lee imágenes, no vídeo |
Qué no cambia al conectar
El enrutamiento de modelos cambia quién factura tus tokens y nada más. El cómputo orb de Amp se mide por separado y por minuto, así que una conexión no altera esa partida; las herramientas que no son modelos, como la búsqueda web, siguen consumiendo créditos de Amp independientemente de cómo se enruten los modelos. La suscripción de Amp que desbloquea la opción de URL personalizada también es un coste fijo que se aplica antes del primer token.
Dos modelos que Amp ejecuta de forma predeterminada no aparecen en la tabla anterior porque Kunavo no los ofrece: los modelos GLM del modo Low y el subagente Read Thread. Una conexión no puede reproducir la configuración del nivel más económico de Amp, así que una asignación de */* dejará discretamente esos dos modelos en Amp. Ese es el resultado esperado, no un error de configuración: la regla de Amp es que Amp sirve todo lo que no sirva ninguna conexión.
Preguntas frecuentes
¿Puede Amp usar un endpoint de API personalizado?
Sí, mediante una conexión de URL personalizada en Model Routing, pero no en todos los planes. La documentación de Model Routing de Amp indica que los enrutadores y las pasarelas de modelos de IA —categoría a la que pertenece Custom URL— son experimentales y están en acceso anticipado solo para clientes de Megawatt, Gigawatt y Enterprise, y que Amp los ofrecerá pronto a todos, aunque sin indicar una fecha. Ese era el estado al 21 de septiembre de 2026. En una cuenta Hobby, el menú Add no ofrece la opción, así que lo primero es comprobar el plan, no la URL base.
¿La URL base de Amp debe terminar en /v1?
Depende del formato de API que elijas; por eso este campo suele interpretarse mal. Con chat-completions, Amp solo añade /chat/completions, así que la URL base debe ser la raíz /v1: su propio ejemplo documentado convierte https://api.example.com/v1 en https://api.example.com/v1/chat/completions. Con anthropic-messages, Amp añade /v1/messages, así que en ese caso corresponde usar el origen sin ruta. Amp también indica que acepta una URL base que ya termina en /v1 sin duplicarlo y que el formulario de conexión muestra la URL completa de la solicitud mientras escribes, para que puedas revisarla antes de guardar.
¿Dónde guarda Amp la clave de API para un endpoint personalizado?
En los servidores de Amp, no en tu equipo. Amp gestiona la inferencia desde su propia nube, así que la conexión de URL personalizada se configura en Model Routing, en los ajustes de tu cuenta, no en un archivo de configuración local ni en una variable de entorno; además, el endpoint que indiques debe ser accesible desde la infraestructura de Amp. Amp envía la credencial como encabezado Authorization: Bearer en sus tres formatos de API. La referencia publicada de los ajustes de CLI de Amp no incluye ninguna configuración de URL base ni de clave de API; es el mismo hecho visto desde el lado del cliente.
¿Por qué Amp sigue usando sus propios modelos después de que añado una conexión?
Porque una conexión solo sirve los modelos incluidos en su asignación y Amp sirve por su cuenta todos los demás. Comprueba tres cosas, en este orden: que la conexión esté activa, su posición en la lista de prioridad —primero las conexiones personales, después las del espacio de trabajo y, por último, Amp; se prueba primero la prioridad 0— y que la asignación de modelos coincida con el modelo que ejecuta tu modo. El gráfico de enrutamiento debajo de la lista de conexiones muestra qué conexión sirve cada modelo, y amp config model-providers check-access --provider-model ejecuta una inferencia breve e indica qué conexión la sirvió realmente.
¿Ha probado Kunavo Amp con su endpoint?
No. Kunavo no ha probado Amp en ejecución; esta página transcribe la documentación de Model Routing de Amp consultada el 21 de septiembre de 2026, no relata una sesión completada. La función Custom URL requiere un plan de pago de Amp, así que estos campos se cotejaron con las especificaciones publicadas de Amp, no con un cliente en ejecución. El botón Check Access de Amp verifica la credencial con el proveedor y es la prueba definitiva; si el nombre de algún campo de esta página ya no coincide con lo que muestra Amp, prevalece la página de Amp.