Inicio rápido para usuarios de Mistral

URL base y autenticación

Nuestra API es totalmente compatible con los SDK de OpenAI. Solo necesitas actualizar la URL base y proporcionar tu clave de API. La URL base para este servicio es https://api.mistralapi.com/v1. La autenticación se maneja mediante la cabecera Authorization usando un token Bearer. A diferencia de algunos proveedores, no requerimos enrutamiento complejo ni cabeceras específicas del proveedor; solo pasa tu clave como lo harías normalmente.

• URL base: https://api.mistralapi.com/v1
• Encabezado: Authorization: Bearer YOUR_API_KEY

Tu clave de API se genera inmediatamente al registrarte. Mantenla segura, ya que otorga acceso a tu crédito prepago. No hay cuotas de suscripción mensuales, solo precios de pago por uso basados en el uso de tokens.

Endpoint de Chat Completions

El núcleo de nuestra API es el endpoint POST /v1/chat/completions. Acepta una lista de mensajes y devuelve una respuesta generada. Este endpoint admite el formato de mensaje estándar utilizado por la mayoría de clientes LLM. Debes especificar el ID del modelo como "uncensored". Este modelo es un modelo de lenguaje grande de pesos abiertos alojado en nuestros servidores, ajustado para responder sin rechazos de contenido para uso adulto legal.

• Endpoint: POST /v1/chat/completions
• ID del modelo: uncensored

La API devuelve solo respuestas de texto. No admite imágenes, audio, video ni embeddings. Para la mayoría de desarrolladores, este endpoint reemplaza el endpoint de chat estándar de OpenAI sin cambios de código más allá de la URL base y el ID del modelo.

Integración con SDK de Python

Usar la biblioteca oficial de Python de OpenAI es la forma más rápida de integrar. Establece la URL base en nuestro endpoint y proporciona tu clave de API. El siguiente código muestra una petición de completado de texto simple.

• Instala la biblioteca: pip install openai
• Establece base_url en https://api.mistralapi.com/v1
• Usa model="uncensored"

Este enfoque funciona porque nuestra API replica la estructura de respuesta de OpenAI. Puedes usar bibliotecas existentes para streaming, llamadas a funciones y modo JSON sin modificaciones.

Integración con SDK de Node.js

Para desarrolladores de JavaScript/TypeScript, el paquete npm openai funciona perfectamente. Configura el cliente con nuestra URL base y tu clave de API. Esto te permite usar la misma base de código tanto para OpenAI como para nuestro modelo sin censura.

• Instala la biblioteca: npm install openai
• Configura baseUrl en https://api.mistralapi.com/v1
• Especifica model: "uncensored"

Esta compatibilidad se extiende a todos los parámetros estándar como temperature, top_p y las secuencias stop. Puedes cambiar entre proveedores fácilmente modificando la configuración del cliente.

Respuestas en streaming

Admitimos respuestas en streaming mediante Server-Sent Events (SSE). Esto te permite recibir tokens a medida que se generan, reduciendo la latencia percibida para los usuarios. El último fragmento del stream incluye las estadísticas de uso de tokens para facturación.

• Establece stream: true en tu petición
• Lee fragmentos de la respuesta
• Analiza el último fragmento para obtener datos de uso

El streaming es ideal para interfaces de chat y aplicaciones en tiempo real. El formato de respuesta coincide con el estándar de streaming de OpenAI, por lo que tu lógica de streaming existente funcionará sin cambios.

Límites, errores y ventana de contexto

Nuestra API tiene límites específicos para garantizar la estabilidad. Cada clave de API admite 300 peticiones por minuto y 8 peticiones simultáneas. El tamaño máximo del cuerpo de la petición es de 8 MB. La ventana de contexto es de 100 000 tokens en total (prompt + completion). Si no estableces max_tokens, la salida predeterminada es de 2 048 tokens; de lo contrario, la salida máxima es de 32 000 tokens.

• 401: Clave de API no válida
• 402: Crédito insuficiente
• 429: Límite de peticiones excedido

El crédito premium no caduca. Los errores y rechazos son gratuitos. Si encuentras problemas, usa la página de Soporte para reembolsos o ayuda con la cuenta.

cURL

Copiarcurl https://api.mistralapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copiarfrom openai import OpenAI

client = OpenAI(base_url="https://api.mistralapi.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)

Node.js

Copiarimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.mistralapi.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);

Streaming

Copiarstream = 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)