API Qwen: первый запрос за пять минут

Базовый URL и аутентификация

Наш API следует стандартному формату OpenAI, что упрощает переключение конфигурации вашего существующего клиента. Базовый URL для всех запросов: https://api.qwenapis.com/v1. Для аутентификации запросов вам понадобится API-ключ. Если вы ещё не создали его, посетите страницу Получить API-ключ, чтобы сгенерировать ключ, используя только email и пароль. Для начала с пробным балансом кредитная карта не требуется.

К одной учётной записи привязан только один активный ключ одновременно. Вы можете сгенерировать новый ключ в любое время, что немедленно аннулирует предыдущий. Это гарантирует, что если ваш ключ будет скомпрометирован, вы сможете мгновенно защитить учётную запись, не ожидая окончания месячного цикла. Храните ключ в безопасном месте, например в переменных окружения или менеджере секретов.

Первый запрос

Проверьте настройку, отправив простой запрос на генерацию текста. В следующем примере используется curl для отправки промпта модели без цензуры. Замените YOUR_API_KEY на ключ, сгенерированный на предыдущем шаге. Идентификатор модели установлен в uncensored, что означает настройку на ответы без отказов в контенте для законного использования взрослыми.

Copycurl https://api.qwenapis.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Если запрос успешен, вы получите JSON-ответ, содержащий сгенерированный текст. Если вы получили ошибку 401, проверьте правильность ключа. Ошибка 402 указывает на то, что ваш предоплаченный баланс исчерпан.

Интеграция Python SDK

Для разработчиков на Python официальный SDK OpenAI работает напрямую с нашим эндпоинтом. Установите библиотеку с помощью pip, затем настройте клиент на указание нашего базового URL. Это позволяет использовать знакомые методы, такие как chat.completions.create(), без существенного изменения логики приложения. SDK обрабатывает сериализацию JSON и логику повторных попыток за вас.

Copyfrom openai import OpenAI

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

Помните правильно установить api_key и base_url. Имя модели остаётся uncensored. Такой подход обеспечивает совместимость с кодом, написанным для других провайдеров, что позволяет легко переключаться или тестировать различные эндпоинты.

Использование Node SDK

Разработчики Node.js могут использовать пакет @anthropic-ai/sdk или официальный пакет openai npm. Настройте клиент с нашим базовым URL и API-ключом. Структура запроса идентична другим сервисам, совместимым с OpenAI. Это позволяет интегрировать Qwen без цензуры в ваши существующие приложения Node.js с минимальными изменениями в коде.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.qwenapis.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 вернёт полный объект завершения, включая статистику использования токенов. Это помогает вам отслеживать расход предоплаченного баланса в реальном времени.

Включение потоковой передачи

Для снижения задержки и улучшения пользовательского опыта включите потоковую передачу в запросах. Потоковая передача отправляет ответ токен за токеном по мере его генерации, позволяя вашему приложению отображать вывод постепенно. Установите параметр stream в значение true в вашем запросе. SDK предоставит итерируемый поток фрагментов.

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)

Это особенно полезно для генерации длинных текстов или интерактивных приложений. Каждый фрагмент содержит частичный текст, который можно добавлять в буфер отображения. Потоковая передача завершается, когда модель завершает ответ или достигает лимита контекста.

Лимиты, ошибки и контекст

Наш API имеет определённые лимиты для обеспечения справедливого использования. Вам разрешено 300 запросов в минуту на ключ. Максимальный размер тела запроса составляет 8 МБ. Контекстное окно равно 100 000 токенов, включая промпт и завершение. Если вы превысите лимит запросов, вы получите ошибку 429. Если вашего баланса недостаточно, вы получите ошибку 402. Для недействительных ключей вы получите ошибку 401. Эти ошибки помогают эффективно управлять потоком приложения и расходом средств.