Базова URL-адреса та аутентифікація
Використовуйте наданий базовий URL та дійсний API-ключ для підключення вашого клієнта. Кінцева точка — https://api.qwencodeapikey.com/v1. Ви повинні включити свій ключ у Authorization header кожного запиту. Це гарантує, що служба правильно ідентифікує ваш обліковий запис передоплаченого кредиту.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Ви можете згенерувати ключ через Google або електронну пошту на сторінці реєстрації. Ключ з'являється миттєво. Зберігайте його в безпеці, оскільки він контролює ваші витрати.
Ендпоінт Chat Completions
Надсилайте повідомлення до /v1/chat/completions ендпоінт для отримання текстових відповідей. Це стандартний інтерфейс для більшості SDK OpenAI. Ви визначаєте model як uncensored і надайте список повідомлень у messages масив. API обробляє ваш вхід і повертає згенероване завершення.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Переконайтеся, що ваша бібліотека клієнта вказує на правильну базову URL-адресу. ID моделі uncensored активує модель з відкритими вагами, налаштовану на меншу кількість відмов. Вона обробляє діалоги так само, як і будь-який інший API чату.
Кінцева точка Models
Запит GET /v1/models перевірити доступні моделі та їх деталі. Ця точка доступу повертає список моделей, доступних для вашого ключа. Це допомагає підтвердити uncensored модель активна і готова до запитів. Використовуйте це для налагодження конфігурацій клієнта перед надсиланням повних тіл запиту.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Перевірте структуру відповіді, щоб переконатися, що ваш SDK правильно парсить список моделей. Цей ендпоінт не споживає кредит, тому його безпечно використовувати для перевірок під час ініціалізації.
Параметри запиту та потокова передача
Підтримка стандартних параметрів, таких як temperature, top_p, stop, а також seed. Увімкніть потокову передачу, встановивши stream: true. API надсилає токени через події, що надсилаються сервером (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)
Встановити max_tokens для контролю довжини виводу. Значення за замовчуванням становить 2 048 токенів. Ви можете збільшити це значення до 16 000 токенів за запит. Налаштуйте параметри, щоб збалансувати креативність та точність у ваших відповідях.
Ліміти частоти та обмеження
Кожен ключ дозволяє 300 запитів на хвилину та 8 одночасних запитів. Максимальний розмір тіла запиту становить 8 МБ. Ці ліміти запобігають зловживанням та забезпечують стабільну продуктивність. Якщо ви перевищите ліміт, отримаєте помилку 429. Налаштуйте логіку клієнта для обробки повторних спроб з експоненційним сповільненням.
Вікно контексту підтримує загальну кількість 100 000 токенів. Це включає як prompt, так і completion. Великі контексти вимагають ретельного керування токенами, щоб залишатися в межах лімітів.
Режим JSON та виклик функцій
Використовувати response_format: {"type": "json_object"} для структурованого виводу. Це гарантує, що модель повертає валідний JSON, корисний для програмної інтеграції. Виклик функцій працює через tools параметр. Опишіть інструменти у стандартному форматі OpenAI. Модель буде викликати функції за потреби.
Помилки та відмови не споживають кредит. Це стосується навіть випадків, коли модель відхиляє запит через жорстке обмеження контенту. Ви платите лише за фактичне використання токенів. Кредит ніколи не прострочується, тому ви можете поповнити його, коли зручно.
Обробка помилок та використання
Обробляйте HTTP помилки коректно. Помилка 401 вказує на недійсний або прострочений API-ключ. Помилка 402 означає, що ваш попередньо оплачений кредит вичерпано. Помилка 429 сигналізує про перевищення ліміту швидкості. Перевірте тіло відповіді для отримання детальних повідомлень про помилки.
Використання відстежується за ключем. Один активний ключ на акаунт спрощує билінг. Якщо ви зробили помилку, наприклад, подвійний заряд, скористайтеся сторінкою Підтримка. Кредит не повертається, але залишається дійсним. Помилки безкоштовні, тому невдалі запити не виснажують ваш баланс.
Резюме та найкращі практики
Почніть з базового URL та дійсного ключа. Використовуйте uncensored ідентифікатор моделі для меншої кількості відмов. Потокова передача відповідей для кращого користувацького досвіду. Моніторинг лімітів швидкості для уникнення переривань. Використовуйте режим JSON для структурованих даних. Обробляйте помилки для підтримки надійності. Кредит є попередньо оплаченим і ніколи не закінчується. Поповнюйте криптовалютою, коли це потрібно. Цей API бездоганно інтегрується в існуючі кодові бази OpenAI. Нових SDK не потрібно. Просто змініть базову URL-адресу та ключ.
