Документация API и Endpoints
Это руководство показывает, как подключить ваш клиент к нашему OpenAI-compatible API для генерации текста без ограничений. Вы найдете базовый URL, шаги аутентификации и примеры кода для предпочитаемого вами языка.
Аутентификация и базовый URL
API требует действительный ключ для каждого запроса. Вы генерируете этот ключ мгновенно при регистрации через Google или адрес электронной почты. Передайте ключ в Authorization Заголовок с использованием Bearer схему. Базовый URL для всех запросов — HTTPS://api.qwenaipricing.com/v1. Этот URL работает с официальными SDK OpenAI и любым совместимым клиентом, просто обновив базовую конфигурацию.
Эндпоинт Chat Completions
Основная конечная точка — POST /v1/chat/completions. Он принимает тело запроса в формате JSON с messages массив и a 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 не поддерживает эндпоинты для эмбеддингов, генерации изображений или дообучения.
Интеграция Python SDK
Используйте официальный 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 или сертификатов.
Частые вопросы
Каков лимит размера контекстного окна для uncensored модели?
Модель поддерживает контекстное окно объёмом 100 000 токенов для суммарного промпта и завершения. Вы можете сгенерировать до 16 000 токенов в одном запросе.
Как обрабатывать ошибки аутентификации?
Ошибка 401 указывает на недействительный или отсутствующий API-ключ. Убедитесь, что ключ передается в заголовке Authorization в виде токена Bearer. Сгенерируйте новый ключ в панели управления аккаунтом, если текущий был отозван.
Поддерживает ли API генерацию изображений, как Qwen Image?
Нет, этот API обслуживает только генерацию текста через конечную точку chat-completions. Он не поддерживает эмбеддинги, аудио, видео или генерацию изображений. Для этих модальностей вам нужно использовать другую конечную точку или сервис.