Быстрый старт API Wu Shencha

Базовая настройка

API Wu Shencha предоставляет стандартный интерфейс, совместимый с OpenAI. Вам нужно задать базовый URL и API-ключ в коде. Базовый URL фиксирован: https://api.wushenchaapi.com/v1. Идентификатор модели — uncensored, это настроенная модель с открытыми весами, предназначенная для сценариев без цензуры и поддерживающая законный контент для взрослых.

Ключ отображается на странице «Получить API-ключ» после регистрации. Поскольку API совместим с OpenAI, вы можете напрямую изменить параметр base_url в официальном SDK для подключения. Дополнительная настройка маршрутизации или сложные настройки не требуются.

Интерфейс чата и дополнения

Используйте эндпоинт POST /v1/chat/completions для отправки текстовых запросов. Интерфейс принимает стандартный формат сообщений и возвращает сгенерированный текст. Это базовый способ взаимодействия, подходящий для большинства сценариев генерации текста.

Тело запроса должно содержать поля model, messages и другие. Убедитесь, что размер тела запроса не превышает 8 МБ. При недействительном ключе или недостатке средств 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 можно использовать официальный SDK openai. Просто укажите URL эндпоинта API Wu Shencha в параметре base_url и передайте ваш 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. Это обеспечивает согласованность между языками и снижает затраты на обучение.

Поддерживаются асинхронные запросы и обработка ошибок. Вы можете легко интегрировать SDK в существующие приложения Node.js. Обратите внимание на обработку асинхронных обратных вызовов или обещаний, чтобы избежать блокировок.

复制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 МБ. Эти ограничения обеспечивают стабильность сервиса. Вы можете сгенерировать новый ключ в любое время, чтобы аннулировать старый.