Pierwsze zapytanie w pięć minut

Zainstaluj SDK OpenAI

Nasz endpoint korzysta ze standardowego protokołu chat.completions, więc możesz użyć oficjalnych SDK dla wybranego języka. Dla Pythona zainstaluj pakiet przez pip. Dla Node.js użyj npm. Biblioteki te obsługują serializację, ponawianie i strumieniowanie.

pip install openai

npm install openai

Upewnij się, że używasz najnowszej wersji SDK, aby obsługiwać wszystkie parametry, takie jak tool_choice i response_format. Biblioteka klienta zarządza żądaniami HTTP, więc skup się tylko na strukturze ładunku.

Skonfiguruj Base URL i Klucz

Skieruj klienta na nasz dedykowany endpoint. Nie musisz zmieniać logiki nazwy modelu; oczekujemy, że przekażesz model: "uncensored" w swoich zapytaniach. Uwierzytelnianie odbywa się za pomocą prostego klucza API przekazanego w nagłówku.

Ustaw base_url na https://api.qwenapi.top/v1. Wygeneruj swój qwen api key w panelu. Klucz jest wyświetlany od razu po zalogowaniu się. Nie jest wymagany numer telefonu ani karta kredytowa do początkowej konfiguracji.

Podstawowe zapytanie Chat Completion

Wyślij standardowe zapytanie uzupełniające. Model zwraca odpowiedzi tekstowe bezpośrednio. Nie ma złożonych warstw routingu; rozmawiasz z jedną instancją dostrojoną do wyjść bez cenzury.

Poniżej znajduje się minimalny przykład użycia curl do weryfikacji łączności i formatu odpowiedzi.

Copycurl https://api.qwenapi.top/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."}]
  }'

Odpowiedź zawiera wygenerowany tekst w choices[0].message.content. Możesz dostosować parametry, takie jak temperature i top_p, aby kontrolować kreatywność.

Odpowiedzi strumieniowe

Aby generować tokeny w czasie rzeczywistym, włącz strumieniowanie. Serwer wysyła zdarzenia wysyłane przez serwer (SSE). Ostatni fragment zawiera statystyki użycia tokenów, pozwalając na dokładne śledzenie zużycia kredytu.

Copyfrom openai import OpenAI

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

Strumieniowanie jest niezbędne dla długich wyjść. Możesz parsować strumień i renderować tokeny po ich napływaniu. SDK automatycznie parsuje SSE.

Wsparcie dla wywoływania funkcji

Zdefiniuj narzędzia w swoim zapytaniu. Model zwraca strukturalne wywoływanie funkcji. Wykonujesz narzędzie, przesyłasz wynik z powrotem, a model kontynuuje. Działa to z tool_choice i standardowymi definicjami funkcji.

Copyimport OpenAI from "openai";

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

Tryb JSON jest również dostępny przez response_format. Użyj go, gdy potrzebujesz ścisłego wyjścia JSON bez narzutu narzędzi.

Limity, błędy i kontekst

Okno kontekstu wynosi 100 000 tokenów łącznie. Maksymalne wyjście na zapytanie to 32 000 tokenów (2,048 jeśli nieokreślone). Limity zapytań to 300 zapytań na minutę i 8 równoległych zapytań na klucz. Ciała zapytań muszą mieścić się w 8 MB.

Obsługuj błędy: 401 oznacza nieprawidłowy klucz, 402 oznacza niewystarczający kredyt, 429 oznacza przekroczenie limitu zapytań. Błędy są darmowe; płacisz tylko za zużyte tokeny. Kredyt nigdy nie wygasa. Jeśli doładujesz podwójnie, skorzystaj ze strony Wsparcie w celu naprawienia problemu.

Strumieniowanie

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)