Быстрый старт: API Chat Completions

Предварительные требования и базовый URL

Наш API полностью совместим со стандартным интерфейсом завершения чата OpenAI. Для отправки запросов вам нужен только базовый URL и ключ API. Базовый URL: HTTPS://api.howmuchisanapikey.com/v1. Эта единственная конечная точка обрабатывает всю генерацию текста, не требуя управления несколькими URL-адресами служб или конфигурациями прокси.

Аутентификация проста. Вы должны включить заголовок Authorization со схемой Bearer, за которым следует ваш уникальный ключ. Каждый запрос к конечной точке chat completions требует этого заголовка для проверки аккаунта и отслеживания использования токенов против вашего предоплаченного баланса.

Аутентификация и заголовки

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

Вам не нужно передавать дополнительные заголовки для базовой генерации текста. Однако, если вы используете такие функции, как режим JSON или вызов функций, вы должны установить заголовок Content-Type в application/json. Это сообщает серверу, как правильно разобрать тело вашего запроса.

Отправка вашего первого завершения чата

Отправьте POST-запрос на /v1/chat/completions с историей сообщений и идентификатором модели. Идентификатор модели — "uncensored". Эта модель настроена на ответы без отказов на законный контент для взрослых, художественную литературу или спорные темы. Она не фильтрует контент на основе стандартных политических или социальных норм.

Базовый пример curl для начала работы:

Copycurl https://api.howmuchisanapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a simple hello world function in python"}]
  }'

Ответ будет содержать сгенерированный текст в массиве choices. Вы можете распарсить его напрямую в логику вашего приложения. Каждый запрос расходует входные токены для вашего промпта и выходные токены для ответа модели.

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

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

Последний чанк включает данные об использовании. Этот объект содержит общее количество потребленных входных и выходных токенов запроса. Вы можете использовать эти данные для обновления локального баланса кредита или мониторинга расходов в реальном времени. Потоковая передача идеально подходит для интерфейсов чата, где пользователи ожидают мгновенной обратной связи.

Вызов функций и режим JSON

API поддерживает структурированный вывод через режим JSON и вызов функций. Установите response_format в {"type": "json_object"}, чтобы заставить модель возвращать валидный JSON. Это полезно для извлечения данных или генерации структурированных конфигураций без ошибок парсинга.

Для вызова функций предоставьте массив tools в вашем запросе. Модель ответит tool_calls, если определит, что нужна функция. Затем вы можете выполнить функцию и отправить результат обратно модели. Это позволяет создавать сложные многошаговые процессы без внешней логики парсинга.

Обработка ограничений и ошибок

Ваш лимит составляет 300 запросов в минуту на ключ и 8 одновременных запросов. Если вы превысите эти лимиты, получите ошибку 429 Too Many Requests. Тело ответа будет содержать детали для повторной попытки. Настройте ограничение частоты запросов на стороне клиента, чтобы избежать ненужных повторных попыток.

Если предоплаченные средства исчерпаны, API возвращает ошибку 402 Payment Required. Вы можете пополнить баланс криптовалютой в любое время. Ошибки и отказы бесплатны, поэтому вы платите только за успешную генерацию токенов. Размер контекстного окна составляет 100,000 токенов для промпта и завершения вместе.

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

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

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)