Configuración de la API de MiniMax: clave, URL base y primera petición, URL base y primera petición
Esta es una configuración paso a paso para la API compatible con OpenAI en minimaxapikey.com: cuenta, clave, URL base y primera petición, URL base, primera petición. Es un servicio independiente, no la API oficial de ningún proveedor de modelos.
Actualizado

Puntos clave, URL base y primera petición
- Regístrate con Google o correo electrónico, luego reclama $0,50 de crédito de prueba en la página de la clave, URL base y primera petición. No se requiere tarjeta.
- La URL base es https://api.minimaxapikey.com/v1, el ID del modelo es uncensored, la autenticación es una clave, URL base y primera petición Bearer.
- Existen dos métodos: POST /v1/chat/completions y GET /v1/models.
- Un 401 significa una clave, URL base y primera petición incorrecta, y un 429 significa que se alcanzó un límite, así que verifica el código de error en el cuerpo.
Lo que estás configurando
La gente busca configuración de la API de minimax esperando una de dos cosas: la plataforma oficial de desarrolladores de MiniMax, o un endpoint estilo OpenAI listo para usar. Esta página cubre lo segundo. El servicio detrás de minimaxapikey.com es una API de texto compatible con OpenAI alojada que ejecuta un único modelo de pesos abiertos, operado por un proveedor independiente. No es la API oficial de MiniMax ni de ningún otro proveedor de modelos, y no enruta peticiones entre proveedores. Si necesitas la plataforma propia del proveedor, usa su sitio.
Lo que obtienes es simple. Cualquier SDK o cliente de OpenAI funciona una vez que cambias la URL base y la clave, URL base y primera petición. Hay dos métodos, POST /v1/chat/completions y GET /v1/models, un ID de modelo, uncensored, y una ventana de contexto de 100.000 tokens compartida por el prompt y la respuesta. Solo maneja texto, por lo que no hay generación de imágenes, audio o video, ni incrustaciones ni ajuste fino. Se admite streaming, llamadas a funciones y modo JSON.
Toda la configuración toma unos minutos. Los pasos siguientes van en orden, y cada uno termina con una verificación para que sepas que funcionó antes de continuar.
Pasos 1 y 2: crea una cuenta y reclama la prueba
- Abre la página de clave, URL base y primera peticións. Ve a la página de la clave, URL base y primera petición de API y regístrate. Puedes usar Google, o una dirección de correo electrónico y contraseña.
- Reclama el crédito de prueba. Tras el registro, la página de la clave, URL base y primera petición tiene un botón para $0,50 de crédito de prueba. Es un clic, no necesita tarjeta, es válido por 7 días y está limitado a uno por persona.
La prueba es pequeña a propósito. A $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, $0,50 cubre una buena cantidad de peticiones de prueba. Un prompt de 1.000 tokens con una respuesta de 500 tokens cuesta $0,00015 de entrada más $0,00025 de salida, lo que es $0,0004. Dividir $0,50 entre eso da 1.250 peticiones de ese tipo, así que tienes mucho margen para experimentar.
Ten en cuenta los límites de la clave, URL base y primera petición de prueba: 2 peticiones simultáneas y 60 peticiones por minuto. Una clave, URL base y primera petición completa, que obtienes una vez que recargas, permite 8 peticiones simultáneas y 300 por minuto. Si tu bucle de prueba se ejecuta en paralelo y ves errores 429, esto es lo primero que debes verificar.
Paso 3: crea la clave, URL base y primera petición y guárdala de forma segura
En la misma página, crea una clave, URL base y primera petición de API y cópiala. Trátala como una contraseña. Ponla en una variable de entorno o en un gestor de secretos, nunca en un repositorio, un bundle de frontend o una captura de pantalla. Si una clave, URL base y primera petición se filtra, revócala y crea una nueva.
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
El código del lado del servidor debe leer la variable en tiempo de ejecución. El código del navegador nunca debe guardar la clave, URL base y primera petición: envía peticiones desde tu backend en su lugar, porque todo lo que se envía al navegador es visible para todos los visitantes.
Paso 4: lista modelos para confirmar la clave, URL base y primera petición
La prueba más barata posible es el endpoint de modelos. No genera texto, así que es una verificación limpia de la clave, URL base y primera petición, la URL y tu red.
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
Deberías obtener una lista JSON que incluya uncensored. Si obtienes un 401, la clave, URL base y primera petición es incorrecta o tiene un espacio o comillas extra alrededor. Si la conexión falla, verifica que la URL termine en /v1 y que hayas usado https.
Paso 5: envía la primera petición de chat
Ahora una respuesta real. El cuerpo tiene la forma estándar de chat completions.
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
La respuesta contiene choices[0].message.content y un bloque usage con los recuentos de tokens del prompt y la respuesta. También revisa los encabezados de respuesta con curl -i. Verás X-Request-Id, que el soporte puede usar para encontrar tu petición, X-Balance-USD, tu crédito restante, y los encabezados de límite de peticiones X-RateLimit-Limit-Requests y X-RateLimit-Limit-Concurrency.
Los parámetros como temperature, top_p, stop, seed y las penalizaciones se pasan directamente. max_tokens es opcional. Si no lo especificas, la respuesta puede usar todo lo que quede de la ventana.
Paso 6: la misma llamada desde un SDK
Una vez que curl funciona, pasa al lenguaje que realmente usarás. Solo dos argumentos cambian desde una configuración estándar de OpenAI.
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
Para streaming, añade stream: true y lee los eventos enviados por el servidor. Los números de uso llegan al final del flujo. La página de documentación cubre streaming, llamadas a funciones y modo JSON con response_format: {"type":"json_object"}.
Migrar un proyecto existente de OpenAI
La mayor parte del tiempo, el proyecto que quieres conectar ya funciona con la biblioteca de clientes de OpenAI. En ese caso, rara vez editas código. Los SDK oficiales leen las variables de entorno OPENAI_API_KEY y OPENAI_BASE_URL cuando no pasas argumentos, así que un cambio de despliegue puede ser suficiente.
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
La última edición es el nombre del modelo. Un string como un ID de modelo de OpenAI no existirá aquí, así que reemplázalo con uncensored, idealmente a través de un valor de configuración para que puedas volver atrás. Luego revisa el código para ver las funciones que el servicio no ofrece. La generación de imágenes, audio, incrustaciones y ajuste fino no están disponibles, porque esta es una API de chat solo de texto. Si tu aplicación llama a incrustaciones para búsqueda, necesitarás otro proveedor para esa parte y puedes mantener el chat en este.
También ayuda saber qué es el modelo. Es un único modelo de pesos abiertos, ajustado para responder sin rechazos de contenido para uso adulto lícito, y aplica un límite estricto independientemente de la configuración: no hay contenido sexual que involucre menores de edad. Los prompts escritos para otro modelo pueden necesitar ajustes pequeños, ya que cada modelo reacciona de forma diferente al mismo prompt de sistema. Ejecuta tus propios prompts de prueba lado a lado antes de cambiar el tráfico real.
Configuraciones que vale la pena elegir desde el primer día
Algunas decisiones son más fáciles de tomar en el momento de la configuración que después del lanzamiento. Ninguna es difícil, pero cada una evita una sorpresa más tarde.
- Un prompt de sistema. Pon tus instrucciones sobre tono, formato y rol en un mensaje
system. Manténlo corto y específico, porque cada petición lo repite como tokens de entrada. - Un límite de tokens.
max_tokenses opcional, pero un límite es una protección económica. Sin uno, una sola respuesta puede usar el resto de la ventana de 100.000 tokens. - Streaming para uso interactivo. Configura
stream: truesi una persona está esperando la respuesta. Para trabajos por lotes, las peticiones simples son más sencillas. - Una regla de reintento para 429. Trata el 429 como una señal para esperar, no como un fallo. Cuando la respuesta incluye
Retry-After: 5, pausar ese tiempo y reintentar es la medida correcta. - Tamaño de la petición. El límite del cuerpo es 8 MB. Eso es mucho más de lo que necesita un prompt normal, pero los logs o documentos pegados pueden alcanzarlo.
Los prompts no se usan para entrenamiento, lo cual importa si planeas enviar documentos internos o mensajes de usuarios. Tú sigues siendo el responsable de lo que envías, así que evita poner secretos que el modelo no necesita en un prompt.
Recargar después de la prueba
La prueba es para verificar que todo funciona. Cuando estés listo para construir, añade crédito prepago. No hay suscripción: pagas por los tokens usados, a $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, y el crédito no caduca, así que un saldo no utilizado no desaparece al final del mes.
Cualquier cantidad entera desde $20 hasta $500 funciona. Una recarga de $50 añade un bono del 5%, $100 añade 10%, y $200 añade 15%. Como ejemplo rápido, una recarga de $100 con su bono del 10% da $110 de crédito. Con un prompt de 1.000 tokens y una respuesta de 500 tokens del paso dos, cada petición cuesta $0,0004, por lo que $110 cubre 275.000 peticiones. Los prompts reales suelen ser más largos, así que escala esa cifra a tu promedio propio.
Corrección de errores comunes de configuración
| Síntoma | Causa probable | Solución |
|---|---|---|
| 401 en cada llamada | Clave ausente, mal escrita o revocada | Envía Authorization: Bearer <key>, sin comillas extra |
| 404 o respuesta HTML | Ruta incorrecta, usualmente falta /v1 | Usa la URL base completa que termina en /v1 |
| Modelo no encontrado | Un nombre de modelo copiado de otro proveedor | Usa uncensored |
429 con rate_limited | Superado el límite de peticiones por minuto | Ralentiza, o recarga para pasar de los límites de prueba a los límites completos |
429 con concurrency | Demasiadas peticiones a la vez | Limita las llamadas paralelas a 8 (2 en una clave, URL base y primera petición de prueba) |
429 con Retry-After: 5 | Sobrecarga temporal | Espera 5 segundos y reintenta |
| 413 o cuerpo rechazado | Petición superior a 8 MB | Acorta el prompt o divide la tarea |
Cuando estés listo para más que la prueba, la página de precios lista las opciones de recarga: cualquier cantidad entera desde $20 hasta $500, pagada con cripto (USDT en TRC20, USDC en Base), con un bono del 5% desde $50, 10% desde $100 y 15% desde $200. Las peticiones fallidas o rechazadas no se cobran, y los prompts no se usan para entrenamiento.
Más guías
Preguntas y respuestas
¿Es esta la API oficial de MiniMax?
No. Es una API independiente, alojada y compatible con OpenAI que sirve un solo modelo de pesos abiertos, ajustado para responder sin rechazos de contenido para uso adulto lícito. No es la API oficial de ningún proveedor de modelos ni un enrutador entre proveedores.
¿Necesito una tarjeta de crédito para probarlo?
No. Después de registrarte puedes reclamar $0,50 de crédito de prueba con un clic en la página de la clave, URL base y primera petición de API. Es válido por 7 días y está limitado a uno por persona.
¿Cuál es el nombre del modelo para usar en las peticiones?
Usa uncensored. El servicio expone este único ID de modelo y GET /v1/models lo mostrará.
¿Cómo añado más crédito más adelante?
Recarga cualquier cantidad entera desde $20 hasta $500. Los bonos se aplican desde $50 (+5%), $100 (+10%) y $200 (+15%), y el crédito no caduca.
¿Puedo usar el SDK de OpenAI?
Sí. Establece base_url a https://api.minimaxapikey.com/v1, usa tu clave, URL base y primera petición, y envía el modelo como uncensored. Nada más en tu código tiene que cambiar.
Tu clave, URL base y primera petición está a un formulario de distancia
Crea una cuenta, copia la clave, URL base y primera petición, cambia la URL base. Esa es toda la configuración.