API de Hermes: Cambia tu cliente en tres líneas

Instala el SDK de OpenAI

Dado que nuestro endpoint es compatible con OpenAI, puedes usar los SDKs oficiales que ya conoces. Este enfoque te permite cambiar de otros proveedores sin reescribir la lógica de tu aplicación. Admitimos el paquete estándar openai para entornos Python y Node.js.

Asegúrate de usar una versión reciente del SDK para garantizar la compatibilidad con las funciones de streaming y llamadas a funciones. La biblioteca cliente maneja automáticamente la serialización JSON y el transporte HTTP, así que puedes centrarte en los parámetros del modelo en lugar de los detalles de red.

Configura la URL base y la clave

La autenticación se maneja con un token Bearer en el header Authorization. Obtienes tu clave registrándote con email y contraseña en nuestro panel. No se requiere tarjeta para la prueba y puedes regenerar tu clave en cualquier momento para revocar el acceso.

Establece la URL base en nuestro endpoint dedicado. Esto asegura que todas las peticiones vayan a nuestra infraestructura de modelo sin censura en lugar de la nube predeterminada de OpenAI. Puedes encontrar tu clave de API en la página 'Obtener clave de API' inmediatamente después del registro.

Envía tu primera petición

Envía una petición estándar de completado de chat para probar la conectividad. El ID del modelo es siempre uncensored. Este modelo está ajustado para responder sin rechazos de contenido para uso adulto legal, lo que lo hace ideal para escritura creativa, roleplay o investigación sin restricciones.

• Usa POST /v1/chat/completions para la generación de texto.
• La ventana de contexto admite hasta 100.000 tokens para prompt más completado.
• Las peticiones se cobran según el recuento de tokens de entrada y salida.

Copycurl https://api.hermesllmapi.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."}]
  }'

Habilita streaming (SSE)

Para una mejor experiencia de usuario, habilita el streaming para recibir tokens a medida que se generan. Esto reduce la latencia percibida, especialmente para respuestas más largas. El servidor devuelve Eventos Enviados por Servidor (SSE) que tu cliente puede analizar en tiempo real.

Establece el parámetro stream en true en el cuerpo de tu petición. El SDK generará fragmentos a medida que lleguen. Esto es particularmente útil para interfaces de chat donde deseas mostrar texto de forma incremental en lugar de esperar a que termine toda la respuesta.

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)

Usa llamadas a funciones

Nuestra API admite llamadas a funciones, permitiendo que el modelo genere JSON estructurado para la ejecución de herramientas externas. Define tus funciones en el parámetro tools, y el modelo devolverá tool_calls en la respuesta si corresponde.

Esta función funciona exactamente como se documenta en la especificación de OpenAI. Puedes analizar el nombre de la función y los argumentos, ejecutar la lógica de tu backend y devolver los resultados a la conversación. Es totalmente compatible con los flujos de trabajo de llamadas a funciones de los SDK estándar de OpenAI.

Copyimport OpenAI from "openai";

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

Consulta los modelos disponibles

Consulta el endpoint de modelos para verificar la conectividad y ver las opciones disponibles. Actualmente, ofrecemos un único modelo dedicado: uncensored. Esta simplicidad evita la complejidad del enrutamiento de modelos o infraestructura genérica, asegurando un comportamiento predecible.

También puedes usar este endpoint para depurar problemas de autenticación. Si la petición falla, verifica la validez de tu clave de API y la conectividad de red. La respuesta enumerará los detalles del modelo, incluido el tamaño de la ventana de contexto y los límites de tokens.

Copyfrom openai import OpenAI

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

Maneja límites de peticiones y errores

Nuestra API aplica un límite de 300 peticiones por minuto por clave. Si excedes esto, recibirás un error 429. También admitimos un límite de cuerpo de petición de 8 MB para prompts complejos o ventanas de contexto grandes.

Los errores comunes incluyen 401 (clave inválida) y 402 (crédito insuficiente). El crédito prepago no caduca, así que puedes recargar cuando te convenga. Los bonos de crédito se aplican automáticamente para compras más grandes: +5% desde $50 y +10% desde $100.