API 문서: 빠른 시작 가이드

Base URL 및 인증

Heretic AI API는 완전히 OpenAI 호환입니다. 클라이언트를 당사 기본 URL로 가리켜 상호작용합니다: https://api.hereticai.cc/v1인증은 계정당 단일 API 키에 의존하며, Google 또는 이메일로 가입 시 즉시 생성됩니다. 이 키를 다음에 전달하세요: Authorization Bearer 토큰으로 헤더를 사용합니다. 모델 식별자는 단순히 uncensored. 이 단일 모델은 라우팅 복잡성 없이 모든 요청을 처리합니다. 401 오류는 유효하지 않은 키를, 402 오류는 추가 선불 크립토 크레딧이 필요함을 나타냅니다.

Copycurl https://api.hereticai.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "generate twenty test cases"}]
  }'

채팅 완료 엔드포인트

를 사용하여 텍스트 요청을 보내세요 POST /v1/chat/completions 엔드포인트입니다. API는 대화 기록 또는 프롬프트를 포함하는 표준 messages 배열을 기대합니다. 생성된 텍스트를 choices 배열입니다. 이는 순수 유틸리티 API입니다: 텍스트 입력, 텍스트 출력. 소비된 토큰에 대해서만 지불합니다. 선불 크레딧은 만료되지 않으며, 거부나 오류는 토큰 비용을 차지하지 않습니다. 이 방식은 구독 잠금과 예측 불가능한 무료 티어를 제거합니다.

Copyfrom openai import OpenAI

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

스트리밍 응답 (SSE)

실시간 토큰 스트리밍을 활성화하려면 stream: true 요청에 포함됩니다. API는 생성된 각 토큰에 대해 서버 전송 이벤트(SSE)를 반환합니다. 이를 통해 출력을 점진적으로 표시할 수 있으며, 이는 지연 시간에 민감한 애플리케이션에 중요합니다. 토큰 사용량 통계는 스트림의 마지막 청크에 나타납니다. 이 기능은 SSE를 자동으로 처리하는 표준 OpenAI SDK와 원활하게 작동합니다. 전체 완료를 기다리지 않고 즉각적인 피드백을 제공합니다.

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는 tools 및 tool_choice 매개변수입니다. 요청에 도구 스키마를 정의하면 모델은 적절한 경우 구조화된 함수 호출을 반환합니다. 이는 LLM이 다음 행동을 결정해야 하는 복잡한 워크플로우를 가능하게 합니다. 특정 도구 사용을 강제하거나 모델이 자유롭게 선택하도록 할 수 있습니다. 이 기능은 외부 시스템이나 데이터베이스와 상호작용하는 에이전트형 애플리케이션 구축에 필수적입니다.

JSON 모드

결정론적 출력을 위해 설정을 보장하세요. response_format 수신하여 {"type": "json_object"}. 모델은 응답을 유효한 JSON으로 제한하여 프로그래밍 파싱에 필수적입니다. 이는 사후 처리 정규식 수정의 필요성을 줄입니다. 출력이 코드에서 직접 소비될 수 있음을 보장합니다. 이는 구조화된 데이터 추출이나 구성 생성 작업에 특히 유용합니다.

매개변수 및 한도

temperature 및 top_p와 같은 표준 매개변수를 사용하여 생성 제어 temperature, top_p, 그리고 seed. 컨텍스트 윈도우는 프롬프트 및 완성을 합쳐 100,000 토큰입니다. 최대 출력은 요청당 16,000 토큰이며, 2,048은 max_tokens 설정되지 않음). 속도 제한은 분당 300회 요청과 키당 8개의 동시 요청입니다. 요청 본문은 8 MB 미만이어야 합니다. 이러한 제한은 개발자를 위한 안정적인 대용량 사용을 보장합니다.

Node.js

Copyimport OpenAI from "openai";

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