API 빠른 시작 & 통합

Base URL 및 인증

Heretic 프로젝트는 텍스트 생성을 위한 단일 호스팅 엔드포인트를 제공합니다. 다음을 사용하세요 https://api.hereticproject.com/v1 베이스 URL로 사용합니다. 인증은 Authorization 헤더입니다. 대시보드에서 Google 또는 이메일로 로그인하여 키를 생성하세요. 시스템은 계정당 하나의 활성 키를 발급하며, 새 키를 생성하면 이전 키가 즉시 무효화됩니다.

소모된 토큰에 대해서만 지불합니다. 오류와 거절은 선불 크레딧을 차감하지 않습니다. 신규 계정은 7일 동안 유효한 $0.50의 체험 크레딧을 받습니다. USDT(TRC20) 또는 USDC(Base)를 사용하여 $20에서 $500 사이의 금액으로 충전합니다.

/v1/chat/completions 엔드포인트

표준 채팅 완성 엔드포인트로 메시지를 전송하세요. 모델 ID는 uncensored역할이 있는 메시지 객체 목록을 허용합니다. system, user, 또는 assistant. 모델은 합법적인 성인, 픽션 또는 논쟁적인 주제를 거부하지 않습니다. 직접적인 답변을 위해 조정된 오픈 웨이트 모델입니다.

요청은 생성된 텍스트를 포함하는 JSON 객체를 반환합니다. 컨텍스트 윈도우는 프롬프트와 완성본을 합쳐 100,000 토큰을 지원합니다. 출력은 더 낮은 값을 지정하지 않는 한 요청당 16,000 토큰으로 제한됩니다. max_tokens 값입니다.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK 통합

사용자 정의 base URL이 있는 공식 OpenAI Python 라이브러리를 사용하세요. 설정을 api_key API 문자열에 추가하십시오. 구성 base_url Heretic Project 서버로 연결하세요. 이를 통해 다음과 같은 익숙한 방법을 사용할 수 있습니다. chat.completions.create() 기존 코드 구조를 크게 수정하지 않고도.

pip를 통해 라이브러리를 설치합니다. 자격 증명을 클라이언트 초기화에 직접 전달합니다. 라이브러리는 직렬화를 자동으로 처리합니다. 이 방법은 동기 및 비동기 워크플로우 모두에서 작동합니다. 네트워크 오류를 적절히 처리하세요.

Copyfrom openai import OpenAI

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

Node SDK 통합

Node.js SDK는 Python 버전과 동일하게 작동합니다. API 키와 올바른 베이스 URL로 클라이언트를 초기화합니다. 동일한 메서드 시그니처를 사용하여 completion 요청을 보낼 수 있습니다. 이를 통해 스택의 다양한 부분 간에 일관성을 유지할 수 있습니다.

응답을 비동기적으로 처리하세요. 스트리밍 메서드를 사용하면 SDK가 데이터를 스트림합니다. 그렇지 않으면 전체 JSON 응답을 반환합니다. 이 유연성은 배치 처리와 실시간 인터페이스 모두를 지원합니다. API 키는 환경 변수에 안전하게 보관하세요.

Copyimport OpenAI from "openai";

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

스트리밍 응답 (SSE)

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. 서버는 서버 전송 이벤트(SSE)를 전송합니다. 각 청크에는 부분 텍스트 업데이트가 포함됩니다. 이는 최종 사용자의 지각된 지연 시간을 줄여줍니다. 토큰 사용량 데이터는 스트림의 마지막 청크에 나타납니다.

전체 응답을 누적하기 위해 각 델타 객체를 처리합니다. 스트림이 종료되거나 오류가 발생하면 청취를 중지합니다. 이 방법은 채팅 인터페이스에 이상적입니다. 사용자가 실시간으로 생각이 형성되는 것을 볼 수 있게 합니다. 전체 응답에 비해 오버헤드가 최소화됩니다.

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)

제한 사항, 오류 및 컨텍스트

서비스 중단을 피하기 위해 속도 제한을 준수하세요. 키당 분당 300회 요청이 허용됩니다. 동시성은 최대 8개의 동시 요청으로 제한됩니다. 요청 본문은 8 MB를 초과할 수 없습니다. 이러한 한도를 초과하면 429 상태 코드가 반환됩니다. 잠시 대기 후 다시 시도하세요.

인증 실패 시 키가 유효하지 않거나 만료되면 401 오류가 반환됩니다. 402 오류는 미납 크레딧이 부족함을 나타냅니다. 환불 실수는 지원 페이지를 통해 처리됩니다. 크레딧은 만료되지 않습니다. 모델은 미성년자가 관련된 콘텐츠를 거부합니다. 다른 모든 합법적인 콘텐츠는 허용됩니다.