Documentación

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.

Configuración → Enrutamiento de modelos → Añadir → URL personalizada
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-sol
Antes que nada, comprueba tu plan de Amp. La página Model Routing de Amp indica, a fecha de 2026-09-21, que «los enrutadores y las pasarelas de modelos de IA son experimentales y están en acceso anticipado solo para clientes de Megawatt, Gigawatt y Enterprise. Pronto los ofreceremos a todos». Una conexión de URL personalizada pertenece a esa categoría, así que el menú Add no la ofrecerá en una cuenta Hobby. Amp no ha publicado una fecha de lanzamiento general, y esta página no pretende predecirla.
Kunavo no ha probado Amp con este endpoint. Todos los campos anteriores se han tomado de la documentación de Amp, no de una sesión completada por alguien de nuestro equipo: la función requiere un plan de pago de Amp. Considera esto una transcripción de las especificaciones de Amp y deja que Check Access te indique si funciona.
chat-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.
Los modelos de sistema Dictation y Realtime Voice de Amp son funciones de voz, y Kunavo no ofrece ningún modelo de voz a texto ni de texto a voz. Una conexión de URL personalizada no puede servir como endpoint para ninguno de ellos; deja esas filas asignadas a Amp.
¿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 Amp.

Paso a paso

  1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
  2. 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.
  3. Establece el formato de API en chat-completions, pega https://api.kunavo.com/v1 como URL base y tu clave sk-kn- como clave. Amp la envía como Authorization: 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.
  4. 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 escribe openai/gpt-5.6-sol y Kunavo responde a gpt-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.
  5. 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.

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 cuánto cuesta Amp y cómo afecta una conexión a la factura.

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 modeloEntrada / salida de KunavoDónde encaja en Amp
gpt-5-6-sol$2.00 / $12.00el agente principal del modo Medium y Puck — el modelo de trabajo predeterminado de Amp
gpt-6-astra$4.00 / $20.00el agente principal del modo High y el subagente Oracle en la mayoría de los modos
claude-fable-5-1$7.00 / $35.00el agente principal del modo Ultra, reservado para tareas abiertas difíciles
gpt-5-6-terra$0.70 / $4.20el subagente Search — recuperación de información del código base, donde predomina el volumen
claude-haiku-4-5$0.70 / $3.50View Media, el modelo de Amp para imágenes, PDF y vídeo — Claude lee imágenes, no vídeo
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.

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.