FAQ по API без цензуры: регистрация, тарифы, эндпоинты, коды ошибок и границы контента

Регистрация и пробный баланс

Как зарегистрироваться, нужна ли привязка банковской карты?

Зарегистрируйтесь на странице /get-api-key/, используя email и пароль, привязка карты не требуется. После успешной регистрации API-ключ сразу отобразится на странице, ждать проверки не нужно.

Какой размер пробного баланса у нового аккаунта и на какой срок?

Новый аккаунт получает $0.50 бесплатный пробный баланс, действительный 7 дней. По цене $1.00 за миллион токенов этого хватит примерно на 500 000 токенов ответа — достаточно для тестов интеграции и небольших проверок.

Сколько ключей может быть у одного аккаунта? Что делать, если ключ утерян?

У каждого аккаунта только один ключ. Если он утечёт или потеряется, его можно перегенерировать в настройках аккаунта; старый ключ немедленно станет недействительным, и все сервисы, использующие его, начнут получать код 401. После замены синхронизируйте обновление переменной окружения.

Что произойдёт по истечении пробного периода?

После истечения пробного баланса запросы будут возвращать код 402 с ошибкой no_credit. Для продолжения работы просто пополните предоплаченный баланс аккаунта, код менять не нужно.

Тарифы и баланс

Какова цена и как происходит тарификация?

Тарификация за токены: ввод $0,25 / млн токенов, вывод $1,00 / млн токенов. Без подписок и ежемесячных платежей, оплата по факту использования. Полное описание см. на странице цен.

Сгорает ли баланс?

Нет. Пополненный предоплаченный баланс не имеет срока действия, ограничение в 7 дней действует только на пробный баланс $0,50 для новых аккаунтов.

Как узнать стоимость одного запроса?

Поле usage в каждом ответе указывает количество токенов ввода и вывода для данного запроса; умножьте их на тариф, чтобы получить стоимость. В последнем блоке данных потокового запроса также содержится usage; при чтении обратите внимание, что в этом блоке choices представляет собой пустой массив.

Как избежать непредвиденных высоких расходов?

Это достигается двумя способами: ограничение вывода через max_tokens (по умолчанию 2048) и обрезка истории в многошаговом диалоге, чтобы входные данные не раздувались. Так как используется предоплаченный баланс, запросы останавливаются при его исчерпании, и счета сверх баланса не формируется.

Сколько примерно стоит обычный запрос?

Предположим, ввод 2 000 токенов и вывод 500 токенов: ввод стоит около $0,0005, вывод — около $0,0005, итого примерно $0,001, то есть тысяча таких запросов обойдётся примерно в $1. Точные цифры смотрите в поле usage ответа.

Что произойдёт, когда баланс исчерпан?

API возвращает ошибку 402 с кодом no_credit. После пополнения вы можете продолжить работу, не нужно сгенерировать заново API-ключ.

Эндпоинты и параметры

Какой адрес эндпоинта и имя модели?

Base URL: https://api.wuxianzhiapi.com/v1, имя модели всегда uncensored. Доступные эндпоинты: POST /v1/chat/completions и GET /v1/models.

Совместим ли с SDK OpenAI?

Да. Официальный Python-пакет openai версии v1 и выше, а также npm-пакет openai версии v4 и выше работают после изменения base_url и ключа. Примеры см. на странице Примеры кода, руководство по миграции с других API — на странице миграции.

Какова длина контекстного окна? Какое максимальное значение max_tokens?

Контекстное окно — 100 000 токенов, сумма промпта и вывода не должна превышать это значение. max_tokens по умолчанию равен 2048, максимум — 32 000. Тело запроса не должно превышать 8 МБ.

Поддерживается ли потоковая передача и вызов функций?

Поддерживается всё. Для потоковой передачи используйте stream: true; сервер автоматически добавит блок usage в конце. Для вызова функций используется формат OpenAI с параметрами tools и tool_choice; результаты работы инструментов возвращаются в сообщениях со role: "tool".

Почему в конце потокового ответа нет текста?

Это автоматически добавленный блок с метриками использования: массив choices пуст, а usage содержит количество токенов за этот запрос. При парсинге сначала проверяйте, пуст ли массив choices, прежде чем извлекать контент, чтобы избежать ошибки выхода за границы массива.

Есть ли ограничения по частоте запросов?

300 запросов в минуту на каждый API-ключ. При превышении лимита возвращается код 429; просто подождите и повторите запрос. Рекомендуется использовать экспоненциальное замедление.

Поддерживаются ли векторы, изображения, аудио или дообучение?

Не поддерживается. У нас только текстовый диалог, одна uncensored модель, нет эмбеддингов, генерации изображений, аудио, видео и дообучения (fine-tuning).

Коды ошибок

Все ответы об ошибках имеют формат JSON: {"error":{"code":...,"message":...}}. Ниже приведено описание того, как обрабатывать каждый код состояния.

Что означает ошибка 400?

Ошибка в самом запросе. Чаще всего сумма количества токенов в промпте и параметра max_tokens превышает 100 000 токенов, либо нарушен формат JSON или указан неверный тип полей. Необходимо исправить запрос; повторная отправка без изменений не поможет.

Как устранить ошибку 401?

Ключ недействителен или отсутствует. Проверьте заголовок запроса: Authorization: Bearer <ключ>, активны ли переменные окружения, не был ли перегенерирован ключ (старый ключ сразу теряет силу после перегенерации).

Что означает ошибка 402 no_credit?

Баланс исчерпан или истек срок действия пробного баланса. Восстановите доступ, пополнив аккаунт; замена API-ключа не требуется.

Что означает ошибка 403 content_blocked?

Запрос попал под блокировку контента. Сексуальный контент с участием несовершеннолетних блокируется всегда, включая вымышленные сценарии и ролевые игры; это ограничение нельзя изменить. Измените текст запроса и попробуйте снова; повторная отправка того же запроса даст тот же результат.

Что означает ошибка 404?

Обращение к несуществующему эндпоинту. Обычно это связано с ошибкой в URL (например, пропущен сегмент /v1) или обращением к неподдерживаемым функциям, таким как embeddings или генерация изображений.

Как обработать ошибки 429 и 503?

Ошибка 429 означает превышение лимита запросов (300 в минуту). Ошибка 503 имеет код upstream_busy и указывает на временную занятость модели; попробуйте снова через несколько секунд. Для обеих ошибок рекомендуется использовать экспоненциальное замедление (примеры см. на странице с примерами кода).

Границы контента

Значит ли «без цензуры», что генерируется всё что угодно?

Нет. Легальный контент для взрослых, художественные произведения и спорные темы не блокируются. Однако сексуальный контент с участием несовершеннолетних блокируется всегда (возвращается код 403), независимо от того, является ли он вымышленным или частью ролевой игры. Использование должно быть законным.

Для каких пользователей предназначен сервис?

Только для пользователей старше 18 лет. Если вы используете API в продуктах для конечных пользователей, вам необходимо реализовать проверку возраста в своем приложении, а также механизмы жалоб и управления аккаунтами.

Можно ли использовать для ролевых игр, написания романов и игр?

Да, это наиболее типичный сценарий использования. Примеры промптов и оценка стоимости для различных сценариев приведены в статье Сценарии применения.

При каких условиях в ролевых играх возвращается код 403?

Только при срабатывании блокировки контента. Наиболее частая причина — сексуальный контент с участием несовершеннолетних, включая вымышленные сеттинги. Легальный контент между взрослыми не блокируется только из-за того, что это ролевая игра. При получении 403 скорректируйте персонажа или сюжет и повторите запрос.

Достоверны ли факты в выводе модели?

Не обязательно. Отсутствие блокировок не гарантирует точности. Выводы, касающиеся фактов, данных, права или медицины, необходимо проверять самостоятельно перед использованием.

Конфиденциальность

Будет ли мой промпт использоваться для обучения модели?

Нет. Ваши промпты не используются для обучения.

Как правильно хранить API-ключ?

Храните ключ в переменных окружения на сервере. Не помещайте его в код фронтенда, мобильные приложения или публичные репозитории. При подозрении на утечку немедленно сгенерируйте новый ключ в аккаунте; старый станет недействительным мгновенно.

Как обрабатывать пользовательские данные в приложении?

Это зависит от вашего продукта. Рекомендуется отправлять только данные, необходимые для выполнения задачи. Не передавайте в промптах чувствительную информацию (имена, номера удостоверений личности, контактные данные) и четко укажите в своей политике конфиденциальности, как обрабатываются данные.