Inicio rápido: Conecta tu cliente

Prerrequisitos e instalación del SDK

Instala el SDK oficial para tu lenguaje para manejar la autenticación y la serialización de solicitudes automáticamente. Necesitas una clave de API válida y la URL base configurada en tu entorno de cliente. Nuestro servicio acepta parámetros estándar como temperature y top_p sin requerir encabezados personalizados.

Asegúrate de que tu variable de entorno contenga tu token de forma segura antes de ejecutar cualquier script. Las versiones del SDK deben estar actualizadas para admitir correctamente las funciones de streaming y modo JSON. No se requieren controladores adicionales para la generación solo de texto.

Configurando URL base y clave

Apunta tu cliente a nuestra URL base específica para enrutar las solicitudes a través de nuestra infraestructura sin censura. Utiliza el encabezado Authorization: Bearer YOUR_KEY para autenticar cada llamada. Esta configuración funciona de manera idéntica para pruebas locales o scripts de implementación en producción.

Reemplaza el endpoint predeterminado de OpenAI con nuestro host para evitar confusiones con otros proveedores. Mantén tu clave en secreto y no la expongas en repositorios públicos. La configuración permanece estática hasta que rotas tu clave.

Enviar tu primera solicitud

Ejecuta una llamada estándar de finalizaciones de chat para verificar la conectividad y el formato de la respuesta. Envía un prompt sencillo para confirmar que el modelo devuelve texto sin negativas. Esta prueba asegura que tu clave tiene suficiente crédito prepagado para el uso.

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

Comprueba la respuesta para ver detalles de contenido y uso de tokens. Si recibes un error 401, verifica el formato de tu clave. Un 402 indica que necesitas recargar tu saldo de créditos.

Gestión de respuestas en streaming

Habilita el streaming para recibir tokens en tiempo real a medida que se generan. Esto reduce la latencia percibida para los usuarios que esperan salidas largas. El último fragmento contiene los recuentos finales de tokens para una precisión en la facturación.

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)

Maneja las respuestas parciales de manera adecuada en el código de tu cliente. Almacena en búfer el contenido hasta que se cierre la transmisión o se produzca un error. La transmisión funciona con todos los parámetros estándar, incluidas las ajustes de temperatura.

Integración del SDK de Python

Utiliza la biblioteca de Python para gestionar solicitudes con código mínimo de boilerplate. Inicializa el cliente con tu URL base y clave para un uso inmediato. Este enfoque simplifica el manejo de errores y el análisis de respuestas.

Copyfrom openai import OpenAI

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

Accede al contenido generado directamente desde el objeto de respuesta. Verifica si hay errores y gestiona los límites de tasa adecuadamente. El SDK admite flujos de trabajo tanto sincrónicos como asíncronos.

SDK Node y límites

Integra con aplicaciones Node.js utilizando el SDK de JavaScript oficial. Establece la URL base para asegurar que las solicitudes lleguen a nuestro endpoint sin censura. Monitorea tu uso para mantenerte dentro de los límites de frecuencia.

Copyimport OpenAI from "openai";

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

Puedes realizar 300 solicitudes por minuto con una concurrencia de 8. Cada cuerpo de solicitud debe mantenerse por debajo de 8 MB. La ventana de contexto admite un total de 100,000 tokens. Los errores y las denegaciones no consumen crédito, pero las salidas exitosas sí. Mantén tu clave segura y rotarla si es necesario.

Comprender el uso de tokens

La facturación se basa en los tokens reales utilizados en el prompt y la completación. Los tokens de entrada cuestan $0.15 por millón, mientras que los tokens de salida cuestan $0.50 por millón. El crédito prepagado cubre todo el uso sin tarifas mensuales.

Los errores y las denegaciones son gratuitos, por lo que solo pagas por las respuestas exitosas. El último fragmento en un stream contiene el recuento de tokens. Monitorea tu panel para rastrear los gastos y evitar quedarte sin crédito. Recarga con USDT o USDC para acceso instantáneo.