Base URL og autentificering
Brug den angivne base URL og en gyldig API-nøgle til at forbinde din klient. Endpointet er https://api.qwencodeapikey.com/v1. Du skal inkludere din nøgle i Authorization header i hver anmodning. Dette sikrer, at tjenesten identificerer din forudbetalte kreditkonto korrekt.
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"}]
}'
Du kan generere en nøgle via Google eller e-mail på tilmeldingssiden. Nøglen vises straks. Gem den sikkert, da den styrer dit forbrug.
Chat Completions Endpoint
Send beskeder til /v1/chat/completions endpoint til at få tekstsv. Dette er det standardinterface for de fleste OpenAI SDKs. Du definerer model som uncensored og angiv en liste over meddelelser i messages array. API'et behandler dit input og returnerer en genereret udfyldning.
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)
Sørg for, at dit klientbibliotek peger på den korrekte basale URL. Model-ID'et uncensored aktiverer den åbne model, der er finjusteret til færre afvisninger. Den håndterer samtaletrins lige som ethvert andet chat-API.
Models Endpoint
Forespørgsel GET /v1/models til at verificere tilgængelige modeller og deres detaljer. Dette endepunkt returnerer en liste over modeller, der er tilgængelige for din nøgle. Det hjælper dig med at bekræfte uncensored model er aktiv og klar til anmodninger. Brug dette til at fejlsøge klientkonfigurationer, før du sender fulde payloads.
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);
Tjek responsstrukturen for at sikre, at dit SDK parser modellisten korrekt. Denne endpoint forbruger ikke kredit, hvilket gør den sikker til initialiseringstjek.
Forespørgselsparametre og Streaming
Understøt standardparametre som temperature, top_p, stop, og seed. Aktiver streaming ved at indstille stream: true. API'en sender tokens via Server-Sent Events (SSE). Tokenforbrugsstatistikker vises i den sidste chunk af strømmen. Dette muliggør visning af genereret tekst i realtid.
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)
Indstil max_tokens til at kontrollere outputlængden. Standardværdien er 2,048 tokens. Du kan øge dette op til 16,000 tokens pr. anmodning. Juster parametre for at balancere kreativitet og præcision i dine svar.
Rate Limits og Begrænsninger
Hver nøgle giver 300 requests i minuttet og 8 samtidige requests. Den maksimale request body-størrelse er 8 MB. Disse grænser forhindrer misbrug og sikrer stabil ydeevne. Hvis du overskrider rate limitet, modtager du en 429-fejl. Justér din client-logik til at håndtere retries med eksponentiel backoff.
Kontekstvinduet understøtter i alt 100.000 tokens. Dette inkluderer både prompt og completion. Store kontekster kræver omhyggelig tokenhåndtering for at holde sig inden for grænserne.
JSON-tilstand og funktionskald
Brug response_format: {"type": "json_object"} til struktureret output. Dette sikrer, at modellen returnerer gyldig JSON, nyttig til programmatisk integration. Funktionskald fungerer via tools parameter. Definer værktøjer i standard OpenAI-formatet. Modellen vil kalde funktioner efter behov.
Fejl og afvisninger forbruger ikke kredit. Dette gælder også, hvis modellen afviser en anmodning på grund af den hårde indholdsbegrænsning. Du betaler kun for faktisk tokenforbrug. Kredit udløber aldrig, så du kan opfylde, når det passer dig.
Fejlhåndtering og brug
Håndter HTTP-fejl pænt. En 401-fejl indikerer en ugyldig eller udløbet API-nøgle. En 402-fejl betyder, at din forudbetalte kredit er opbrugt. En 429-fejl signalerer overskredet hastighedsbegrænsning. Tjek responskroppen for detaljerede fejlmeddelelser.
Forbrug spores per nøgle. Én aktiv nøgle pr. konto forenkler faktureringen. Hvis du laver en fejl, f.eks. en dobbeltopkrævning, skal du bruge Support-siden. Kredit refunderes ikke, men forbliver gyldig. Fejl er gratis, så mislykkede anmodninger tømmer ikke din saldo.
Opsummering og bedste praksis
Start med base-URL'en og en gyldig nøgle. Brug den uncensored model-ID til færre afslag. Stream svar for en bedre brugeroplevelse. Overvåg hastighedsbegrænsninger for at undgå afbrydelser. Brug JSON-tilstand til strukturerede data. Håndter fejl for at opretholde pålidelighed. Kreditten er forudbetalt og udløber aldrig. Top op med krypto når det er nødvendigt. Denne API passer sømløst ind i eksisterende OpenAI-kodebaser. Ingen nye SDK'er kræves. Skift bare base URL og nøgle.
