Inicio rápido: Integra el chat de apertus ai

Prerrequisitos y configuración

Empieza creando una cuenta y obteniendo tu clave API. Regístrate usando Google o una contraseña de correo electrónico en la página de generación de claves. El sistema muestra tu clave inmediatamente, para que puedas copiarla sin demora. No se requiere número de teléfono para el registro. Recibes $0.50 en crédito de prueba válido durante siete días, para que puedas probar la conectividad sin añadir fondos.

Configura tu variable de entorno o cliente SDK para apuntar a la URL base correcta. Esta URL funciona con las bibliotecas estándar de OpenAI. Cambia solo la URL base y tu clave. El ID del modelo es "uncensored". Este único punto final maneja todas las completaciones de texto. No necesitas gestionar el enrutamiento ni seleccionar diferentes modelos.

Asegúrate de que la biblioteca cliente admita el protocolo de Finalizaciones de Chat de OpenAI. La mayoría de los SDK modernos funcionan de inmediato. Verifica que tu red permita solicitudes HTTPS salientes. El servicio acepta cargas útiles JSON estándar. No se necesitan encabezados especiales más allá de la autenticación.

Autenticación con claves de API

Pasa tu clave de API en el encabezado Authorization para cada solicitud. Usa el esquema Bearer seguido de tu cadena de clave. El servicio valida la clave contra tu cuenta. Las claves inválidas devuelven un error 401 Unauthorized. Las claves expiradas o con fondos insuficientes provocan una respuesta 402 Payment Required. Comprueba tu saldo en el panel de control si las solicitudes fallan.

Mantén tu clave segura. Cada cuenta tiene una clave activa. Generar una nueva clave invalida a la anterior. No compartas tu clave en repositorios públicos. La clave de API es el único identificador para tu uso. Los límites de velocidad se aplican por clave, no por cuenta.

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

La autenticación es sin estado. El servidor verifica el token en cada llamada. Si rotas tu clave, actualiza todos los clientes en ejecución inmediatamente. La falta del encabezado resulta en un rechazo inmediato. El mensaje de error indica claramente el fallo de autenticación.

Enviar tu primera solicitud

Envía una solicitud POST al endpoint de chat completions. Incluye el ID del modelo "uncensored" y tu historial de mensajes. La API devuelve una respuesta de texto. Puedes transmitir la salida o esperar la finalización completa. Cada solicitud consume tokens de entrada y salida. Los errores no cobran créditos. Los rechazos son gratuitos.

Copyfrom openai import OpenAI

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

La respuesta incluye estadísticas de uso. Rastrea el consumo de tokens para gestionar tu crédito prepagado. El modelo responde sin rechazos de contenido para uso adulto legal. Puedes enviar prompts del sistema para definir el comportamiento. Los mensajes del usuario dirigen la conversación. La ventana de contexto admite un total de 100,000 tokens.

Comienza con un intercambio simple de dos mensajes. Esto verifica la conectividad y la calidad de la respuesta. Ajusta la temperatura y top_p para salidas creativas o precisas. La API admite parámetros estándar. Las secuencias de parada funcionan como se espera. Los valores de seed aseguran resultados reproducibles.

Respuestas en streaming vía SSE

Habilita el streaming estableciendo el parámetro stream en true. La API devuelve Eventos Enviados por el Servidor (SSE) en lugar de un único objeto JSON. Cada fragmento contiene una porción del texto generado. Lee los fragmentos hasta que termine el flujo. El último fragmento incluye el uso total de tokens.

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)

El streaming reduce la latencia percibida. Los usuarios ven el texto aparecer en tiempo real. Esto es ideal para interfaces de chat. Maneja los tokens parciales con cuidado. Concatena los fragmentos para formar la respuesta completa. El servidor cierra la conexión cuando termina la generación.

Monitora errores de transmisión. Las interrupciones de red pueden abortar la transmisión. Implementa lógica de reconexión si es necesario. La API no reenvía el historial. Inicia una nueva solicitud si falla la transmisión. Los recuentos de tokens en el último fragmento reflejan toda la generación.

Gestión de parámetros y modos

Utiliza parámetros estándar para controlar la generación. Establece temperatura para aleatoriedad. Ajusta top_p para muestreo de núcleo. Define secuencias de parada para detener la generación anticipadamente. Pasa una semilla para salidas deterministas. Habilita el modo JSON estableciendo response_format en json_object. El modelo devuelve JSON válido cuando se solicita.

La llamada a funciones es compatible. Define herramientas en la solicitud. El modelo devuelve llamadas a herramientas cuando es apropiado. Analiza los argumentos de la herramienta en tu código. Pasa los resultados de vuelta para continuar la conversación. Esto habilita flujos de trabajo de agentes complejos.

Copyimport OpenAI from "openai";

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

Los tokens máximos limitan la longitud de salida. El valor predeterminado es 2.048 tokens. Establece un valor más alto si es necesario. El límite estricto por solicitud es de 16.000 tokens. La ventana de contexto es de 100.000 tokens. Planifica la longitud de tu historio en consecuencia. Las penalizaciones de frecuencia y presencia ayudan a reducir la repetición.

Comprender límites y errores

Los límites de tasa protegen la estabilidad del servicio. Puedes enviar 300 solicitudes por minuto. La concurrencia está limitada a ocho solicitudes simultáneas por clave. Los cuerpos de las solicitudes no deben exceder 8 MB. Superar los límites devuelve un error 429 Too Many Errors. Espera antes de reintentar.

Verifica los códigos de error para el diagnóstico. 401 significa clave inválida o faltante. 402 indica crédito prepagado insuficiente. Recarga con criptomonedas para reanudar el servicio. 429 señala limitación de velocidad. 400 denota sintaxis de solicitud incorrecta. Revisa el mensaje de error para más detalles.

La gestión de la ventana de contexto es crítica. Suma los tokens de prompt y de completado. Mantente muy por debajo de 100,000 tokens. Trunca los mensajes antiguos si es necesario. La API no trunca automáticamente. Tú controlas la longitud del historial. El uso eficiente del contexto reduce los costos.