uk ▾

Документація API та кінцеві точки

Цей посібник показує, як підключити ваш клієнт до нашого OpenAI-сумісного API для генерації тексту без цензури. Ви знайдете базовий URL, кроки автентифікації та приклади коду для вашої улюбленої мови програмування.

Створюйте ключ

Аутентифікація та базовий URL

API вимагає дійсний ключ для кожного запиту. Ви генеруєте цей ключ миттєво під час реєстрації через Google або електронну адресу. Передайте ключ в Authorization header за допомогою Bearer схему. Базовий URL для всіх запитів це HTTPS://api.qwenaipricing.com/v1. Ця URL-адреса працює з офіційними SDK OpenAI та будь-яким сумісним клієнтом, просто оновивши базову конфігурацію.

Ендпоінт Chat Completions

Головна кінцева точка POST /v1/chat/completions. Він приймає тіло JSON з messages масив та model поле. Встановіть ідентифікатор моделі на "uncensored", щоб отримати доступ до великої мовної моделі, налаштованої на необмежені результати. Ви можете визначити ролі system, user та assistant для структурування контексту розмови.

curl https://api.qwenaipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
  }'

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

Інтеграція SDK Python

Використовуйте офіційний openai Python-пакет для взаємодії з API. Ініціалізуйте клієнта, надавши свій API-ключ та встановивши базову URL-адресу на нашу кінцеву точку. Це дозволяє використовувати знайомі методи, такі як chat.completions.create() без переписування логіки клієнта. Бібліотека автоматично виконує серіалізацію JSON та парсинг відповідей.

from openai import OpenAI

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

Передавайте свої повідомлення як список словників. SDK підтримує всі стандартні параметри, такі як temperature та top_p. Цей підхід забезпечу сумісність із існуючими кодовими базами, які очікують OpenAI-compatible інтерфейс.

Інтеграція SDK Node.js

SDK для Node.js працює подібно до версії для Python. Встановіть openai пакет і налаштуйте базовий URL та ключ API. Потім ви можете викликати кінцеву точку завершення чату з бажаними параметрами. Цей метод ідеально підходить для серверних додатків або бекенд-сервісів, яким потрібно генерувати текст асинхронно.

import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenaipricing.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 керує HTTP-з'єднанням та обробкою помилок за вас. Ви також можете використовувати GET /v1/models ендпоінт для перевірки доступного ідентифікатора моделі.

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

Увімкніть потокову передачу, встановивши 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)

Останній фрагмент у потоці містить загальне використання токенів для запиту. Ви можете відстежувати споживання вашого передоплаченого кредиту, моніторячи цю статистику використання. Помилки під час потокової передачі можуть достроково перервати з'єднання.

Ліміти, помилки та контекстне вікно

Модель підтримує контекстне вікно розміром 100,000 токенів для спільного запиту та відповіді. Максимальний обсяг виводу за запит становить 16,000 токенів. Якщо ви не встановите max_tokens, ліміт становить 2 048 токенів. Вам доступно 300 запитів на хвилину та 8 одночасних запитів на ключ. Помилка 429 вказує на перевищення цих лімітів. Запити з помилками або відхиленнями не споживають кредит. API не надає гарантій SLA або сертифікацій.

Поширені запитання

Яке обмеження вікна контексту для моделі без фільтрів?

Модель підтримує контекстне вікно розміром 100,000 токенів для спільного запиту та відповіді. Ви можете згенерувати до 16,000 токенів в одному запиті.

Як обробляти помилки автентифікації?

Помилка 401 вказує на недійсний або відсутній API-ключ. Переконайтеся, що ключ передається в заголовку Authorization як Bearer-токен. Згенеруйте новий ключ у панелі керування обліковим записом, якщо поточний анульовано.

Чи підтримує API генерацію зображень, подібну до Qwen Image?

Ні, цей API надає лише генерацію тексту через кінцеву точку chat-completions. Він не підтримує вбудовування (embeddings), аудіо, відео чи генерацію зображень. Для цих модальностей вам потрібно використовувати іншу кінцеву точку або сервіс.

Отримайте свій API-ключ

Зареєструйтеся, візьміть ключ, оновіть кінцеву точку. Це все.

Створюйте ключ