Documentación de la API Hermes: Inicio rápido

Instalación y configuración

La API hermes funciona con cualquier cliente que hable el formato OpenAI. Necesitas una URL base y una clave de API. Crea una cuenta a través de Google o correo electrónico en la página Obtener clave de API. El sistema muestra tu clave inmediatamente. No se requiere número de teléfono. Recibes $0.50 de crédito de prueba durante siete días. Recarga más tarde solo con criptomonedas.

• URL Base: HTTPS://api.apihermes.cc/v1
• Cabecera de autenticación: Authorization: Bearer YOUR_API_KEY
• ID del Modelo: uncensored

Instala tu SDK preferido y establece la URL base. El endpoint espera parámetros estándar de chat completions. Mantén tu clave segura. Una clave reemplaza a la anterior si generas una nueva.

Solicitud de Completado de Chat Básico

Una solicitud básica envía mensajes y recibe una respuesta de texto. El ID del modelo es sin censura. Maneja contenido adulto lícito sin rechazos. Pagas por token utilizado. Los errores y rechazos no cuestan nada. La ventana de contexto contiene 100.000 tokens en total.

Estructura tu solicitud con un mensaje de system y un mensaje de user. La API devuelve una finalización. Puedes establecer max_tokens para controlar la longitud de la salida. El límite de salida predeterminado es de 2.048 tokens. Puedes subirlo a 16.000 tokens por solicitud. El streaming funciona vía SSE. La llamada de funciones está disponible. El modo JSON es compatible.

Copycurl https://api.apihermes.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a GET request for the user endpoint"}]
  }'

El cuerpo de la solicitud está limitado a 8 MB. Los límites de velocidad son de 300 solicitudes por minuto. La concurrencia es de ocho solicitudes a la vez. La lógica de reintento maneja la sobrecarga del servidor de forma elegante.

Respuestas en streaming con SSE

El streaming entrega tokens a medida que se generan. El servidor envía Server-Sent Events. Cada fragmento contiene texto parcial. El último fragmento incluye estadísticas de uso de tokens. Este enfoque reduce la latencia percibida para respuestas largas. Es ideal para interfaces de chat. Debes manejar el flujo correctamente. Pueden ocurrir desconexiones. La API no garantiza el orden de entrega más allá del propio flujo.

Establece el parámetro stream a true. Analiza las líneas de datos. Concatena el contenido. Comprueba el finish_reason para la finalización. El modelo uncensored funciona con cualquier SDK compatible con OpenAI. Configura el cliente para manejar SSE. Supervisa el recuento de tokens. La URL base permanece igual. La autenticación es idéntica. No se necesita configuración adicional.

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)

Los errores aparecen en el stream. Manejalos cerrando la conexión. El crédito prepagado se descuenta solo por los tokens completados. Esto ahorra dinero durante las interrupciones. Nunca pagas por salida parcial basura. El sistema es transparente.

Usando Llamada de Función y Herramientas

La llamada de función permite que el modelo ejecute código o herramientas. Define herramientas en el cuerpo de la solicitud. El modelo devuelve una llamada de herramienta. Tú ejecutas la herramienta. Envías el resultado de vuelta. El modelo genera una respuesta final. Esto habilita flujos de trabajo complejos. No es solo un contenedor de chat. La API admite herramientas y tool_choice. Úsalo para agentes o automatización.

Estructura el array de herramientas. Incluye nombre, descripción y parámetros. El modelo decide cuándo llamar a una herramienta. Debes analizar los argumentos. Ejecuta la función. Pasa la salida a la conversación. El modelo continúa. Este ciclo se repite hasta la respuesta final. La ventana de contexto rastrea todas las interacciones con herramientas. Lleva un registro del uso de tokens. Los costes se acumulan con las salidas de las herramientas. Monitorea el uso en el último fragmento.

Copyfrom openai import OpenAI

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

El modelo sin censura maneja esquemas de herramientas diversos. No rechaza basándose en el contenido. Úsalo para roleplay o tareas técnicas. La API es fiable. Sin errores. El sistema prepagado garantiza equidad. Tú controlas el flujo. La URL base es consistente. La autenticación es sencilla.

Modo JSON y parámetros

El modo JSON obliga al modelo a generar JSON válido. Establece response_format a json_object. Esto es útil para datos estructurados. El modelo evita los envoltorios markdown. Devuelve JSON crudo. Úsalo para el análisis. Mejora la fiabilidad. La ventana de contexto sigue aplicándose. Pagas por tokens. El modelo uncensored respeta el formato. No se niega basándose en el contenido.

Los parámetros incluyen temperatura, top_p, stop, seed, presence_penalty y frequency_penalty. La temperatura controla la aleatoriedad. Top_p controla la diversidad. Las secuencias de parada detienen la generación. Seed asegura la reproducibilidad. Las penalizaciones de presencia y frecuencia ajustan el uso de tokens. Configúralos para refinar la salida. La API soporta todos los parámetros estándar. Úsalos para ajustar la respuesta. La URL base permanece igual. La autenticación es idéntica.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apihermes.cc/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 errores se manejan mediante códigos de estado HTTP. 401 significa clave inválida. 402 significa sin crédito. 429 significa límite de velocidad. Maneja estos casos en tu código. El crédito prepagado se descuenta solo por los tokens completados. Esto garantiza equidad. Nunca pagas por salidas parciales. El sistema es transparente. El modelo uncensored es fiable. Úsalo para cualquier tarea lícita.

Gestión de errores y límites de velocidad

La API devuelve códigos de estado HTTP estándar. 401 indica una clave API no válida. 402 indica crédito prepagado insuficiente. 429 indica un límite de velocidad. El límite es de 300 solicitudes por minuto. La concurrencia es de ocho solicitudes a la vez. Los cuerpos de las solicitudes están limitados a 8 MB. Maneja estos errores de manera elegante. Reintenta con retroceso exponencial. El modelo sin censura no rechaza contenido legal. Los errores son gratuitos. No pagas por las solicitudes fallidas. El crédito prepagado es seguro. Nunca expira. Usa la página de Soporte para cargos dobles. Solo criptomonedas. USDT o USDC. Se aplican bonificaciones.