- Cuándo usar este inicio rápido
- Paso 1: Obtén tu clave de API de Novita
- Paso 2: Confirma el ID del modelo y el endpoint
- Paso 3: Envía tu primera solicitud
- Paso 4: Lee la respuesta
- Paso 5: Verifica precios, límites y errores comunes
- Ejemplo en Python
- Ejemplo en cURL
- Parámetros clave
- Indicaciones para codificación, agentes y GenUI
- Solución de problemas
- Preguntas frecuentes
- Artículos recomendados
Macaron V1 Venti está disponible en Novita AI a través de la API de completaciones de chat compatible con OpenAI. Úsalo cuando necesites una ventana de contexto muy grande para codificación, bucles de agentes o indicaciones de GenUI, y comienza con una solicitud pequeña solo de texto antes de expandirte a flujos de trabajo más largos.
Para una visión general más amplia del modelo, consulta Macaron V1 Venti en Novita AI.
Cuándo usar este inicio rápido
Usa esta guía cuando tu carga de trabajo necesite contexto largo, uso de herramientas o generación de interfaz de usuario nativa en código, en lugar de respuestas cortas de chat. La página del modelo de Macaron V1 Venti en Novita enumera acceso serverless, llamada a funciones y razonamiento, con entrada de texto y salida de texto.
Paso 1: Obtén tu clave de API de Novita
Crea una clave de API de Novita y mantenla en el lado del servidor.
export NOVITA_API_KEY="tu_clave_api_aqui"
Paso 2: Confirma el ID del modelo y el endpoint
| Campo | Valor |
|---|---|
| ID del modelo | mindai/macaron-v1-venti |
| URL base | https://api.novita.ai/openai/v1 |
| Endpoint de completaciones de chat | https://api.novita.ai/openai/v1/chat/completions |
| Ventana de contexto | 1,048,576 tokens |
| Máximo de tokens de salida | 131,072 |
| Entrada | Texto |
| Salida | Texto |
| Características | API serverless, llamada a funciones, razonamiento |
| Nivel de límite de velocidad mostrado | T1: 30 RPM, 50,000,000 TPM |
En el momento de la verificación el 28 de julio de 2026, Novita mostraba Macaron V1 Venti como gratuito por tiempo limitado con precios de $0 entrada y $0 salida. Verifica la página del modelo en vivo antes de presupuestar su uso en producción.
Paso 3: Envía tu primera solicitud
Comienza con una indicación corta solo de texto para verificar autenticación, enrutamiento y análisis.
Resume los principales riesgos en una refactorización de todo el repositorio en 5 viñetas.
Paso 4: Lee la respuesta
Para completaciones de chat estándar, lee la respuesta de choices[0].message.content. Mantén los metadatos de la solicitud, el uso de tokens y el estado HTTP en tus registros para poder rastrear llamadas lentas o costosas más adelante.
Paso 5: Verifica precios, límites y errores comunes
La lista actual es más importante que una publicación de blog desactualizada. Vuelve a verificar la página del modelo antes del lanzamiento si dependes de precios gratuitos, un nivel de tarifa específico o la ventana completa de 1M de contexto.
Los errores comunes de configuración incluyen:
- Usar el nombre mostrado en lugar de
mindai/macaron-v1-venti. - Apuntar el SDK a la URL base incorrecta.
- Enviar una indicación enorme antes de confirmar la conectividad básica.
- Asumir que cada solicitud de contexto largo debe usar el límite máximo de salida.
Ejemplo en Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NOVITA_API_KEY"],
base_url="https://api.novita.ai/openai/v1",
)
response = client.chat.completions.create(
model="mindai/macaron-v1-venti",
messages=[
{"role": "system", "content": "Eres un asistente de codificación conciso."},
{"role": "user", "content": "Enumera los primeros pasos más seguros para refactorizar un monorepo grande."},
],
temperature=0.2,
max_tokens=400,
)
print(response.choices[0].message.content)
Ejemplo en cURL
curl "https://api.novita.ai/openai/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${NOVITA_API_KEY}" \
-d '{
"model": "mindai/macaron-v1-venti",
"messages": [
{
"role": "system",
"content": "Eres un asistente de codificación conciso."
},
{
"role": "user",
"content": "Enumera los primeros pasos más seguros para refactorizar un monorepo grande."
}
],
"temperature": 0.2,
"max_tokens": 400
}'
Parámetros clave
| Parámetro | Empieza con | Por qué es importante |
|---|---|---|
model |
mindai/macaron-v1-venti |
Selecciona el modelo alojado |
messages |
Indicación corta de sistema + usuario | Verifica rápidamente la ruta de la API |
temperature |
0.2 |
Mantiene estable la salida de prueba |
max_tokens |
400 |
Evita respuestas iniciales demasiado grandes |
tools |
Una función a la vez | Útil para agentes y flujos de trabajo |
response_format |
Solo si tu analizador está listo | Valida JSON antes de enviar |
Indicaciones para codificación, agentes y GenUI
Codificación
Usa Macaron V1 Venti para refactorizaciones conscientes del repositorio, planes de migración o resúmenes de revisión de código cuando el contexto circundante sea importante.
Revisa este módulo en busca de riesgos de migración, identifica cambios disruptivos y sugiere el plan de parche más pequeño y seguro.
Agentes
Usa la llamada a funciones cuando el modelo deba elegir una herramienta en lugar de responder directamente.
Llama a la herramienta de búsqueda de tickets solo si el usuario hace referencia a un ID de incidencia existente. De lo contrario, responde con un plan breve.
GenUI
Úsalo para generación de interfaz cuando quieras ideas de UI estructuradas a partir de un resumen de producto.
Convierte este resumen de producto en un diseño de panel limpio con secciones, acciones, estados vacíos y reglas de validación.
Solución de problemas
La API devuelve un error de autenticación
Confirma que el token de portador está configurado en el mismo shell o entorno de ejecución que realiza la solicitud.
No se puede encontrar el modelo
Vuelve a verificar el ID del modelo: mindai/macaron-v1-venti.
La solicitud es demasiado grande
Empieza más pequeño, luego agrega contexto gradualmente. Una ventana de 1M de tokens es capacidad, no una señal para enviar todo de una vez.
Preguntas frecuentes
¿Está Macaron V1 Venti disponible en Novita AI?
Sí. La página del modelo en vivo lo lista como un modelo serverless.
¿Qué endpoint debo usar?
Usa https://api.novita.ai/openai/v1/chat/completions.
¿Soporta el uso de herramientas?
Sí. Novita lista la llamada a funciones como una característica del modelo.
¿El modelo es gratuito ahora mismo?
La lista verificada el 28 de julio de 2026 mostraba precios de $0 entrada y $0 salida, marcado como gratuito por tiempo limitado.
Artículos recomendados
- Macaron V1 Venti en Novita AI: buque insignia 748B Mixture-of-LoRA para codificación, agentes y GenUI
- Cómo usar Codex con modelos de Novita AI: guía de configuración completa
- Cómo usar la llamada a funciones de DeepSeek V3
Fuentes verificadas el 28 de julio de 2026: Página del modelo Macaron V1 Venti, Referencia de la API de completaciones de chat de Novita
