API 문서

Base URL 및 인증

전용 엔드포인트를 가리키고 고유한 API 키를 전달하여 애플리케이션을 연결하세요. 모든 요청의 베이스 URL은 https://api.apertusapp.com/v1. Google 또는 이메일로 가입한 직후 키를 얻습니다. API 키 받기 페이지입니다. 이 키를 Authorization 모든 요청에 대한 header.

Copycurl https://api.apertusapp.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run curl test with empty headers"}]
  }'

각 계정은 활성 키를 하나 생성합니다. 새 키를 생성하면 이전 키가 즉시 무효화됩니다. 이는 구독 등급이나 유휴 요금 없이 접근을 엄격히 통제합니다.

첫 번째 요청

원시 필터링되지 않은 텍스트를 받기 위해 채팅 completion 엔드포인트에 첫 번째 프롬프트를 보내세요. 모델 ID를 사용하세요 uncensored 합법적인 성인 및 논쟁적인 주제에 최적화된 특정 오픈 웨이트 모델에 접근하세요.

Copyfrom openai import OpenAI

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

API는 다음과 같은 표준 매개변수를 허용합니다. temperature 및 top_p오류와 거부는 토큰을 소비하지 않으므로 실제로 모델에 도달한 것에만 지불합니다. 이 접근 방식은 라우팅 오버헤드에 대해 요금을 부과하는 애그리게이터에 비해 비용을 예측 가능하게 유지합니다.

Node SDK 통합

공식 Node SDK를 사용하여 JSON 모드와 함수 호출을 효율적으로 처리하세요. 설정 response_format 수신하여 {"type": "json_object"} 구조화된 출력 또는 에이전트와 같은 동작을 위한 도구를 정의할 수 있습니다.

Copyimport OpenAI from "openai";

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

이 모델은 도구 호출을 지원합니다. tool_choice 옵션입니다. 또한 seed 결정론적 결과. 이 유연성은 OpenAI 호환 생태계를 벗어나지 않고도 복잡한 애플리케이션을 구축할 수 있게 합니다.

스트리밍 응답

낮은 지연 시간의 사용자 경험을 위해 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)

스트리밍은 최종 사용자의 지각된 지연 시간을 줄입니다. 사용자가 생각을 바꾸면 스트림을 중단할 수 있습니다. API는 SSE 프로토콜을 자동으로 처리하므로 사용자 측의 코드 요구사항이 최소화됩니다.

컨텍스트 창 및 용량

이 모델은 입력과 출력을 합쳐 100,000개의 토큰을 처리할 수 있는 컨텍스트 윈도우를 지원합니다. 요청당 최대 16,000 토큰까지 지정하거나, 생략 시 2,048 토큰으로 기본값이 설정됩니다. max_tokens.

이 큰 창은 광범위한 문서 분석 또는 긴 대화 기록을 가능하게 합니다. 그러나 요청 본문은 8 MB 미만으로 유지하십시오. 이 모델은 GPT나 Llama가 아니며, 특정 사용 사례에 최적화된 별개의 무검열 AI 모델입니다.

오류 처리 및 제한

견고한 애플리케이션 흐름을 유지하기 위해 표준 HTTP 오류를 우아하게 처리하세요. A 401 유효하지 않거나 누락된 API 키를 나타내는 오류입니다. A 402 미리 충전한 크레딧이 고갈되었음을 의미합니다. A 429 분당 300회 또는 최대 8개의 동시 요청 한도를 초과했음을 나타냅니다.

크레딧은 만료되지 않으므로 사용 중단을 나중에 다시 시작할 수 있습니다. 중복 청구 같은 오류는 지원 페이지를 통해 해결됩니다. 선불 크레딧은 실제 토큰 소비에 대해서만 청구되므로 바이트 단위로 투명한 가격 책정을 보장합니다.