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

Аутентификация и базовый URL

Начните с перехода на страницу Получить API-ключ и входа через Google или по паролю электронной почты. Вы сразу получите уникальный API-ключ. Используйте базовый URL https://api.xtts.cc/v1 для всех запросов. Этот URL совместим с официальными SDK OpenAI и любым клиентом, поддерживающим формат chat-completions OpenAI.

Добавьте свой ключ в заголовок Authorization в виде токена Bearer. Идентификатор модели, который вы должны указать, — uncensored. Эта модель с открытыми весами размещена на наших серверах и настроена на ответы без отказов по контенту для законного использования взрослыми, обеспечивая ваш голосовой конвейер сырым текстом.

Генерация текста без цензуры

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

Тело запроса включает имя модели, историю ваших сообщений и необязательные параметры, такие как temperature или top_p. Вы можете контролировать длину вывода с помощью параметра max_tokens. Если вы не установите max_tokens, ответ может занять весь контекстный окно.

Копироватьcurl https://api.xtts.cc/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 для взаимодействия с нашим API. Установите значение base_url на наш эндпоинт и укажите ваш API-ключ. Этот подход позволяет использовать существующие структуры кода, одновременно получая преимущества от поведения нашей модели без цензуры.

Создайте экземпляр клиента с базовым URL и вызовите метод chat.completions.create. Передайте идентификатор модели uncensored и ваши сообщения. Объект ответа содержит сгенерированный текст в поле content. Этот метод идеален для пакетной обработки сценариев или интеграции генерации текста в более крупные приложения Python.

Копироватьfrom openai import OpenAI

client = OpenAI(base_url="https://api.xtts.cc/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 используйте Node SDK OpenAI. Настройте клиент с нашим базовым URL и API-ключом. Эта настройка позволяет генерировать текст непосредственно в ваших веб- или серверных приложениях.

Вызовите эндпоинт завершения чата с моделью uncensored. Ответ предоставляет сгенерированный текст, который вы затем можете передать в свой движок синтеза речи. Эта интеграция подходит для генерации текста в реальном времени в веб-приложениях или бэкенд-сервисах, подготавливающих сценарии для клонирования голоса.

Копироватьimport OpenAI from "openai";

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

Лимиты запросов и параметры

Каждый API-ключ ограничен 300 запросами в минуту и 8 параллельными запросами. Тело запроса не должно превышать 8 МБ. Если вы отправите недействительный ключ, вы получите ошибку 401. Если ваш предоплаченный баланс исчерпан, вы получите ошибку 402. Превышение лимита запросов приводит к ошибке 429.

Контекстное окно поддерживает 100,000 токенов суммарно, включая как промпт, так и завершение. Отдельного ограничения на вывод нет, и вы можете указать меньшее значение max_tokens, если хотите получить более короткий ответ. Ошибки и отказы не списывают ваш предоплаченный баланс. Поддержка вызова функций и JSON-режима доступна для извлечения структурированных данных.