ES ▾
mistralapikey.com

Alternativa a la API de Mistral sin censura

Obtener clave de API
URL base
https://api.mistralapikey.com/v1
Modelo
sin censura

API de Mistral en Python con el SDK de OpenAI

Un script de API de Mistral en Python puede ejecutarse contra este endpoint compatible con OpenAI con el paquete estándar openai: establece la URL base, pasa tu clave y usa el modelo uncensored. Esta guía incluye el código para chat, streaming, JSON, herramientas y lotes.

Actualizado

Una cinta de luz que se entrelaza entre bloques de código de vidrio hacia una puerta de enlace, representando Python llamando a una API

La versión corta

Para usar un flujo de trabajo de API de Mistral en Python con este servicio, no necesitas la biblioteca de cliente propia de Mistral. Este endpoint admite el formato de OpenAI chat completions, por lo que el paquete openai estándar funciona: instálalo, establece la URL base en https://api.mistralapikey.com/v1, pasa tu clave y usa el ID de modelo uncensored.

Una nota necesaria: esta no es la API oficial de Mistral y no está afiliada a Mistral. Es un servicio independiente con un único modelo de pesos abiertos, gestionado por un proveedor independiente y ajustado para responder sin rechazos de contenido para uso adulto lícito. La página sobre la clave de API de Mistral explica cómo se relacionan las claves aquí con otros servicios.

pip install openai
from openai import OpenAI

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

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a haiku about retries."}],
)
print(r.choices[0].message.content)

Traduce código estilo Mistral línea por línea

Si tienes código escrito para el cliente de Python de Mistral, el mapeo es breve. Verifica los nombres exactos contra la documentación propia del cliente para la versión que tienes instalada, ya que las bibliotecas cambian.

Cliente estilo MistralSDK de OpenAI contra este endpoint
Mistral(api_key=key)OpenAI(base_url=URL, api_key=key)
client.chat.complete(...)client.chat.completions.create(...)
client.chat.stream(...)client.chat.completions.create(..., stream=True)
model="some-model-name"model="uncensored"
res.choices[0].message.contentr.choices[0].message.content (igual)

Los mensajes permanecen como una lista de diccionarios con role y content. La forma de respuesta para los campos comunes, incluidos choices, usage y finish_reason, también es la misma, por lo que el código que solo lee esos campos no necesita cambios.

Lado a lado, el cambio se ve así:

# before (Mistral-style)
# from mistralai import Mistral
# client = Mistral(api_key=KEY)
# res = client.chat.complete(model="...", messages=msgs)

# after
from openai import OpenAI
client = OpenAI(base_url="https://api.mistralapikey.com/v1", api_key=KEY)
res = client.chat.completions.create(model="uncensored", messages=msgs)
text = res.choices[0].message.content

Mantén la clave fuera del código

Lee la clave y la URL del entorno y manténlas fuera del control de versiones.

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.environ.get("LLM_BASE_URL", "https://api.mistralapikey.com/v1"),
    api_key=os.environ["LLM_API_KEY"],
)

Con un shell: export LLM_API_KEY=.... El SDK de OpenAI también lee OPENAI_API_KEY y OPENAI_BASE_URL cuando no se los pasas explícitamente, lo cual es útil para herramientas que crean el cliente por ti, pero también es una fuente clásica de errores de "clave incorrecta" cuando un valor antiguo se queda en el shell. Cuando algo falla con 401, imprime qué variables están configuradas antes de hacer cualquier otra cosa.

Obtén una clave en la página de clave de API. Las cuentas nuevas pueden reclamar $0,50 de crédito de prueba con un clic. No requiere tarjeta, es válido por 7 días y está limitado a uno por persona.

Streaming, JSON y herramientas

El streaming devuelve tokens a medida que se generan. Establece stream=True e itera. Los datos de uso llegan al final.

stream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Explain list comprehensions in 3 sentences."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

El modo JSON solicita un objeto JSON válido. Di la palabra JSON en tu prompt también y siempre analiza de forma defensiva.

import json

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Return JSON with keys name and tags for a blog post about retries."}],
    response_format={"type": "json_object"},
)
data = json.loads(r.choices[0].message.content)

Las llamadas a funciones usan los parámetros tools y tool_choice. Cuando el modelo devuelve tool_calls, ejecuta la función y envía el resultado de vuelta como un mensaje con role: "tool" y el tool_call_id correspondiente.

tools = [{
    "type": "function",
    "function": {
        "name": "get_weather",
        "description": "Get weather for a city",
        "parameters": {
            "type": "object",
            "properties": {"city": {"type": "string"}},
            "required": ["city"],
        },
    },
}]

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Weather in Oslo?"}],
    tools=tools,
)
print(r.choices[0].message.tool_calls)

Llamadas asíncronas y paralelas

Para lotes, usa el cliente asíncrono. Mantén el número de peticiones en vuelo por debajo del límite: una clave completa permite 8 peticiones concurrentes y 300 por minuto, una clave de prueba 2 y 60.

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI(base_url="https://api.mistralapikey.com/v1", api_key="YOUR_KEY")
sem = asyncio.Semaphore(6)

async def one(prompt):
    async with sem:
        r = await client.chat.completions.create(
            model="uncensored",
            messages=[{"role": "user", "content": prompt}],
            max_tokens=200,
        )
        return r.choices[0].message.content

async def main():
    prompts = [f"Give a one-line tip number {i} about Python." for i in range(20)]
    results = await asyncio.gather(*(one(p) for p in prompts))
    print(len(results))

asyncio.run(main())

El semáforo de 6 deja margen por debajo de 8. Sin él, 20 llamadas simultáneas alcanzarían HTTP 429 con el código concurrency. Recuerda que los streams mantienen su espacio hasta que terminan.

Puntos débiles al migrar

La mayoría de los problemas provienen de suposiciones heredadas de la configuración antigua en lugar de del nuevo endpoint.

  • Nombres de modelo codificados. Busca en tu código la cadena del modelo antiguo. El único ID de modelo válido aquí es uncensored, y puedes confirmarlo con client.models.list().
  • Prompts escritos para otro modelo. Un modelo diferente interpreta las instrucciones ligeramente de otra manera. Si un prompt del sistema dependía de una frase específica, pruébalo. Las instrucciones cortas y directas con un ejemplo del formato de salida suelen transferirse mejor.
  • Parámetros específicos del proveedor. Los parámetros que solo existen en el cliente de un proveedor pueden ignorarse o rechazarse. Mantente con los estándar: temperature, top_p, stop, seed, max_tokens y las penalizaciones se pasan a través.
  • Marcadores estilo modo seguro. Si tu código antiguo activaba la moderación o la opción de seguridad de un proveedor, no hay un interruptor equivalente aquí. Si tu producto necesita filtrado, añádelo en tu lado antes y después de la llamada.
  • Estimaciones de tokens. Los diferentes modelos cuentan los tokens de forma diferente, así que presupuesta desde el campo usage que devuelve la API, no desde una suposición local.

Planifica una pasada de prueba breve, no una reescritura. Toma diez prompts de tus registros, ejecútalos a través del nuevo cliente, lee las respuestas y ajusta el prompt de sistema hasta que el tono coincida con lo que deseas.

Errores y lo que significan

  • 401. Clave incorrecta o faltante, o una clave de otro servicio.
  • 404. La URL base no incluye /v1.
  • 429 con rate_limited. Más del límite por minuto. Espera y reduce la velocidad.
  • 429 con concurrency. Demasiadas peticiones a la vez. Reduce tu paralelismo.
  • 429 con Retry-After: 5. Sobrecarga temporal. Espera cinco segundos y vuelve a intentarlo.
import time
from openai import RateLimitError

def safe(prompt):
    for _ in range(4):
        try:
            r = client.chat.completions.create(
                model="uncensored",
                messages=[{"role": "user", "content": prompt}],
            )
            return r.choices[0].message.content
        except RateLimitError:
            time.sleep(5)
    return None

Guarda la cabecera X-Request-Id de las llamadas que fallan. Las peticiones fallidas o rechazadas no se cobran.

Coste, límites y lo que no está incluido

La facturación es de pago por uso: $0,15 por cada 1M de tokens de entrada y $0,50 por cada 1M de tokens de salida, con crédito prepago, sin suscripción y sin caducidad. Un script que envía 1.000 peticiones de 1.500 tokens de entrada y 400 tokens de salida cuesta 1.5M x $0,15 = $0,225 más 0.4M x $0,50 = $0,20, es decir, $0,425. Las recargas van desde $20 hasta $500, con un bono a partir de $50, y la página de precios detalla las condiciones.

La ventana de contexto es de 100.000 tokens, prompt más completación, y el cuerpo puede tener hasta 8 MB. El servicio es solo texto: sin imágenes, audio o vídeo, sin embeddings ni fine-tuning, y el contenido sexual que involucre a menores de edad nunca está permitido. Si también quieres la misma API con otros clientes, el artículo sobre la API de chat compatible con OpenAI cubre aplicaciones más allá de Python, y la documentación lista cada parámetro.

Preguntas y respuestas

¿Necesito el cliente de Python de Mistral?

No. El paquete estándar de openai funciona con la URL base https://api.mistralapikey.com/v1. Las llamadas al estilo de Mistral se mapean a chat.completions.create.

¿Es esta la API oficial de Mistral?

No. Es un servicio independiente con un único modelo de pesos abiertos gestionado por un proveedor independiente, no afiliado a Mistral.

¿Cómo evito los errores 429 en lotes?

Limita las llamadas paralelas por debajo de 8 con un semáforo, mantente por debajo de 300 peticiones por minuto y espera tras una respuesta 429.

¿Hay una forma gratuita de probarlo?

Sí. Tras iniciar sesión puedes reclamar $0,50 de crédito de prueba en la página de clave de API. No necesita tarjeta y es válido durante 7 días.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.