Посібник швидкого старту Qwen api

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

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

Ендпоінт Chat Completions

Надсилайте запити POST до /v1/chat/completions. Використовуйте ідентифікатор моделі "uncensored". Ендпоінт приймає стандартні діалогові повідомлення. Він повертає лише текстові відповіді. Вбудовування (embeddings) та зображення не підтримуються. Налаштуйте параметри, такі як temperature та top_p. Встановіть response_format у json_object для структурованих даних. Виклик функцій доступний через tools. Запити обробляються на наших виділених серверах. Це забезпечує стабільну затримку. Уважно перевіряйте базовий URL. Неправильні URL призводять до помилок 404.

Деталі моделі та обмеження

Розмір контекстного вікна становить 100,000 токенів. Це включає промпт та відповідь. Максимальний обсяг виводу — 16,000 токенів. Максимальне значення за замовчуванням — 2,048 токенів. Ви можете надсилати 300 запитів за хвилину. Паралельність обмежена 8 одночасними запитами. Розмір тіла запиту обмежено 8 МБ. Помилки не споживають кредити. Відмови безкоштовні. Один ключ на акаунт. Замінюйте старі ключі новими. Модель обробляє контент для дорослих. Діти виключені з контенту сексуального характеру. Використовуйте це для кодування або творчого письма. Гарантій SLA не надається. Перевірте ціни для вивчення вартості токенів.

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

Увімкніть потокову передачу, встановивши stream у true. API повертає події, надані сервером (SSE). Використання токенів з'являється в останньому чанку. Це дозволяє відображати дані в реальному часі. Використовуйте це для інтерфейсів чату. Це зменшує сприйнятну затримку. Читайте чанки послідовно. Обережно обробляйте часткові відповіді. Режим JSON працює з потоковою передачею. Виклики функцій також потокові. Відстежуйте кількість токенів. Витрати нараховуються на мільйон токенів. Ввід коштує $0.15. Вивід коштує $0.50. Баланс відстежує використання. Крипто-білінг застосовується. Поповнюйте рахунок за допомогою USDT або USDC.

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

Вирішуйте помилки 401, перевіряючи ключ. Переконайтеся, що заголовок Authorization правильний. Використовуйте помилки 402 для виявлення низького балансу. Поповнюйте баланс через криптовалюту, щоб продовжити. Помилки 429 вказують на ліміти швидкості. Найкраще працює експоненційне сповільнення. Перевірте ліміти паралельності. Не перевищуйте 8 запитів. Розмір тіла має бути менше 8 МБ. Невірний JSON викликає помилки 400. Неизвестні ідентифікатори моделей повертають 400. Логуйте помилки для налагодження. Сторінка підтримки вирішує проблеми з билінгом. Кредити не мають терміну дії. Повернення коштів не здійснюється. Помилки безкоштовні.

Швидкий старт з Python SDK

Встановіть пакет openai. Встановіть базовий URL. Передайте свій API-ключ. Викличте chat.completions.create. Використовуйте модель "uncensored". Встановіть stream у true. Ітеруйте по фрагментах. Виводьте токени. Обробляйте винятки. Закрийте клієнта. Це працює з існуючим кодом. Замініть базовий URL. Зберігайте API-ключ у безпеці. Використовуйте змінні середовища. Тестуйте з невеликими промптами. Перевіряйте використання токенів. Моніторьте витрати. Оновіть до платних кредитів. Тільки криптоплатежі. USDT або USDC. Швидке налаштування.

cURL

Copycurl https://api.apiqwen.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fix syntax error in python function"}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

Потокова передача

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)