API de MiniMax: Guía rápida y SDK

Autenticación y URL base

Usa la clave de API proporcionada y apunta tu cliente a la URL base dedicada. El punto de conexión para generar respuestas es https://api.minimaxaiapi.com/v1/chat/completions.Pasas la clave en el Authorization header como token bearer. Esto funciona con cualquier SDK estándar de OpenAI porque seguimos el mismo protocolo.

• Nombre del encabezado: Authorization
• Valor del encabezado: Bearer YOUR_API_KEY
• URL base: https://api.minimaxaiapi.com/v1

No se requiere una configuración compleja. Solo actualiza la configuración en tu proyecto existente.

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

Endpoint Chat Completions

Envía una solicitud POST al endpoint de chat completions para obtener una respuesta de texto. El identificador del modelo es uncensored.Debes incluir una matriz de mensajes con tu historial de conversaciones. El sistema procesa la entrada y devuelve texto generado basado en tu prompt.

Este extremo maneja toda la generación de texto. No admite embeddings, audio ni video. Puedes transmitir respuestas o esperar el bloque completo. El modelo maneja un contexto de hasta 100,000 tokens en total.

Copyfrom openai import OpenAI

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

Streaming y Uso de Tokens

Habilita la transmisión estableciendo stream: true en tu solicitud. La API devuelve Eventos Enviados por Servidor (SSE) para cada token generado. Esto permite la visualización en tiempo real de la salida. Las estadísticas de uso de tokens se incluyen en el último fragmento del flujo. Esto te ayuda a rastrear los costos con precisión sin analizar cada token individual.

El streaming reduce la latencia percibida para respuestas largas. Es ideal para interfaces de chat y generación de contenido dinámico. Puedes detener el stream temprano si el usuario interrumpe la generación.

Copyimport OpenAI from "openai";

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

Llamada de Función y Modo JSON

Utiliza el tools parámetro para habilitar la llamada de funciones. Define tus funciones en el cuerpo de la solicitud y deja que el modelo elija cuál llamar. La tool_choice el parámetro te permite forzar una función específica o auto-seleccionar. Para una salida JSON estricta, establece response_format para {"type": "json_object"}. Esto garantiza que la respuesta sea JSON válido.

La llamada de funciones es útil para extraer datos estructurados o desencadenar acciones. El modo JSON es perfecto para integraciones de API que requieren formatos predecibles. Combina ambos para una lógica de aplicación robusta.

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)

Parámetros y Restricciones del Modelo

Ajustar el comportamiento de generación utilizando parámetros estándar como temperature, top_p, y stop. La ventana de contexto máxima es de 100,000 tokens, incluyendo el prompt y la completación. La salida máxima por solicitud es de 16,000 tokens. Si no estableces max_tokens, el límite predeterminado es de 2,048 tokens.

Usar seed para resultados reproducibles. Establece presence_penalty y frequency_penalty para controlar la repetición. Estos parámetros te dan un control fino sobre la creatividad y la consistencia del modelo. Prueba siempre con tu caso de uso específico para encontrar el equilibrio adecuado.

Límites de velocidad y errores

La API limita a 300 solicitudes por minuto y permite ocho solicitudes concurrentes por clave. Si superas estos límites, recibirás un error 429. Un error 401 indica una clave API inválida o faltante. Un error 402 significa que tu crédito prepagado se ha agotado.

Los errores no consumen tu crédito. Puedes reintentar las solicitudes fallidas sin penalización. El tamaño del cuerpo de la solicitud está limitado a 8 MB. Gestiona tu concurrencia cuidadosamente para evitar limitaciones. Monitorea tu uso a través del último fragmento de las respuestas en streaming.