Руководство по интеграции для разработчиков

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

Начните с генерации вашего API-ключа на панели управления. Базовый URL — HTTPS://api.apiaicheap.com/v1. Передайте ключ в заголовке Authorization в виде Bearer-токена.

• Нажмите «Получить API-ключ» и войдите через Google или электронную почту.
• Copy the key immediately; it is shown only once.

Этот ключ аутентифицирует все запросы к конечной точке завершения чата.

Пример заголовка

Авторизация: Bearer YOUR_API_KEY

Первый запрос с cURL

Отправьте базовое завершение чата для проверки вашей настройки. Используйте эндпоинт POST /v1/chat/completions с моделью "uncensored".

Это подтверждает ваш баланс кредитов и задержку.

• Установите роль в "user".
• Сделайте сообщение простым для первого теста.

Проверьте ответ на наличие поля с сгенерированным текстом.

• Ищите значение "content".

Если вы получаете 200 OK, ваша интеграция работает.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

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

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

Этот подход автоматически обрабатывает повторные попытки и парсинг JSON.

• Установите библиотеку через pip.
• Укажите параметр base_url на нашу конечную точку.

Вызовите метод chat.completions.create.

Передайте список ваших сообщений в качестве аргумента.

• Включите имя модели "uncensored".

Получите доступ к тексту ответа через атрибуты объекта.

Этот метод чист и удобочитаем для производственных скриптов.

Copyfrom openai import OpenAI

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

Настройка SDK Node.js

SDK для Node.js работает аналогично версии для Python. Инициализируйте клиент, указав ключ и наш базовый URL.

Это позволяет использовать знакомые паттерны async/await.

• Импортируйте пакет OpenAI.
• Настройте базовый URL в конструкторе.

Создайте запрос на генерацию с вашими сообщениями.

Обработка обещания для получения результата.

• Извлеките содержимое сообщения из ответа.

Логгируйте вывод, чтобы убедиться, что модель отвечает корректно.

Эта конфигурация идеальна для веб-серверов и бэкенд-сервисов.

Copyimport OpenAI from "openai";

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

Потоковая передача ответов с SSE

Включите потоковую передачу, установив stream в true в запросе. API возвращает фрагменты по мере их генерации через события, отправляемые сервером (SSE).

Это снижает воспринимаемую задержку для пользователей в чат-приложениях.

• Установите stream: true в полезной нагрузке.
• Обрабатывайте каждый фрагмент по мере поступления.

Соедините чанки, чтобы сформировать окончательный ответ.

Подробности об использовании токенов появляются в последнем чанке.

• Проверьте поле "usage" в последнем чанке.

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

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)

Лимиты, ошибки и контекстное окно

В вашем аккаунте лимит составляет 300 запросов в минуту на ключ. Окно контекста поддерживает 100,000 токенов в сумме для промпта и завершения.

Ошибки обрабатываются через стандартные коды состояния HTTP.

• 401 указывает на недействительный или отсутствующий API-ключ.
• 402 означает, что ваш предоплаченный кредит исчерпан.
• 429 сигнализирует о превышении лимита скорости.

Отказы не стоят кредита. Ошибки тоже бесплатны.

Макс. вывод составляет 16 000 токенов на запрос. Установите max_tokens, если нужно меньше.

Эта структура обеспечивает предсказуемое выставление счетов и производительность.