Wu Shencha API 빠른 시작

기본 구성

Wu Shencha API는 표준 OpenAI 호환 인터페이스를 제공합니다. 코드에서 기본 URL과 API 키를 설정해야 합니다. 기본 URL은 https://api.wushenchaapi.com/v1로 고정됩니다. 모델 ID는 uncensored이며, 이는 무검열 환경에 특화된 파인튜닝된 오픈 웨이트 모델로 lawful adult 콘텐츠를 지원합니다.

키는 등록 후 'API 키 받기' 페이지에서 표시됩니다. API가 OpenAI 호환이므로 공식 SDK의 base_url 매개변수만 수정하면 바로 연동할 수 있습니다. 추가 라우팅 구성이나 복잡한 설정이 필요하지 않습니다.

채팅 완성 인터페이스

POST /v1/chat/completions 엔드포인트를 사용하여 텍스트 요청을 보냅니다. 이 인터페이스는 표준 메시지 형식을 받아 생성된 텍스트를 반환합니다. 이는 대부분의 텍스트 생성 시나리오에 적합한 기본 상호작용 방식입니다.

요청 본문에는 model, messages 등의 필드가 포함되어야 합니다. 요청 본문 크기가 8 MB 이하여야 합니다. 키가 유효하지 않거나 잔액이 부족하면 API가 해당 오류 코드를 반환합니다.

复制curl https://api.wushenchaapi.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 SDK를 사용할 수 있습니다. base_url을 Wu Shencha API의 엔드포인트로 지정하고 API 키를 전달하면 됩니다. 이 방법은 OpenAI 네이티브 코드와의 일관성을 유지하여 마이그레이션을 용이하게 합니다.

최신 버전의 SDK를 설치하세요. 코드 예시는 클라이언트 초기화 및 메시지 전송 방법을 보여줍니다. 이 방식은 간결하고 효율적이며 빠른 프로토타이핑에 적합합니다.

复制from openai import OpenAI

client = OpenAI(base_url="https://api.wushenchaapi.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 개발자도 openai npm 패키지를 사용하여 연결할 수 있습니다. Python과 마찬가지로 baseURL과 apiKey을 설정합니다. 이는 언어 간 일관성을 보장하고 학습 비용을 줄여줍니다.

비동기 요청 및 오류 처리를 지원합니다. 기존 Node.js 애플리케이션에 쉽게 통합할 수 있습니다. 블로킹을 피하기 위해 비동기 콜백 또는 Promise 처리에 유의하세요.

复制import OpenAI from "openai";

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

스트리밍

Server-Sent Events (SSE)를 통한 스트리밍을 지원합니다. stream: true 매개변수를 설정하면 API는 응답 데이터를 청크 단위로 반환합니다. 이는 실시간 애플리케이션이나 긴 텍스트 생성에 유용하며 더 낮은 지연 시간을 제공합니다.

스트리밍 응답은 모델의 동작을 변경하지 않으며 데이터 전송 방식만 바꿉니다. 필요에 따라 스트리밍 또는 비스트리밍 모드를 선택할 수 있습니다.

复制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)

제한 사항 및 할당량

분당 최대 300회 요청이 가능합니다. 컨텍스트 창은 100,000개의 토큰입니다(프롬프트와 완성을 포함). 제한을 초과하면 API가 429 오류를 반환합니다. 키가 유효하지 않으면 401, 잔액이 부족하면 402를 반환합니다.

선불 크레딧은 만료되지 않으며 월 구독료가 없습니다. 요청당 본문 크기는 8 MB로 제한됩니다. 이러한 제한은 서비스 안정성을 보장합니다. 기존 키를 무효화하려면 언제든지 새 키를 생성할 수 있습니다.