API-dokumentation og endepunkter
Denne guide viser, hvordan du forbinder din klient til vores OpenAI-kpatible API til ukensureret tekstgenerering. Du finder base-URL, autentificeringstrin og kodeeksempler til dit foretrukne sprog.
Autentificering og Base URL
API'en kræver en gyldig nøgle til hver anmodning. Du genererer denne nøgle øjeblikkeligt, når du tilmelder dig med Google eller en e-mail-adresse. Send nøglen i Authorization header ved brug af Bearer skema. Base URL'en til alle anmodninger er HTTPS://api.qwenaipricing.com/v1. Denne URL fungerer med de officielle OpenAI SDK'er og enhver kompatibel klient ved blot at opdatere base-konfigurationen.
Chat Completions Endpoint
Det primære endpoint er POST /v1/chat/completions. Den accepterer en JSON-krop med en messages array og en model felt. Indstil model-ID til "uncensored" for at få adgang til den store sprogmodel indstillet til ubegrænsede output. Du kan definere system-, bruger- og assistentroller for at strukturere din samtalekontekst.
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?"}]
}'
Svaret inkluderer det genererede indhold, forbrugsstatistikker og finish reason. Feil returnerer standard HTTP-koder som 401 for ugyldige nøgler eller 402, hvis din forudbetalte kredit er opbrugt. API'et understøtter ikke embeddings, billedgenerering eller fine-tuning-endpoints.
Python SDK-integration
Brug den officielle openai Python-pakke til at interagere med API'et. Initialiser klienten ved at angive din API-nøgle og indstille base URL til vores endepunkt. Dette giver dig mulighed for at bruge velkendte metoder som chat.completions.create() uden at omskrive din klientlogik. Biblioteket håndterer JSON-serialisering og svarparsning automatisk.
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)
Indtast dine beskeder som en liste af ordbøger. SDK'et understøtter alle standardparametre som temperature og top_p. Denne tilgang sikrer kompatibilitet med eksisterende kodebaser, der forventer et OpenAI-kompatibelt interface.
Node.js SDK-integration
Node.js SDK fungerer lignende Python-versionen. Installer openai pakke og konfigurer base URL og API-nøgle. Du kan derefter kalde chat-completions-endpointet med dine ønskede parametre. Denne metode er ideel til server-side applikationer eller backend-tjenester, der skal generere tekst asynkront.
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);
Håndter strømmen eller promise for at behandle de genererede tokens. SDK'et håndterer HTTP-forbindelsen og fejlhåndtering for dig. Du kan også bruge GET /v1/models endpoint til at verificere den tilgængelige model-ID.
Streaming og forbrug
Aktivér streaming ved at indstille stream: true i din anmodning. API'et returnerer en stream af server-sendte begivenheder (SSE) med delvise svar. Hver del indeholder et uddrag af den genererede tekst. Dette er nyttigt til realtids-brugergrænseflader, der viser tekst, mens den genereres.
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)
Den sidste chunk i streamen indeholder det samlede tokenforbrug for anmodningen. Du kan spore dit forbrug af forudbetalt kredit ved at overvåge disse brugsstatistikker. Fejl under streaming kan afbryde forbindelsen tidligt.
Begrænsninger, fejl og kontekstvindue
Modellen understøtter et kontekstvindue på 100.000 tokens til prompt og completion kombineret. Den maksimale output pr. anmodning er 16.000 tokens. Hvis du ikke indstiller max_tokens, grænsen er 2.048 tokens. Du er begrænset til 300 anmodninger per minut og 8 samtidige anmodninger per nøgle. En 429-fejl indikerer, at du har overskredet disse grænser. Anmodninger med fejl eller afvisninger forbruger ikke kredit. API'et tilbyder ikke SLA-garantier eller certifikater.
Almindelige spørgsmål
Hvad er kontekstvinduet for den ubegrænsede model?
Modellen understøtter et kontekstvindue på 100.000 tokens til prompt og completion kombineret. Du kan generere op til 16.000 tokens i en enkelt anmodning.
Hvordan håndterer jeg autentificeringsfejl?
En 401-fejl indikerer en ugyldig eller manglende API-nøgle. Sørg for, at din nøgle sendes i Authorization-headeren som en Bearer-token. Generer en ny nøgle fra din kontodashboard, hvis den aktuelle er inddraget.
Understøtter API'et billedgenerering som Qwen Image?
Nej, denne API leverer kun tekstgenerering via chat-completions-slutpunktet. Den understøtter ikke embeddings, lyd, video eller billedegenerering. Du skal bruge et andet slutpunkt eller en anden tjeneste til disse modaliteter.