Документация API для инструментов Uncensored Video
Начните работу с API генерации видео без цензуры за считанные минуты. В этом руководстве описаны аутентификация, форматы запросов, потоковая передача и тарификация для создания конвейеров генерации видео на основе текста.
Базовый URL и аутентификация
API использует стандартный базовый URL, совместимый с OpenAI. Отправляйте запросы по адресу https://api.uncensoredvideo.top/v1. Аутентификация осуществляется с помощью одного API-ключа, созданного при регистрации. Укажите его в заголовке Authorization в виде токена Bearer. Новые аккаунты получают ключ сразу после входа через Google или регистрации по электронной почте. Номер телефона не требуется. Ключ остается активным до его ручной замены; предоплаченный баланс не сгорает.
Первый запрос
Отправьте запрос POST по адресу /v1/chat/completions с идентификатором модели uncensored. Модель принимает текстовый ввод и возвращает текстовый вывод. Она не генерирует изображения или видео напрямую. Используйте этот эндпоинт для создания промптов, извлечения метаданных или написания сценариев для конвейера генерации видео.
curl https://api.uncensoredvideo.top/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. Установите base_url и api_key в соответствии с эндпоинтами API без цензуры для видео. Это позволяет использовать знакомые методы, такие как client.chat.completions.create. SDK автоматически выполняет сериализацию JSON. Настройте параметры, такие как temperature и top_p, чтобы управлять креативностью. Идентификатор модели всегда uncensored. Вы можете получать ответы потоком или запросить JSON-режим для извлечения структурированных данных.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredvideo.top/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)Этот фрагмент кода демонстрирует стандартный вызов завершения. Он работает с любым клиентом, совместимым с OpenAI. Настройте параметр max_tokens, чтобы управлять длиной вывода. Максимальный вывод по умолчанию составляет 2 048 токенов, если не указано иное.
Использование Node.js SDK
Установите пакет OpenAI для Node.js. Инициализируйте клиент, указав базовый URL https://api.uncensoredvideo.top/v1 и свой API-ключ. Используйте тот же эндпоинт chat.completions, что и в Python. Node SDK поддерживает паттерны async/await для чистой интеграции. Вы можете отправлять несколько сообщений в истории разговора, чтобы сохранить контекст. Модель поддерживает вызов функций, что позволяет определять инструменты для извлечения метаданных.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredvideo.top/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);Этот пример показывает, как выполнить запрос. Объект ответа содержит сгенерированный контент. Вы можете обработать вывод для использования в рабочем процессе производства видео. Убедитесь, что вы правильно обрабатываете ошибки, так как могут возникнуть проблемы с сетью или недействительные ключи.
Потоковые ответы
Включите потоковую передачу, установив значение stream: true в запросе. API возвращает поток Server-Sent Events (SSE). Каждый чанк содержит частичный текст. Последний чанк содержит статистику использования, такую как количество токенов. Потоковая передача снижает воспринимаемую задержку для длинных сценариев или подробных метаданных. Это позволяет вашему приложению отображать прогресс в реальном времени. Это идеально подходит для интерактивных инструментов или отображения текста в прямом эфире.
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)Этот поток обрабатывает чанки по мере их поступления. Данные об использовании в последнем чанке помогают точно отслеживать расходы. Ошибки во время потоковой передачи могут прервать поток, поэтому реализуйте логику повторных попыток, если это необходимо. Модель поддерживает до 100 000 токенов в контекстном окне.
Лимиты, ошибки и контекст
Общий размер контекстного окна — 100 000 токенов. Максимальный объём вывода за один запрос — 32 000 токенов. Вы можете выполнять 300 запросов в минуту и 8 параллельных запросов на ключ. Тело запроса должно быть меньше 8 МБ. Ошибки включают 401 для недействительных ключей и 429 для превышения лимита запросов. Код 402 означает, что недостаточно средств. Предоплаченный баланс списывается только за реальное использование токенов. Ошибки и отказы бесплатны. Баланс не сгорает. Для пробного баланса в $0,50 карта не нужна. Получите этот кредит одним кликом на странице API-ключа. Пополните баланс с помощью USDT или USDC.
Характеристики API
Все реальные лимиты и возможности API в одном месте — сверьте их до пополнения.
| Параметр | Значение |
|---|---|
| Формат API | совместим с OpenAI: любой OpenAI SDK работает — замените base URL и ключ |
| ID модели | uncensored |
| Base URL | https://api.uncensoredvideo.top/v1 |
| Авторизация | Authorization: Bearer YOUR_KEY |
| Эндпоинты | POST /v1/chat/completions · GET /v1/models |
| Максимум ответа | до остатка окна в 100 000 токенов; max_tokens необязателен (отдельного лимита нет) |
| Параметры | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON-режим | response_format: {"type": "json_object"} |
| Контекстное окно | 100 000 токенов (вход и ответ вместе) |
| Потоковая передача | да — server-sent events, последний фрагмент содержит расход токенов |
| Вызов функций | да — tools, tool_choice; ответ содержит tool_calls, в том числе в потоке; результат — сообщением role: tool |
| Параллельные запросы | до 8 одновременно на ключ |
| Размер запроса | до 8 МБ |
| Лимит запросов | 300 запросов в минуту на ключ |
| Заголовки ответа | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| Пополнение | USDT (TRC20) или USDC (Base), любая целая сумма от $20 до $500 |
| Пробный баланс | $0,50 на 7 дней, без карты · Пробный ключ: 2 параллельных запроса, 60 в минуту; полные лимиты (8 и 300) после первого пополнения |
| Срок действия | оплаченный баланс не сгорает, без подписки |
| Бонус | +5% от $50, +10% от $100, +15% от $200 |
| Цена | $0,15 за 1 млн входных токенов · $0,50 за 1 млн выходных |
| Оплата | предоплаченный баланс по фактическому расходу; ошибки и отказы бесплатны |
| Вход | Google или e-mail и пароль |
| Контент | контент для взрослых разрешён; сексуальный контент с несовершеннолетними запрещён |
| Ключи | один активный ключ на аккаунт; новый заменяет старый |
Коды ошибок
Ошибки приходят в JSON с постоянным type; неудачные и отклонённые запросы не оплачиваются.
| Код | Тип | Что значит |
|---|---|---|
400 | bad_request | неверный JSON, пустые сообщения, неверный параметр или превышено окно контекста |
401 | missing_key · invalid_key · key_revoked | нет ключа, ключ неверный или заменён новым |
402 | no_credit | баланс пуст — пополните, работа продолжится сразу |
403 | content_blocked | сексуальный контент с несовершеннолетними — отказ, без оплаты |
404 | not_found | неизвестный эндпоинт |
413 | request_too_large | тело запроса больше 8 МБ |
429 | rate_limited · concurrency | больше 300/мин или 8 параллельно — подождите и повторите |
503 | upstream_busy | модель занята — повторите через несколько секунд |
Вопросы и ответы
Какой размер контекстного окна?
Размер контекстного окна составляет 100 000 токенов, включая промпт и дополнение. Максимальный вывод на запрос — 32 000 токенов. Если max_tokens не задан, лимит составляет 2 048 токенов.
Как обрабатывать лимиты запросов?
Лимит: 300 запросов в минуту и 8 параллельных запросов на ключ. При превышении API возвращает код состояния 429. Реализуйте экспоненциальное замедление в клиенте для корректной обработки повторных попыток.
Что произойдет, если закончится баланс?
Запросы завершаются ошибкой при недостатке средств. API возвращает код состояния 402. Предоплаченный баланс списывается только за фактическое использование токенов. Ошибки и отказы не расходуют средства. Баланс не сгорает, поэтому вы можете пополнить его в любое время.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Вот и вся настройка.