· reAPI Team
Together AI model not available: catálogo y acceso API
Resuelve un error Together AI model not available comprobando el ID exacto del modelo, el soporte serverless, la preparación del endpoint dedicado, el alcance del proyecto y la respuesta API.

En una incidencia histórica del proyecto Evo, una respuesta de Together notificaba model_not_available y explicaba que la solicitud intentaba usar un modelo que no era serverless. El siguiente paso sugerido era un endpoint dedicado.[1] El modelo existía. La forma en que se intentaba llamarlo era el problema descrito por esa respuesta.
Ese informe no demuestra una interrupción actual ni la disponibilidad de un modelo concreto hoy. Ilustra por qué importa el mensaje completo. Together documenta distintos conjuntos de modelos para inferencia serverless y dedicada, y un modelo dedicado sigue necesitando un despliegue utilizable.[2][3] Empieza por la solicitud que realmente envió tu aplicación, no por la ficha de modelo que esperabas que utilizara.
Copia el valor del modelo, el host y la ruta
Obtén la cadena model exacta de la solicitud que falla. Conserva su espacio de nombres, versión y sufijo de variante. Anota junto a ella el host API y la ruta de solicitud resueltos, además del estado HTTP y el cuerpo completo del error. Elimina los secretos de autenticación antes de compartir este material.
Después determina de dónde procede el valor del modelo. Un listado serverless actual, un ejemplo antiguo del SDK y una pantalla de endpoint dedicado pueden proporcionar distintos tipos de identificador. Un nombre visible familiar no los hace intercambiables.
En el flujo dedicado actual de Together, la solicitud de inferencia utiliza una cadena de endpoint con la forma project_slug/endpoint_name. El ID de modelo del catálogo identifica el modelo seleccionado para el despliegue; la cadena del endpoint identifica el recurso que atiende tus solicitudes.[3] Por tanto, una nota de configuración podría contener estos dos valores diferentes:
Model selected for deployment: <catalog-model-id>
Model value used for inference: <project-slug>/<endpoint-name>Son marcadores que muestran la distinción, no un endpoint al que puedas llamar. Rellénalos a partir del modelo y el despliegue que realmente pretendes utilizar. Copiar el primer valor en un campo que requiere el segundo no se vuelve correcto porque ambos se refieran a la misma familia de modelos.
Comprueba también la tarea. El catálogo de Together abarca chat, imagen, visión, vídeo, audio y otras operaciones, con indicaciones de endpoint para cada una.[2] Que un modelo de imagen aparezca en un listado no demuestra que pueda atender una solicitud de completado de chat. Comprueba la operación antes de cambiar las credenciales o suponer que una compra de créditos la desbloqueará.
Para serverless, utiliza el listado serverless
Si tu aplicación llama a inferencia serverless compartida, compara el ID completo con la lista actual de modelos serverless de Together. El catálogo más amplio y la lista de modelos dedicados responden a preguntas diferentes.[2] Esta es también la respuesta a «¿qué modelos están disponibles?»: la consulta debe incluir para qué tarea y modo de servicio están disponibles.
Conserva la fuente del ID en tus notas de depuración. Si procede de un tutorial escrito para otra ruta, consulta la documentación de esa ruta antes de editar el nombre del modelo por conjeturas. Si procede de un ejemplo antiguo, verifica que esa variante exacta siga ofreciéndose. Un nombre parecido puede identificar otro modelo, y una llamada correcta a ese sustituto no explica el fallo original.
Cuando se ha retirado la ruta documentada, el problema pasa del diagnóstico de configuración a la migración. Utiliza la guía de obsolescencia de Together AI para evaluar el sucesor y el plazo. Repetir el ID retirado o rotar su clave no restaura una ruta eliminada.
Si el ID exacto está en la lista actual correcta, conserva esa evidencia y continúa con la cuenta y la configuración del cliente que realiza la llamada. Ahora la pregunta es más concreta que si el proveedor tiene el modelo en absoluto.
Para inferencia dedicada, inspecciona tu propio despliegue
El flujo dedicado de Together crea un endpoint, vincula un despliegue y establece el enrutamiento. La inferencia está disponible cuando el despliegue está listo.[3] Que se admita desplegar un modelo no significa que tu proyecto ya tenga una copia lista.
Busca el endpoint previsto en el proyecto previsto. Inspecciona su estado de despliegue y la cadena exacta de inferencia que se muestra para él. Comprueba si la aplicación llama a ese endpoint, en lugar de seguir enviando el ID original del catálogo a una ruta serverless o de pasarela.
Los cambios de nombre de proyecto son algo especialmente concreto que comprobar cuando deja de funcionar una configuración que antes funcionaba. Together documenta que cambiar el slug de un proyecto modifica inmediatamente las referencias de recursos calificadas con el slug, y que el slug antiguo no redirige.[4] En ese caso, el modelo y el despliegue pueden seguir existiendo mientras la cadena de endpoint guardada apunta a un nombre obsoleto.
Antes de crear otro despliegue, inspecciona el que ya debería atender la carga de trabajo. La inferencia dedicada factura por minuto el hardware en funcionamiento, por lo que aprovisionar un endpoint adicional es una decisión de capacidad que conlleva un coste.[3] Es un mal atajo de diagnóstico cuando un nombre de endpoint que no coincide explicaría el fallo.
El precio también depende de la ruta. Los listados de chat serverless de Together utilizan tarifas por token, otras modalidades utilizan sus unidades documentadas y la inferencia dedicada utiliza su sistema de facturación de hardware.[2][3] Determina a qué servicio intenta llegar la solicitud antes de comparar un precio por token con un coste de despliegue.
El proyecto del navegador puede no ser el del worker
Together limita los recursos y las claves API al ámbito de los proyectos. Acceder a los recursos de un proyecto no demuestra automáticamente que se pueda acceder al endpoint de otro proyecto.[4] Por tanto, el proyecto visible en tu panel es solo parte de la evidencia.
Considera un worker hipotético que aún tiene configurada una clave de Project A mientras inspeccionas en el navegador un endpoint listo de Project B. La vista del panel puede ser correcta y el worker puede seguir utilizando el contexto de acceso equivocado. Comprueba el identificador seguro de las credenciales y la configuración real del proceso en lugar de pegar el secreto en un registro.
Sigue la precedencia de configuración cuando tu cliente o herramienta de despliegue ofrezca varias formas de seleccionar un proyecto. Una opción explícita, un valor de entorno y un contexto de gestión autenticado deben coincidir con el recurso previsto.[3][4] Incluye el worker que falla en esta comprobación; una llamada correcta desde tu portátil no demuestra qué cargó un proceso independiente.
Si utilizas reAPI u otro host en su lugar, utiliza los identificadores de modelo y el formato de credenciales de ese destino. La referencia de autenticación de reAPI describe sus propias credenciales; no puede activar un proyecto de Together ni hacer transferible una clave de Together.[5] Revisa juntos los cambios de host y credenciales al comparar configuraciones.
Comprueba si el SDK llama directamente a Together
La integración de Together del AI SDK documenta dos vías: AI Gateway y el proveedor directo @ai-sdk/togetherai. Según el comportamiento documentado del SDK, las cadenas de modelo sin más utilizan Gateway por defecto; el proveedor directo crea una instancia de modelo configurada para Together.[6]
Este ejemplo exclusivo de configuración compara Gateway con un proveedor directo. Los ID de marcador deben sustituirse por ID compatibles con sus respectivos catálogos; no envía solicitudes de inferencia. No es una configuración completa de endpoint dedicado: ese flujo también necesita su host de inferencia o URL base documentados y la cadena proyecto/endpoint.
import { togetherai } from '@ai-sdk/togetherai';
const gatewayOptions = {
model: 'MODEL_ID_IN_GATEWAY_CATALOG',
};
const directOptions = {
model: togetherai('MODEL_ID_IN_TOGETHER_CATALOG'),
};La configuración documentada de Gateway utiliza AI_GATEWAY_API_KEY; el proveedor directo utiliza TOGETHER_API_KEY por defecto. La disponibilidad de modelos y funciones puede diferir entre ambos.[6] Proporcionar una credencial de Together en una parte de tu entorno no demuestra que una solicitud con una cadena sin más la utilice.
La opción de orden de proveedores de Gateway es otro detalle que conviene leer con precisión. Su orden documentado expresa una preferencia y permite recurrir a alternativas; no restringe todas las solicitudes al proveedor nombrado.[6] Por tanto, una solicitud correcta de Gateway no demuestra por sí sola que tu proyecto directo de Together pueda servir el modelo.
Comprueba la versión instalada del SDK y los ajustes de conexión resueltos frente a la documentación. Un cliente puede aplicar una URL base u otro valor predeterminado que no aparezca junto al nombre del modelo en tu propio código. Compara la solicitud construida antes de sustituir paquetes o editar lógica de la aplicación que no esté relacionada.
Reduce la solicitud de diagnóstico a la operación documentada y los campos obligatorios, manteniendo fijos el host, la cuenta y el modelo previstos. Después compárala con la solicitud de la aplicación. Si funciona la forma mínima pero falla la completa, restaura las funciones opcionales una a una para que la diferencia siga siendo visible. Si ambas fallan con el mismo mensaje de disponibilidad, cambiar el prompt difícilmente explicará una discrepancia de ruta. Cualquier inferencia que decidas ejecutar para esa comparación puede generar cargos; mantenla dentro de tu presupuesto habitual aprobado para pruebas en lugar de introducir una solicitud sin resolver en un bucle automático de reintentos.
Para una tarea de imagen, embeddings o reordenación, comprueba también que utilizas la factoría de proveedor y la operación correspondientes documentadas por el SDK.[6] Una cadena de modelo enviada a través de la operación equivocada sigue siendo una solicitud incorrecta, aunque su escritura coincida con el catálogo.
Deja que el error restante determine el siguiente cambio
Una vez que coincidan la ruta y quien realiza la llamada, lee el error real en lugar de seguir interpretando cada rechazo como falta de soporte del modelo. La referencia de Together distingue fallos de autenticación, interrupciones por financiación, acceso restringido, URL o nombres de modelo inválidos, limitaciones e indisponibilidad temporal del servicio.[7]
Un 401 apunta a la autenticación. Un 402 puede indicar un corte por gasto o un requisito de crédito positivo. Un 403 requiere consultar el motivo de acceso indicado. Un 429 necesita su contexto de operación: una limitación serverless y una solicitud de gestión dedicada que supera la cuota de GPU son casos diferentes. La respuesta histórica de Evo también muestra por qué no se debe codificar de forma fija que model_not_available siempre llega con 404.[7][1]
No utilices un listado del catálogo como prueba de acceso alojado gratuito. La política de créditos de Together revisada el 16 de noviembre de 2026 indica que no hay prueba gratuita, exige una compra inicial de al menos 15 US$ y señala que los créditos gratuitos no satisfacen ese mínimo. Mantener el acceso de prepago requiere un saldo positivo; los contratos Scale y Enterprise activos tienen sus propias condiciones.[8] Estas condiciones son distintas de un ID de modelo o una ruta incorrectos. Volver a pagar no puede corregir ninguna de las dos cadenas.
Si la configuración y la disponibilidad documentada siguen contradiciendo la respuesta, envía al soporte esa contradicción precisa: el ID o endpoint exactos, host y ruta, proyecto previsto, marca de tiempo, versión del SDK, estado HTTP y error completo sin datos sensibles. Incluye un ID de solicitud devuelto si está disponible. Indica qué listado actual o despliegue listo comprobaste. Esto permite al soporte investigar la solicitud que falló, en lugar de intentar deducirla a partir de una captura de una ficha de modelo.
Referencias
- Proyecto Evo, incidencia 95 de GitHub, modelo no disponible en api.together.ai, incluidas las respuestas. Informe histórico revisado el 15 de noviembre de 2026.
- Together AI, Modelos disponibles: catálogo serverless, tipos de tarea y distinción de modelos dedicados. Revisado el 15 de noviembre de 2026.
- Together AI, Descripción general de la inferencia de modelos dedicados: selección de proyecto, preparación, cadenas de endpoint y facturación de hardware. Revisado el 15 de noviembre de 2026.
- Together AI, Proyectos: límites de recursos, claves API de proyecto y cambios de slug. Revisado el 15 de noviembre de 2026.
- reAPI, Autenticación. Revisado el 15 de noviembre de 2026. Las URL de fuentes externas y las capturas completas se conservan en el archivo de investigación.
- AI SDK, Proveedor Together.ai: configuración de Gateway y del proveedor directo. Revisado el 15 de noviembre de 2026.
- Together AI, Códigos de error. Revisado el 15 de noviembre de 2026.
- Together AI, Créditos: política de prueba gratuita, requisito de compra inicial y excepciones contractuales. Revisado el 16 de noviembre de 2026.