Документация по API Ablated ai

Аутентификация: Использование вашего API-ключа

Ваш API-ключ аутентифицирует каждый запрос, который вы отправляете на наши серверы. Мы выдаем один ключ на аккаунт, который вы генерируете через панель управления. Передайте этот ключ в Authorization Заголовок с использованием схемы Bearer. Если вы отправите недействительный ключ, мы вернем ошибку 401. Если ваш предоплаченный кредит исчерпан, мы вернем ошибку 402, требующую пополнения через криптовалюту перед продолжением.

Базовый URL и структура конечных точек

Направляйте все запросы на наш единый базовый URL для завершения диалога. Мы не предоставляем эндпоинты для эмбеддингов, генерации изображений или дообучения. Используйте стандартный POST /v1/chat/completions путь для отправки ваших промптов. Вы также можете запросить GET /v1/models проверить доступный идентификатор модели. Эта структура обеспечивает совместимость с существующими клиентами SDK OpenAI без пользовательской логики маршрутизации.

Быстрый старт: Ваш первый запрос с ablated AI

Отправьте простой текстовый запрос для немедленного тестирования uncensored модели. Используйте официальную библиотеку OpenAI или любой HTTP-клиент для отправки сообщения методом POST. Модель возвращает текстовый ответ без фильтрации законного контента для взрослых. Замените заполнитель ключа на ваши фактические учетные данные из панели управления.

Copycurl https://api.aiablated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the current version of the api"}]
  }'

Этот запрос демонстрирует базовый поток взаимодействия. Вы получаете прямой ответ от абляционной модели. Настройте системный промпт, чтобы определить личность или контекст для вашего конкретного случая использования.

Интеграция Python SDK

Используйте официальную библиотеку OpenAI для Python для интеграции API в ваши приложения. Установите базовый URL и API-ключ в конфигурации клиента. Этот подход автоматически обрабатывает сериализацию и парсинг ошибок. Вы можете потоково передавать ответы или получать их синхронно. Клиентская библиотека управляет жизненным циклом соединения за вас.

Copyfrom openai import OpenAI

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

Этот фрагмент кода правильно инициализирует клиент. Он указывает на наш конкретный базовый URL. Убедитесь, что вы установили последнюю версию пакета openai для полной совместимости с функциями потоковой передачи и вызова функций.

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

Интегрируйте API в ваши проекты JavaScript или TypeScript с помощью стандартного SDK. Настройте base URL, указывающий на наш сервис. Это позволяет использовать знакомые методы, такие как chat.completions.create. SDK обрабатывает заголовки запросов и разбор ответов. Вы можете легко добавить обработку ошибок при превышении лимитов или сбоях аутентификации.

Copyimport OpenAI from "openai";

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

Эта конфигурация обеспечивает корректное взаимодействие вашего Node-приложения. Переопределение базового URL — это ключевой шаг. Без него SDK попытается подключиться к облаку OpenAI, а не к нашим серверам.

Потоковые ответы и использование токенов

Получайте ответы по одному токену, используя Server-Sent Events (SSE). Это снижает воспринимаемую задержку для длинных выводов. Последний чанк потока содержит общее количество токенов, использованных для запроса. Вы можете отслеживать расход предоплаченного баланса в реальном времени. Установите stream: true в полезной нагрузке запроса для включения этого режима. Это идеально подходит для интерфейсов чата и генерации текста в реальном времени.

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)

Этот подход с потоковой передачей обеспечивает плавный пользовательский опыт. Последний чанк содержит статистику использования. Отслеживайте эти показатели, чтобы эффективно управлять предоплаченным кредитом. Ошибки во время потоковой передачи обрабатываются SDK корректно.