API de MiniMax: primera petición en cinco minutos

Instalar el SDK de OpenAI

Comienza instalando el SDK oficial de OpenAI para tu lenguaje preferido. La biblioteca maneja el formato de peticiones y el streaming automáticamente. Asegúrate de tener Python 3.8+ o Node.js 18+ instalados. Ejecuta pip install openai para Python o npm install openai para Node. El SDK simplifica la interacción con el endpoint /v1/chat/completions. Gestiona encabezados, reintentos y análisis de SSE para que puedas centrarte en el prompt. Esto funciona porque nuestra API sigue el estándar de finalizaciones de chat de OpenAI. No necesitas una biblioteca de cliente personalizada. Los métodos estándar del SDK se mapean directamente a nuestros endpoints. Esto reduce el tiempo de integración y aprovecha el conocimiento existente de los desarrolladores.

Configurar URL base y clave

Configura tu clave de API y URL base en las variables de entorno. Nuestra URL base es https://api.minimaxapikey.com/v1. Esto te permite usar clientes estándar de OpenAI sin modificaciones. Crea una cuenta para generar tu clave. La clave se muestra inmediatamente después del registro. No se necesita tarjeta para la prueba. Almacena la clave de forma segura. Pásala como encabezado o variable de entorno. El SDK usa OPENAI_API_KEY por defecto. Puedes anular la URL base para apuntar a nuestros servidores. Esto asegura que todas las peticiones vayan al modelo sin censura. Verifica que tu clave funciona con un ping simple. Este paso previene errores de autenticación más adelante.

Enviar una finalización de chat básica

Haz tu primera petición para generar texto. Usa el método POST en /v1/chat/completions. Especifica el modelo como uncensored. Pasa un array de mensajes con un prompt. La API devuelve un token. Es la función central de generación. Admite ventana de 100k tokens. Puedes enviar prompts largos o historial. La respuesta incluye el texto generado y el uso de tokens. Ideal para escritura creativa o diálogo sin restricciones. Asegura que el contenido sea legal. El modelo no rechaza temas adultos. Solo bloquea contenido sexual con menores. Empieza simple para verificar la conexión.

Habilitar streaming (SSE)

Para salida en tiempo real, activa el streaming. Establece el parámetro stream en true. La API devuelve Server-Sent Events (SSE). Cada fragmento contiene parte de la respuesta. Esto reduce la latencia percibida. Los usuarios ven el texto aparecer a medida que se genera. El SDK analiza los fragmentos automáticamente. Puedes mostrar texto de forma incremental en una interfaz. Esto es crucial para interfaces de chat. El streaming funciona con todas las respuestas del modelo. No afecta el conteo de tokens. Cada fragmento incluye datos de uso al final. Úsalo para mejorar la experiencia del usuario. Se siente más receptivo que esperar la respuesta completa. Configura tu cliente para almacenar fragmentos correctamente.

Usar llamadas a funciones/herramientas

Soporta salidas estructuradas con llamadas a funciones. Define herramientas en el cuerpo de la petición. El modelo puede llamar a funciones basándose en el prompt. Esto permite la integración con sistemas externos. Pasa definiciones de herramientas y mensajes de usuario. La respuesta incluye un objeto de llamada a herramienta. Ejecuta la función y devuelve los resultados. Esto funciona con SDKs estándar de OpenAI. Permite flujos de trabajo complejos. Puedes construir agentes o asistentes. El modelo mantiene el contexto entre llamadas. Esto es potente para la automatización. Asegúrate de que tus definiciones de herramientas sean precisas. La API maneja el enrutamiento de las salidas de herramientas. Mantiene la conversación coherente. Usa esto para generación de contenido dinámico.

Ver modelos disponibles

Verifica la lista de modelos con GET /v1/models. Este endpoint devuelve modelos disponibles. Nuestra API ofrece un modelo: uncensored. Es un modelo de pesos abiertos. No es GPT, Claude ni Gemini. La respuesta confirma el ID del modelo. Úsalo para depurar configuraciones. Asegura que tu código apunte al modelo correcto. El endpoint es rápido y fiable. Devuelve datos JSON. Puedes analizarlos para la interfaz. Confirma que tu clave es válida. Úsalo para controles de salud automatizados. Forma parte del estándar OpenAI. No se necesita configuración extra. Esto asegura compatibilidad con herramientas existentes.

cURL

Copycurl https://api.minimaxapikey.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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)