Capa gratuita de la API de Mistral: límites y alternativa prepago

Qué esperar de la capa gratuita de la API de Mistral

La mayoría de las personas que buscan la capa gratuita de la API de Mistral quieren saber tres cosas: cuántas peticiones obtienen, qué modelos están incluidos y qué sucede cuando superan sus límites. Mistral decide las tres cosas, y los números son del tipo que se ajustan, por lo que cualquier cifra copiada en un artículo como este se quedaría obsoleta pronto. Abre su documentación y las páginas de facturación y lee los límites actuales directamente.

Lo que puedes predecir es la estructura. Las asignaciones gratuitas en la industria tienden a compartir algunas características: límites de peticiones más bajos que los planes pagados, un tope de tokens o peticiones por período, términos sobre cómo se pueden usar los prompts y ninguna promesa de capacidad durante las horas pico. Nada de esto es una crítica. Una capa gratuita es una herramienta de marketing y pruebas, y funciona bien para ese propósito.

Se convierte en un problema cuando un prototipo se convierte silenciosamente en un producto. El día que tu aplicación tenga usuarios reales, querrás límites predecibles, un saldo que puedas ver y una respuesta a la pregunta "¿qué sucede si el modelo rechaza una solicitud perfectamente legal?" El resto de esta página cubre cómo planear para ese momento.

Una lista de verificación para leer los términos de cualquier capa gratuita

Antes de construir algo sobre una asignación gratuita, responde estas preguntas desde las páginas del proveedor. Escribe las respuestas con la fecha, porque cambian.

1. ¿Cuál es el límite de peticiones? Busca peticiones por minuto, tokens por minuto y cualquier tope mensual, como números separados.
2. ¿Qué modelos están cubiertos? El acceso gratuito a veces se aplica solo a algunos modelos.
3. ¿Se pueden usar los datos para entrenamiento? El uso gratuito en algunos servicios viene con términos de datos diferentes al uso pagado. Lee la sección de privacidad, no la de precios.
4. ¿Se permite el uso comercial? Algunos planes gratuitos son solo para evaluación.
5. ¿Cuál es la ruta de actualización? Averigua cuánto cuesta una cuenta pagada y si los límites aumentan inmediatamente.
6. ¿Cuáles son las reglas de contenido? Si tu caso de uso es ficción, roleplay u otra escritura para adultos que sea legal, verifica cómo lo maneja el modelo antes de invertir tiempo en prompts.

El último elemento es la razón por la que muchas personas terminan en un servicio diferente. Un modelo con rechazos integrados puede pasar tus primeras diez pruebas de prompts y luego rechazar el undécimo, y una capa gratuita te da poco margen para experimentar alrededor de eso.

La prueba aquí, en números

Esta API es independiente de Mistral y ofrece una pequeña prueba en lugar de una capa gratuita permanente. Los nuevos usuarios se registran con Google o con un correo electrónico y contraseña, luego hacen clic una vez en la página de clave de API para reclamar $0,50 de crédito. No hay paso de tarjeta. Es válido durante 7 días y está limitado a uno por persona.

La clave de prueba funciona con límites más bajos que una financiada: 2 peticiones simultáneas y 60 peticiones por minuto. Eso es suficiente para probar un script, un cliente de chat estilo SillyTavern o un trabajo por lotes pequeño, y no es suficiente para una aplicación pública.

Qué compra $0,50

Los precios de los tokens son $0,15 por 1M de entrada y $0,50 por 1M de salida. Algunos presupuestos concretos:

• Solo entrada, sin salida: $0,50 / $0,15 por 1M son aproximadamente 3,33M tokens de prompt.
• Solo salida: $0,50 / $0,50 por 1M son exactamente 1M tokens de texto generado.
• Una solicitud pequeña típica de 1.000 tokens de entrada y 300 de salida cuesta 0,00015 + 0,00015 = $0,0003. Así que $0,50 cubre aproximadamente 1.666 de ellas.
• Una solicitud de documento largo de 20.000 tokens de entrada y 1.000 de salida cuesta 0,003 + 0,0005 = $0,0035, así que aproximadamente 142 de ellas.

En la práctica, eso es suficiente para ejecutar unos cientos de prompts reales de tu propio caso de uso, que es exactamente lo que necesita una evaluación. Si las respuestas no son las que deseas, has perdido 50 centavos y nunca se registró ninguna tarjeta. Ten en cuenta que los pagos se realizan exclusivamente mediante criptomonedas.

Pasar de la prueba a producción

Cuando la prueba funciona, el paso superior es una recarga prepago de cualquier cantidad entera desde $20 hasta $500. No hay suscripción y el crédito no caduca, así que recargar el mínimo y dejarlo solo durante un mes no cuesta nada extra. Las cantidades mayores añaden un bono: +5% desde $50, +10% desde $100, +15% desde $200. Una recarga de $200 te da por lo tanto $230 de crédito.

Una clave financiada eleva los límites a 8 peticiones simultáneas y 300 peticiones por minuto. Con el tamaño de solicitud pequeño anterior ($0,0003 cada una), una recarga de $20 cubre aproximadamente 66.000 peticiones: 20 / 0,0003 son 66.666. Para la lista de tarifas completa, consulta la página de precios. Nota: ya no aceptamos tarjetas; los pagos son solo por cripto (USDT en TRC20, USDC en Base).

El pago se realiza con cripto (USDT en TRC20, USDC en Base).

La diferencia que sentirás más es la predictibilidad. En lugar de preguntarte si una asignación gratuita compartida está limitada hoy, tienes un saldo en dólares, un encabezado en cada respuesta que lo muestra, y dos límites documentados. Una solicitud fallida o rechazada no se factura, así que un mal día en el lado del servidor no consume tu crédito.

Código: ejecuta la prueba y observa el saldo

La API sigue el formato de chat de OpenAI, así que tu SDK existente funciona con una nueva URL base y clave. Este script envía una solicitud, imprime la respuesta y lee el saldo restante del encabezado X-Balance-USD.

Copyfrom openai import OpenAI

client = OpenAI(
    base_url="https://api.mistralapi.com/v1",
    api_key="YOUR_API_KEY",
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Give me three names for a fantasy tavern."}],
    max_tokens=200,
)
resp = raw.parse()

print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)
print("balance left: $", raw.headers.get("X-Balance-USD"))

Ejecútalo unas cuantas veces y verás cómo el saldo se mueve por fracciones de centavo. Esa es la mejor manera de desarrollar una sensación de cuánto cuestan realmente tus prompts antes de comprometerte con una recarga. Si quieres lo mismo desde la shell:

Copycurl -i https://api.mistralapi.com/v1/chat/completions   -H "Authorization: Bearer YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello."}],"max_tokens":20}'

La bandera -i imprime los encabezados de respuesta, incluyendo X-Request-Id, X-Balance-USD y los dos encabezados X-RateLimit-Limit. Guarda el ID de solicitud si alguna vez contactas a soporte.

Gestión de límites de peticiones sin perder peticiones

Los límites existen en todos los planes, gratuitos o pagados, así que escribe la lógica de reintento una vez. Esta API responde con HTTP 429 en tres situaciones. El código de error rate_limited significa que excediste las peticiones por minuto. El código concurrency significa que había demasiadas peticiones en curso al mismo tiempo. Un 429 con un encabezado Retry-After: 5 significa sobrecarga temporal. En los tres casos, la respuesta correcta es esperar y enviar la solicitud nuevamente.

Copyimport time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.mistralapi.com/v1", api_key="YOUR_API_KEY")

def ask(prompt, tries=5):
    for attempt in range(tries):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5 * (attempt + 1))
    raise RuntimeError("still rate limited after retries")

En la clave de prueba, mantén tu grupo de trabajadores en dos o menos. Una solicitud en streaming mantiene su espacio de concurrencia hasta que finalice el streaming, así que dos streams largos pueden bloquear una tercera solicitud incluso si estás muy por debajo de 60 por minuto.

Un plan de evaluación realista para la prueba

Medio dólar recorre un largo camino si lo gastas en las pruebas adecuadas. Un plan que funciona bien:

1. Recopila 100 a 200 prompts reales. Usa mensajes de usuario reales, tickets de soporte o inicios de historia de tu proyecto, no ejemplos inventados. Incluye los incómodos que otro modelo podría rechazar.
2. Ejecútalos una vez con ajustes fijos. Usa una temperatura baja para que estés juzgando el modelo y no los dados.
3. Lee una muestra a mano. Veinte respuestas son suficientes para detectar un patrón. Anota cualquiera que no enviarías.
4. Mide los tokens. Promedia los conteos de prompt y finalización de usage.
5. Proyecta la factura mensual. Multiplica el costo por solicitud por tu volumen esperado.

Para dimensionar: 200 prompts de 800 tokens de entrada y 400 de salida usan 160.000 tokens de entrada (0,024 dólares) y 80.000 tokens de salida (0,04 dólares), por lo que una pasada completa cuesta $0,064. Podrías ejecutar ese conjunto de pruebas unas siete veces con un crédito de prueba de $0,50, y la validez de 7 días rara vez es el límite. Cambiar el prompt del sistema entre pasadas es el ajuste más barato que harás.

Detén la prueba pronto si las respuestas no son lo suficientemente buenas para tu tarea. No hay renovación y no se introdujo ninguna tarjeta, así que no hay nada que cancelar.

Qué ruta se adapta a ti

Usa un plan gratuito cuando estés verificando si un modelo es lo suficientemente capaz, cuando estés escribiendo un tutorial o cuando el volumen sea de un puñado de peticiones al día. Usa una clave prepago cuando otras personas dependan del resultado, cuando necesites conocer tus límites con antelación o cuando tu caso de uso esté en un punto donde un modelo más estricto podría rechazar. La guía de inicio rápido cubre el cambio en unas pocas líneas si vienes de una integración existente con Mistral.

Ten una regla en mente sin importar lo que elijas: el servicio no genera contenido sexual que involucre a menores de edad, y ninguna capa ni configuración cambia eso.

Más guías

• Precios de la API de Mistral AI frente a una API de pago por token sin censura
• Mistral API sin censura: pago por token