Documentação da API Hermes: Início Rápido

Instalação e Configuração

A API Hermes funciona com qualquer cliente que use o formato OpenAI. Você precisa de uma URL base e de uma chave de API. Crie uma conta via Google ou e-mail na página Obter chave de API. O sistema mostra sua chave imediatamente. Não é necessário número de telefone. Você recebe um crédito de teste de $0,50 por sete dias. Recarregue depois apenas com criptomoedas.

• URL Base: HTTPS://api.apihermes.cc/v1
• Cabeçalho de autenticação: Authorization: Bearer SUA_CHAVE_API
• ID do Modelo: uncensored

Instale seu SDK preferido e defina a URL base. O endpoint espera parâmetros padrão de conclusão de chat. Mantenha sua chave segura. Uma chave substitui a anterior se você gerar uma nova.

Solicitação Básica de Conclusão de Chat

Uma solicitação básica envia mensagens e recebe uma resposta de texto. O ID do modelo é sem censura. Ele lida com conteúdo adulto lícito sem recusa. Você paga por token utilizado. Erros e recusas não têm custo. A janela de contexto comporta 100.000 tokens no total.

Estruture sua solicitação com uma mensagem de system e uma mensagem de user. A API retorna uma conclusão. Você pode definir max_tokens para controlar o comprimento da saída. O limite padrão de saída é de 2.048 tokens. Você pode aumentar isso para 16.000 tokens por solicitação. O streaming funciona via SSE. A chamada de funções está disponível. O modo JSON é suportado.

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"}]
  }'

O corpo da solicitação está limitado a 8 MB. Os limites de taxa são de 300 solicitações por minuto. A concorrência é de oito solicitações ao mesmo tempo. A lógica de retry lida com sobrecarga do servidor de forma elegante.

Respostas em Streaming com SSE

O streaming entrega tokens conforme são gerados. O servidor envia Server-Sent Events. Cada chunk contém texto parcial. O último chunk inclui estatísticas de uso de tokens. Esta abordagem reduz a latência percebida para respostas longas. É ideal para interfaces de chat. Você deve lidar com o fluxo corretamente. Desconexões podem ocorrer. A API não garante a ordem de entrega além do próprio fluxo.

Defina o parâmetro stream como true. Analise as linhas de dados. Concatene o conteúdo. Verifique o finish_reason para conclusão. O modelo uncensored funciona com qualquer SDK compatível com OpenAI. Configure o cliente para lidar com SSE. Monitore a contagem de tokens. A URL base permanece a mesma. A autenticação é idêntica. Nenhuma configuração extra é necessária.

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)

Erros aparecem no stream. Lidere-os fechando a conexão. O crédito pré-pago é deduzido apenas para tokens concluídos. Isso economiza dinheiro durante interrupções. Você nunca paga por saída parcial de lixo. O sistema é transparente.

Usando Chamada de Função e Ferramentas

A chamada de função permite que o modelo execute código ou ferramentas. Defina ferramentas no corpo da solicitação. O modelo retorna uma chamada de ferramenta. Você executa a ferramenta. Você envia o resultado de volta. O modelo gera uma resposta final. Isso permite fluxos de trabalho complexos. Não é apenas um wrapper de chat. A API suporta ferramentas e tool_choice. Use isso para agentes ou automação.

Estruture o array de ferramentas. Inclua nome, descrição e parâmetros. O modelo decide quando chamar uma ferramenta. Você deve analisar os argumentos. Execute a função. Passe a saída para a conversa. O modelo continua. Esse ciclo se repete até a resposta final. A janela de contexto rastreia todas as interações com as ferramentas. Acompanhe o uso de tokens. Os custos aumentam com as saídas das ferramentas. Monitore o uso no último chunk.

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)

O modelo sem censura lida com esquemas de ferramentas diversos. Ele não recusa com base no conteúdo. Use isso para roleplay ou tarefas técnicas. A API é confiável. Sem erros. O sistema pré-pago garante justiça. Você controla o fluxo. A URL base é consistente. A autenticação é simples.

Modo JSON e Parâmetros

O modo JSON força o modelo a gerar JSON válido. Defina response_format como json_object. Isso é útil para dados estruturados. O modelo evita wrappers markdown. Ele retorna JSON puro. Use isso para análise. Melhora a confiabilidade. A janela de contexto ainda se aplica. Você paga por tokens. O modelo uncensored respeita o formato. Ele não recusa com base no conteúdo.

Os parâmetros incluem temperatura, top_p, stop, seed, presence_penalty e frequency_penalty. A temperatura controla a aleatoriedade. O top_p controla a diversidade. As sequências de parada interrompem a geração. A semente garante reprodutibilidade. As penalidades de presença e frequência ajustam o uso de tokens. Defina-os para refinar a saída. A API suporta todos os parâmetros padrão. Use-os para ajustar a resposta. A URL base permanece a mesma. A autenticação é 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);

Os erros são tratados por meio de códigos de status HTTP. 401 significa chave inválida. 402 significa sem crédito. 429 significa limite de taxa. Lidere com isso no seu código. O crédito pré-pago é deduzido apenas para tokens concluídos. Isso garante justiça. Você nunca paga por saída parcial. O sistema é transparente. O modelo uncensored é confiável. Use-o para qualquer tarefa lícita.

Tratamento de Erros e Limites de Taxa

A API retorna códigos de status HTTP padrão. 401 indica uma chave de API inválida. 402 indica crédito pré-pago insuficiente. 429 indica um limite de taxa. O limite é de 300 solicitações por minuto. A concorrência é de oito solicitações ao mesmo tempo. Os corpos das solicitações são limitados a 8 MB. Lidere esses erros com elegância. Tente novamente com backoff exponencial. O modelo sem censura não recusa conteúdo legal. Erros são gratuitos. Você não paga por solicitações falhas. O crédito pré-pago é seguro. Nunca expira. Use a página de Suporte para cobranças duplas. Apenas cripto. USDT ou USDC. Bônus aplicam-se.