API de mistral ai: Guía de inicio rápido

URL Base y Autenticación

El primer paso es configurar tu cliente para que apunte a nuestra infraestructura. Reemplaza la URL base estándar de OpenAI con HTTPS://api.apimistralai.com/v1 e inyecta tu clave de API única en el encabezado de autorización. Este simple cambio redirige todas las solicitudes a nuestro modelo sin censura mientras mantiene intacta la lógica de integración existente.

• URL Base: HTTPS://api.apimistralai.com/v1
• Autenticación: Token Bearer a través del Authorization cabecera

Asegúrate de que tu clave esté activa en el panel de control de tu cuenta antes de probar las conexiones.

Primera solicitud

Envía una solicitud estándar de finalización de chat para verificar la conectividad y la respuesta del modelo. Lo siguiente curl el objetivo del comando es uncensored el modelo con una indicación básica.

Esto confirma que el punto de conexión es accesible y devuelve texto sin los filtros de contenido estándar.

Copycurl https://api.apimistralai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix syntax error in python list comprehension"}]
  }'

Si la respuesta contiene texto, tu integración se está enrutando correctamente a través de nuestra capa de inferencia uncensored.

Integración del SDK de Python

Utiliza la biblioteca oficial de Python de OpenAI para interactuar con nuestra API sin modificar la estructura de solicitud principal. Inicializa el cliente con la nueva URL base y tu clave de API, luego llama a chat.completions.create.

Este enfoque te permite conservar toda la lógica existente de Python mientras obtienes acceso a las capacidades del modelo sin censura.

Copyfrom openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

El objeto de respuesta se comporta de manera idéntica a las respuestas estándar de OpenAI, lo que facilita la migración para desarrolladores de Python.

Integración del SDK Node

Para entornos JavaScript o TypeScript, inicializa el paquete OpenAI con la URL base personalizada. Establece el apiKey y baseURL propiedades antes de llamar chat.completions.create.

Esto garantiza que tus aplicaciones Node.js enruten las solicitudes a nuestro endpoint uncensored manteniendo la compatibilidad con los patrones estándar de SDK.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apimistralai.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

La estructura de la respuesta permanece coherente con los estándares de OpenAI, lo que permite una integración fácil en los flujos de trabajo existentes de Node.js.

Respuestas en streaming vía SSE

Habilita la generación de tokens en tiempo real estableciendo stream: true en tu solicitud. La API devuelve un flujo de Eventos Enviados por el Servidor (SSE), lo que te permite procesar los tokens a medida que se generan.

Esto reduce la latencia percibida para los usuarios y proporciona retroalimentación inmediata durante las completaciones largas.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Analiza el flujo de datos SSE para mostrar los tokens de forma incremental. El fragmento final contiene el uso total de tokens para la solicitud.

Límites, Errores y Contexto

Monitorea tu uso contra límites estrictos de velocidad y maneja los errores HTTP comunes de forma elegante. Tienes permitido 300 solicitudes por minuto y 8 solicitudes concurrentes por clave.

Un error 401 indica una clave API no válida o faltante, mientras que un error 402 significa que tu crédito prepagado se ha agotado. Un estado 429 indica que has superado el límite de 300 solicitudes por minuto.

Tu ventana de contexto soporta 100.000 tokens en total, con una salida máxima de 16.000 tokens por solicitud. Los errores y rechazos no consumen crédito, asegurando que solo pagues por el contenido real generado.