Basis-URL en authenticatie
Gebruik de verstrekte basis-URL en een geldige API-sleutel om je client te verbinden. Het eindpunt is https://api.qwencodeapikey.com/v1. Je moet je sleutel opnemen in de Authorization header van elk verzoek. Dit zorgt ervoor dat de service je vooruitbetaalde account correct identificeert.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
Je kunt een sleutel genereren via Google of e-mail op de aanmeldpagina. De sleutel verschijnt direct. Bewaar deze veilig, omdat deze je uitgaven beheert.
Chat Completions Endpoint
Stuur berichten naar de /v1/chat/completions endpoint om tekstantwoorden te ontvangen. Dit is de standaardinterface voor de meeste OpenAI SDK's. Je definieert de model als uncensored en geef een lijst met berichten in de messages array. De API verwerkt je invoer en retourneert een gegenereerde voltooiing.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
Zorg ervoor dat uw clientbibliotheek verwijst naar de juiste basis-URL. De model-ID uncensored activeert het open-weight model dat is afgestemd op minder weigeringen. Het behandelt gespreksbeurten net als elke andere chat-API.
Modellen Eindpunt
Query GET /v1/models naar beschikbare modellen en hun details te verifiëren. Dit eindpunt retourneert een lijst met modellen die toegankelijk zijn voor je sleutel. Het helpt je de uncensored model is actief en klaar voor verzoeken. Gebruik dit voor het debuggen van client-configuraties voordat je volledige payloads verstuurt.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
Controleer de responsestructuur om te verzekeren dat uw SDK de modellijst correct parsen kan. Dit eindpunt verbruikt geen credit, waardoor het veilig is voor initialisatiecontroles.
Verzoekparameters en Streaming
Ondersteuning voor standaardparameters zoals temperature, top_p, stop, en seed. Schakel streaming in door stream: true. De API verzendt tokens via Server-Sent Events (SSE). Gegevens over token-gebruik verschijnen in de laatste chunk van de stream. Dit stelt je in staat gegenereerde tekst real-time weer te geven.
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)
Instellen max_tokens om de lengte van de uitvoer te bepalen. De standaardwaarde is 2.048 tokens. Je kunt dit verhogen tot 16.000 tokens per verzoek. Pas parameters aan om creativiteit en precisie in je antwoorden in balans te brengen.
Rate Limits en beperkingen
Elke sleutel staat 300 verzoeken per minuut en 8 gelijktijdige verzoeken toe. De maximale grootte van de verzoekbody is 8 MB. Deze limieten voorkomen misbruik en zorgen voor stabiele prestaties. Als je de limiet overschrijdt, ontvang je een 429-foutmelding. Pas je clientlogica aan om herhaalde pogingen te verwerken met exponentiële backoff.
Het contextvenster ondersteunt in totaal 100.000 tokens. Dit omvat zowel prompt als completion. Grote contexten vereisen zorgvuldig tokenbeheer om binnen de limieten te blijven.
JSON-modus en functaanroeping
Gebruik response_format: {"type": "json_object"} voor gestructureerde uitvoer. Dit zorgt ervoor dat het model geldige JSON retourneert, nuttig voor programmatische integratie. Function calling werkt via de tools parameter. Definieer tools in het standaard OpenAI-formaat. Het model zal functies aanroepen wanneer dat nodig is.
Fouten en weigeringen verbruiken geen credit. Dit geldt zelfs als het model een verzoek weigert vanwege de harde contentlimiet. Je betaalt alleen voor daadwerkelijk tokengebruik. Credit verloopt niet, dus je kunt bijbetalen wanneer het jou schikt.
Fouthantering en Gebruik
Afhandelen van HTTP-fouten op een beheersbare manier. Een 401-fout geeft een ongeldige of verlopen API-sleutel aan. Een 402-fout betekent dat je vooruitbetaalde krediet op is. Een 429-fout signaleert dat de limiet is overschreden. Controleer het antwoordlichaam voor gedetailleerde foutberichten.
Gebruik wordt per sleutel bijgehouden. Één actieve sleutel per account vereenvoudigt de facturering. Als je een fout maakt, zoals een dubbele charge, gebruik dan de Support-pagina.tegoed wordt niet terugbetaald maar blijft geldig. Fouten zijn gratis, dus mislukte verzoeken putten je saldo niet uit.
Samenvatting en Beste Praktijken
Begin met de basis-URL en een geldige sleutel. Gebruik de uncensored model-ID voor minder weigeringen. Stream responsen voor een betere gebruikerservaring. Monitor rate limits om onderbrekingen te vermijden. Gebruik JSON-modus voor gestructureerde gegevens. Verwerk fouten om betrouwbaarheid te behouden. Tegoed is prepaid en verloopt nooit. Laad bij met crypto wanneer nodig. Deze API past naadloos in bestaande OpenAI-codebases. Geen nieuwe SDK's vereist. Verander gewoon de basis-URL en sleutel.
