Hermes api 문서: 시작하기

설치 및 설정

헤르메스 API는 OpenAI 형식을 지원하는 모든 클라이언트와 함께 작동합니다. 기본 URL과 API 키가 필요합니다. 'API 키 받기' 페이지에서 Google 또는 이메일을 통해 계정을 생성하세요. 시스템은 즉시 키를 표시합니다. 전화번호가 필요하지 않습니다. 7일 동안 $0.50의試用 크레딧을 받습니다. 이후에는 암호화폐로만 충전할 수 있습니다.

• Base URL: HTTPS://api.apihermes.cc/v1
• Auth header: Authorization: Bearer YOUR_API_KEY
• 모델 ID: uncensored

선호하는 SDK를 설치하고 베이스 URL을 설정하세요. 엔드포인트는 표준 채팅 완료 매개변수를 기대합니다. 키를 안전하게 보관하세요. 새 키를 생성하면 이전 키가 대체됩니다.

기본 채팅 완성 요청

기본 요청은 메시지를 보내고 텍스트 응답을 받습니다. 모델 ID는 uncensored(검열 없는)입니다. 합법적인 성인 콘텐츠를 거부 없이 처리합니다. 토큰 사용량에 따라 지불합니다. 오류와 거부는 무료입니다. 컨텍스트 윈도우는 총 100,000토큰을 유지합니다.

system 메시지와 user 메시지로 요청을 구조화합니다. API는 완료를 반환합니다. max_tokens을 설정하여 출력 길이를 제어할 수 있습니다. 기본 출력 제한은 2,048 토큰입니다. 요청당 16,000 토큰까지 높일 수 있습니다. 스트리밍은 SSE를 통해 작동합니다. 함수 호출이 가능합니다. JSON 모드가 지원됩니다.

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

요청 본문은 8 MB로 제한됩니다. 분당 요청 수는 300개입니다. 동시성은 최대 8개 요청입니다. 재시도 로직은 서버 과부하를 우아하게 처리합니다.

SSE를 사용한 스트리밍 응답

스트리밍은 생성되는 대로 토큰을 전달합니다. 서버는 서버 전송 이벤트를 보냅니다. 각 청크에는 부분 텍스트가 포함됩니다. 마지막 청크에는 토큰 사용량 통계가 포함됩니다. 이 접근 방식은 긴 응답의 지각된 지연 시간을 줄입니다. 채팅 인터페이스에 이상적입니다. 스트림을 올바르게 처리해야 합니다. 연결이 끊어질 수 있습니다. API는 스트림 자체를 넘어 전달 순서를 보장하지 않습니다.

stream 매개변수를 true로 설정합니다. 데이터 줄을 파싱합니다. 내용을 연결합니다. finish_reason을 확인하여 완료를 확인합니다. Uncensored 모델은 모든 OpenAI 호환 SDK와 함께 작동합니다. SSE를 처리하도록 클라이언트를 구성합니다. 토큰 수를 모니터링합니다. 기본 URL은 동일합니다. 인증은 동일합니다. 추가 설정이 필요하지 않습니다.

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)

스트림에 오류가 표시됩니다. 연결을 종료하여 처리하세요. 선불 크레딧은 완료된 토큰에 대해서만 차감됩니다. 이는 중단 시 비용을 절약합니다. 부분적인 쓰레기 출력에 대해서는 요금이 부과되지 않습니다. 시스템은 투명합니다.

도구 및 함수 호출 사용 중

함수 호출은 모델이 코드나 도구를 실행할 수 있게 합니다. 요청 본문에 도구를 정의하십시오. 모델은 도구 호출을 반환합니다. 도구를 실행합니다. 결과를 다시 보냅니다. 모델은 최종 응답을 생성합니다. 이는 복잡한 워크플로우를 가능하게 합니다. 단순한 채팅 래퍼가 아닙니다. API는 도구와 tool_choice를 지원합니다. 에이전트 또는 자동화에 사용하십시오.

tools 배열을 구성합니다. 이름, 설명, 매개변수를 포함합니다. 모델이 도구를 호출할 시기를 결정합니다. 당신은 인수를 구문 분석해야 합니다. 함수를 실행합니다. 출력을 대화에 전달합니다. 모델이 계속합니다. 이 사이클은 최종 답변이 나올 때까지 반복됩니다. 컨텍스트 창은 모든 도구 상호작용을 추적합니다. 토큰 사용량을 추적하세요. 도구 출력으로 인해 비용이 누적됩니다. 마지막 청크에서 사용량을 모니터링하세요.

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)

uncensored 모델은 다양한 도구 스키마를 처리합니다. 콘텐츠 기반 거부가 없습니다. 롤플레이나 기술 작업에 사용하세요. API는 신뢰할 수 있습니다. 오류가 없습니다. 선불 시스템은 공정성을 보장합니다. 흐름을 제어할 수 있습니다. 베이스 URL은 일정합니다. 인증은 간단합니다.

JSON 모드 및 매개변수

JSON 모드는 모델이 유효한 JSON을 출력하도록 강제합니다. response_format을 json_object로 설정하세요. 이는 구조화된 데이터에 유용합니다. 모델은 마크다운 래퍼를 피합니다. 원시 JSON을 반환합니다. 파싱에 사용하세요. 신뢰성을 향상시킵니다. 컨텍스트 창은 여전히 적용됩니다. 토큰에 대해 지불합니다. uncensored 모델은 형식을 존중합니다. 콘텐츠 기반으로 거부하지 않습니다.

매개변수에는 온도, top_p, stop, seed, presence_penalty, frequency_penalty가 포함됩니다. 온도는 무작위성을 제어합니다. top_p는 다양성을 제어합니다. 종료 시퀀스는 생성을 중단합니다. 시드는 재현성을 보장합니다. 존재 및 빈도 패널티는 토큰 사용을 조정합니다. 출력을 정교하게 다듬기 위해 이를 설정하세요. API는 모든 표준 매개변수를 지원합니다. 응답을 튜닝하기 위해 사용하세요. 기본 URL은 동일합니다. 인증도 동일합니다.

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);

오류는 HTTP 상태 코드를 통해 처리됩니다. 401은 유효하지 않은 키를 의미합니다. 402는 크레딧이 부족함을 의미합니다. 429는 속도 제한을 의미합니다. 코드에서 이를 처리하세요. 선불 크레딧은 완료된 토큰에 대해서만 차감됩니다. 이는 공정성을 보장합니다. 부분 출력에는 요금이 부과되지 않습니다. 시스템은 투명합니다. Uncensored 모델은 신뢰할 수 있습니다. 모든 합법적인 작업에 사용하세요.

오류 처리 및 속도 제한

API는 표준 HTTP 상태 코드를 반환합니다. 401은 유효하지 않은 API 키를 나타냅니다. 402는 선불 크레딧 부족을 나타냅니다. 429는レート 제한을 나타냅니다. 제한은 1분당 300회 요청입니다. 동시성은 동시에 8개 요청입니다. 요청 본문은 8 MB로 제한됩니다. 이러한 오류를 우아하게 처리하세요. 지수 백오프로 재시도하세요. uncensored 모델은 합법적인 콘텐츠를 거부하지 않습니다. 오류는 무료입니다. 실패한 요청에 대해 요금이 청구되지 않습니다. 선불 크레딧은 안전합니다. 만료되지 않습니다. 중복 청구의 경우 지원 페이지를 사용하세요. 암호화폐만 가능. USDT 또는 USDC. 보너스 적용.