Wu Xianzhi API 빠른 시작 가이드

API 기본 엔드포인트 및 인증

Wu Xianzhi API은 OpenAI 표준 인터페이스와 완전히 호환됩니다. 모든 요청은 https://api.wuxianzhiapi.com/v1로 전송됩니다. 인증을 위해 API 키가 필요하며, 이를 요청 헤더 Authorization: Bearer YOUR_API_KEY에 포함해야 합니다. 등록 후 키가 즉시 생성되며, 기존 키를 무효화하기 위해 언제든지 재생성할 수 있습니다. 당사는 선불 모델을 채택했으며, 크레딧은 만료되지 않고 종량제로 청구되며 구독비는 없습니다.

첫 번째 요청 보내기

curl을 사용하여 API 연결성을 직접 확인할 수 있습니다. 모델 ID를 uncensored로 지정하여 /v1/chat/completions로 POST 요청을 보내세요. 이 모델은 독립적으로 구동되는 오픈 웨이트 모델로, 합법적인 성인 콘텐츠 및 논쟁적인 주제에 대해 무검열 최적화가 되어 있어 콘텐츠 생성을 거부하지 않습니다.

요청 본문에 messages 배열이 포함되어 있는지 확인하세요. 인증에 실패하면 401이 반환되고, 잔액이 부족하면 402가 반환됩니다.

复制curl https://api.wuxianzhiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python SDK 호출 예제

Python 개발자는 공식 openai 라이브러리를 직접 사용할 수 있습니다. base_url을 당사 서버로 지정하고 올바른 API 키를 전달하기만 하면 됩니다. 모델 ID는 uncensored로 고정됩니다. 당사는 텍스트 생성만 지원하며 임베딩 벡터나 멀티모달 기능은 제공하지 않습니다. 이 방식은 구조화된 데이터 상호작용을 쉽게 처리할 수 있는 백엔드 서비스 통합에 적합합니다.

复制from openai import OpenAI

client = OpenAI(base_url="https://api.wuxianzhiapi.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.js SDK 통합

Node.js 개발자도 openai npm 패키지를 사용하여 통합할 수 있습니다. baseURL과 apiKey을 구성한 후 호출 로직은 OpenAI와 동일합니다. 이 무검열 LLM API는 함수 호출을 지원하므로, tools 매개변수를 통해 함수를 정의하면 모델이 실행할 구조화된 JSON을 반환합니다. 이는 제한 없는 AI 앱 구축에 이상적인 백엔드입니다.

复制import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.wuxianzhiapi.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을 설정하는 것이 좋습니다. API는 서버 전송 이벤트(SSE)를 통해 청크화된 응답을 반환합니다. 이는 실시간 대화나 긴 텍스트 생성 시나리오에 중요합니다. 클라이언트는 data 이벤트를 수신하고 JSON 청크를 구문 분석하여 최종 내용을 연결해야 합니다. 스트리밍은 청구 방식을 변경하지 않으며 여전히 입력 및 출력 토큰 총량을 기준으로 계산됩니다.

复制stream = 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 키는 분당 300 요청으로 제한되며, 요청 본문 최대 크기는 8 MB입니다. 컨텍스트 창은 100,000 토큰(프롬프트 및 응답 포함)입니다. 오류 코드: 401은 키가 무효함을, 402는 잔액 부족을, 429는 속도 제한을 나타냅니다. 모델은 미성년자 성 콘텐츠에 대해 하드 필터링을 유지하며, 기타 합법적인 성인 콘텐츠는 무검열입니다. 모델 목록은 GET /v1/models을 통해 가져올 수 있습니다.