통합 가이드

빠른 시작: 첫 번째 요청 보내기

API는 Chat Completions 구조를 반영한 오픈소스 호환 API입니다. 텍스트를 입력하면 텍스트가 반환됩니다. 임베딩이나 오디오를 위한 불필요한 엔드포인트가 워크플로우를 복잡하게 만들지 않습니다. 클라이언트의 기본 URL을 저희 주소로 지정하는 것으로 시작하세요.

• Base URL: HTTPS://api.filtrosemia.com/v1
• 모델 ID: "uncensored"

SDK 구성의 기존 기본 URL을 교체하세요. 이 엔드포인트는 일반적인 필터 없이 역할극부터 번역까지 모든 작업을 처리합니다.

Copycurl https://api.filtrosemia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "check balance"}]
  }'

인증 및 헤더

표준 Authorization 헤더에 API 키를 전달하세요. 단순함을 위해 계정당 하나의 활성 키를 사용합니다. 새 키가 필요하면 대시보드에서 생성하세요.

• 헤더: Authorization: Bearer YOUR_API_KEY
• 관리해야 할 OAuth 흐름 또는 갱신 토큰 없음.

키는 안전하게 보관하세요. 이 키는 선불 크레딧에 직접 접근합니다. 오류와 같은 401 Unauthorized 키가 누락되었거나 유효하지 않음을 의미합니다.

Copyfrom openai import OpenAI

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

채팅 완료 엔드포인트

다음으로 메시지 전송 POST /v1/chat/completions. 모델은 다음과 같은 표준 매개변수를 지원합니다: temperature, top_p, 그리고 stop 시퀀스. 이 모델은 성인 및 창작 콘텐츠에 맞게 조정된 무검열 모델입니다.

• 지원함 json_object 응답 형식을 확인하세요.
• 함수 호출을 위한 도구 정의 받음.

요청은 속도 제한 내에서 순차적으로 처리됩니다. 페이로드가 8MB 미만인지 확인하세요.

Copyimport OpenAI from "openai";

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

실시간 토큰 전달을 위해 Server-Sent Events를 사용하세요. 이는 긴 출력에 대한 지각된 레이턴시를 줄입니다. 마지막 청크에는 완전한 토큰 사용량 통계가 포함됩니다.

• 設定 stream: true 요청에 포함됩니다.
• 클라이언트에서 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)

컨텍스트 윈도우 및 제한

이 모델은 100,000개의 토큰 컨텍스트 창을 지원합니다. 이를 통해 긴 기록이 있는 무거운 워크로드를 처리할 수 있습니다. 최대 출력은 요청당 16,000개 토큰입니다.

• 기본 최대 출력: 2,048 토큰.
• 속도 제한: 분당 300회 요청.

제한 초과 시 429 Too Many Requests 동시 요청 수를 조정하여 한도 내에 머무르십시오. 키당 최대 8개의 동시 요청이 허용됩니다.

오류 처리 및 토큰

표준 HTTP 오류 처리. 402 Payment Required 선불 크레딧이 소진되었음을 의미합니다. 429 속도 제한을 나타냅니다. 401 인증 문제를 나타냅니다.

• 에러는 무료입니다. 성공적인 토큰 사용에만 요금이 부과됩니다.
• 콘텐츠 정책으로 인한 거부도 무료입니다.

자세한 오류 메시지를 확인하세요. 이를 사용하여 재시도 로직이나 크레딧 충전 빈도를 조정하세요.