Быстрый старт для конвейеров Vibevoice

Необходимые условия

Перед интеграцией убедитесь, что у вас есть активная учётная запись. Зарегистрируйтесь через Google или электронную почту на странице получения API-ключа, чтобы сразу получить уникальный ключ. Для пробного баланса в $0.50 карта не нужна. Наша модель без цензуры обслуживает модель с идентификатором "uncensored" через стандартный эндпоинт. Базовый URL — https://api.vibevoice.top/v1.. Эта настройка совместима с любым OpenAI SDK и является готовой заменой для многих существующих конвейеров.

Аутентификация

Передавайте ваш API-ключ в заголовке Authorization. Формат должен быть "Bearer YOUR_API_KEY". Если ключ отсутствует или недействителен, API возвращает ошибку 401. Поскольку мы фокусируемся на обработке текста, убедитесь, что ваш конвейер передает только текстовые данные. Ключ привязан к одной учетной записи; генерация нового ключа мгновенно заменяет старый. Эта простота позволяет быстро итерировать в среде разработки.

Отправка запроса

Выполните POST-запрос к /v1/chat/completions. Укажите идентификатор модели, ваши сообщения и любые параметры. Вот базовый пример с использованием curl:

Copycurl https://api.vibevoice.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 от OpenAI. Настройте базовый URL так, чтобы он указывал на наш сервис. Передайте свой API-ключ в качестве параметра api_key. Это позволяет использовать знакомые методы, такие как client.chat.completions.create(). Это API совместимо с OpenAI, поэтому ваша существующая структура кода, вероятно, потребует минимальных изменений. Этот метод идеально подходит для обработки на стороне сервера или задач извлечения данных.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.vibevoice.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)

Помните об обработке исключений. Сетевые ошибки или лимиты запросов могут прервать ваш конвейер. Логирование ответа помогает отладить причины отказа или неожиданного вывода для конкретного промпта.

Интеграция с Node SDK

Для сред JavaScript используйте пакет npm openai. Установите свойства apiKey и baseURL в объекте конфигурации. Это гарантирует, что запросы будут отправляться на правильный эндпоинт. SDK для Node.js поддерживает те же параметры, что и версия для Python. Он идеально подходит для веб-серверов или граничных функций, которым требуется генерация текста по запросу.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.vibevoice.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 возвращает данные частями по мере их генерации. Это полезно для отображения в реальном времени или прогрессивного рендеринга текста. Последний чанк содержит полную статистику использования токенов. Потоковая передача снижает воспринимаемую задержку для конечных пользователей.

Copystream = 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)

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