Аутентификация и API-ключи
Начните с создания аккаунта, чтобы получить API-ключ мгновенно. Вы можете зарегистрироваться через Google или почту и пароль без необходимости указывать номер телефона. Система генерирует один активный ключ на аккаунт, и создание нового ключа мгновенно заменяет старый. Для начала достаточно только адреса электронной почты, а ваши промпты не используются для обучения. Используйте этот ключ в Authorization header в виде Bearer-токена для всех запросов.
Первый запрос
Выполните свой первый вызов к конечной точке завершения чата, используя ваш API-ключ. Базовый URL — https://api.aidphn.com/v1 и работает со стандартными клиентами, совместимыми с OpenAI. Вы должны указать модель uncensored для доступа к нефильтрованной большой языковой модели. Ошибки и отказы не потребляют ваши предоплаченные кредиты, поэтому вы можете тестировать безопасно.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'
Проверьте работоспособность ключа, проверив конечную точку списка моделей. Это подтверждает подключение перед отправкой сложных запросов. API принимает текст на вход и возвращает текст на выход, поддерживая стандартные параметры, такие как temperature и top_p.
Интеграция Python SDK
Используйте официальную библиотеку OpenAI для Python для взаимодействия с нашим эндпоинтом. Укажите базовый URL на наш API-сервер и предоставьте свой ключ. Этот подход позволяет повторно использовать существующий код из проектов OpenAI без значительных изменений. Идентификатор модели остается uncensored для всех завершений.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)
Вы можете настроить параметры, такие как max_tokens для контроля длины вывода. Максимальный вывод по умолчанию составляет 2 048 токенов, но вы можете увеличить его до 16 000 в одном запросе. Доступно потоковое вещание для длинных ответов, чтобы снизить задержку.
Использование Node SDK
Подключите API к вашим приложениям на Node.js с помощью стандартного SDK. Укажите базовый URL нашего клиента и аутентифицируйтесь с помощью вашего ключа. Этот метод поддерживает как синхронные, так и асинхронные запросы для гибкой интеграции. Вы можете передавать инструменты для вызова функций или включать режим вывода в формате JSON.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);
Обрабатывайте ответы, анализируя поле content из объекта завершения. API поддерживает стандартные параметры, такие как stop последовательности и seed для воспроизводимости. Обработка ошибок должна учитывать ограничения частоты запросов и доступность кредитов.
Потоковые ответы через SSE
Включите потоковую передачу, установив 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)
Потоковая передача снижает воспринимаемую задержку для пользователей, ожидающих длинные ответы. Вы можете обрабатывать токаны инкрементально или буферизовать их для последующего использования. Контекстное окно поддерживает до 100,000 токенов для промпта и завершения в сумме.
Лимиты и ошибки
Отслеживайте использование в рамках строгих лимитов скорости и баланса кредитов. Вы можете отправлять 300 запросов в минуту и иметь 8 одновременных запросов на ключ. Максимальный размер тела запроса составляет 8 МБ. Ошибки, такие как 401, указывают на недействительный ключ, а 402 означает, что вам нужно пополнить баланс. Ошибки 429 сигнализируют о превышении лимита скорости. Пополняйте баланс только криптовалютой, начиная с $20, чтобы продолжить использование сервиса без прерываний.