Автентифікація та API-ключі
Почніть із створення облікового запису, щоб миттєво отримати API-ключ. Ви можете зареєструватися через Google або за електронною адресою та паролем без необхідності вказувати номер телефону. Система генерує один активний ключ на обліковий запис, і створення нового ключа миттєво замінює старий. Вам потрібна лише електронна адреса для початку, а ваші промпти не використовуються для навчання. Використовуйте цей ключ у Authorization header як Bearer-токен для всіх запитів.
Перший запит
Зробіть свій перший запит на кінцеву точку завершення чату, використовуючи свій API-ключ. Базовий URL https://api.aidphn.com/v1 і сумісна зі стандартними клієнтами, сумісними з OpenAI. Ви повинні вказати модель uncensored для доступу до unfiltered великої мовної моделі. Помилки та відмови не споживають ваші попередньо оплачені кредити, тому ви можете тестувати безпечно.
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.
Інтеграція SDK Python
Використовуйте офіційну Python-бібліотеку OpenAI для взаємодії з нашим ендпоінтом. Встановіть базовий 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);
Обробляйте відповіді, парсуючи поле вмісту з об’єкта завершення. 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, щоб продовжувати використовувати сервіс без перерв.