Документація API Queen

Базова URL-адреса та аутентифікація

Аутентифікація використовує стандартний Bearer-токен, який передається в Authorization header. Цей підхід забезпечує сумісність із існуючими SDK OpenAI без необхідності додавання спеціальної логіки. Ваш API_KEY генерація ключа відбувається миттєво після реєстрації через Google або електронну пошту. Усі запити мають надходити на вказану базову URL-адресу для цього сервісу.

• Базовий URL: https://api.apiqueen.cc/v1
• Заголовок: Authorization: Bearer API_KEY

Copycurl https://api.apiqueen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Return current status for service api queen"}]
  }'

Відправка запитів на /v1/chat/completions

Надсилайте текстові дані до кінцевого пункту, щоб отримати прямі відповіді моделі. Ідентифікатор моделі завжди uncensored, що обробляє різноманітні теми без стандартних відмов. Ви можете вказати такі параметри, як temperature та top_p для контролю креативності. Система очікує список повідомлень у стандартному форматі чату.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

Параметри моделі: Температура, Top-P та Stop

Керуйте генерацією відповідей за допомогою стандартних параметрів LLM. Встановіть temperature між 0 та 2 для різного рівня випадковості. Використовуйте top_p щоб відфільтрувати слова з низькою ймовірністю. Визначте stop послідовності для зупинки виводу за певними тригерами. Ці налаштування дозволяють точно налаштувати генерацію для творчого письма або отримання фактичних даних.

API ігнорує неподтримувані параметри коректно. Зосередьтеся на temperature, top_p, а також stop для оптимальних результатів. Налаштуйте ці значення відповідно до толерантності вашого додатка до шуму.

Потокові відповіді та використання токенів

Увімкніть потокову передачу, встановивши stream: true у вашому запиті. API повертає фрагменти даних через події, надіслані сервером (SSE). Деталі використання токенів з'являються лише в останньому фрагменті потоку. Це дозволяє відображати відповіді в інтерфейсі користувача в реальному часі.

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)

Обробляйте часткові відповіді обережно. Переконайтеся, що ваш клієнт буферизує дані до закриття потоку.

Function Calling та режим JSON

Використовуйте виклик функцій для видобутку структурованих даних. Визначте інструменти в tools параметр. Модель повертає дійсний JSON, коли response_format встановлено на {"type": "json_object"}. Це забезпечує послідовне розбирання в додатках нижнього рівня.

Встановити tool_choice щоб примусово забезпечити конкретні виклики функцій. Це корисно для автоматизованих робочих процесів, що вимагають суворих форматів виводу.

Обробка помилок та ліміти частоти запитів

Моніторьте коди стану HTTP для виявлення поширених проблем. Помилка 401 означає, що ваш API-ключ недійсний. Помилка 402 вказує на недостатність передоплачених кредитів. Помилки не споживають баланс токенів. Обмеження швидкості встановлюють ліміт у 300 запитів на хвилину на один ключ. Кількість одночасних запитів обмежена 8. Вікно контексту підтримує загальну кількість до 100,000 токенів.

Обробляйте повторні спроби з експоненційним відступом. Перевірте error об'єкт у відповідях JSON для деталей.