Bas URL och autentisering
Använd den tillhandahållna bas-URL:n och en giltig API-nyckel för att ansluta din klient. Slutpunkten är https://api.qwencodeapikey.com/v1. Du måste inkludera din nyckel i Authorization header i varje begäran. Detta säkerställer att tjänsten identifierar ditt förbetala kontokonto 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 generera en nyckel via Google eller e-post på registreringssidan. Nyckeln visas omedelbart. Förvara den säker, eftersom den styr dina utgifter.
Slutpunkt för chattkomplettering
Skicka meddelanden till /v1/chat/completions slutpunkt för att få textsvar. Detta är det standardgränssnittet för de flesta OpenAI SDK:er. Du definierar model som uncensored och tillhandahåll en lista med meddelanden i messages array. API:t bearbetar din inmatning och returnerar en genererad komplettering.
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)
Se till att ditt klientbibliotek pekar på rätt bas-URL. Modell-ID:t uncensored aktiverar den öppna modell som är optimerad för färre avslag. Den hanterar konversationella växlingar precis som vilken chatt-API som helst.
Modelländpunkt
Fråga GET /v1/models till att verifiera tillgängliga modeller och deras detaljer. Denna slutpunkt returnerar en lista över modeller som är tillgängliga för din nyckel. Det hjälper dig att bekräfta uncensored modellen är aktiv och redo för begäranden. Använd detta för att felsöka klientkonfigurationer innan du skickar fulla laster.
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);
Kontrollera response-strukturen för att säkerställa att ditt SDK parser modelllistan korrekt. Denna slutpunkt förbrukar ingen kredit, vilket gör den säker för initieringskontroller.
Begäranparametrar och strömning
Stöd för standardparametrar som temperature, top_p, stop, och seed. Aktivera streaming genom att ange stream: true. API:et skickar tokens via Server-Sent Events (SSE). Statistik över tokenanvändning visas i den sista chunken av strömmen. Detta möjliggör visning av genererad text 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)
Ställ in max_tokens för att styra utmatningslängd. Standardvärdet är 2 048 tokens. Du kan öka detta upp till 16 000 tokens per begäran. Justera parametrar för att balansera kreativitet och precision i dina svar.
Begränsningar för begäranderänta och begränsningar
Varje nyckel tillåter 300 förfrågningar per minut och 8 samtidiga förfrågningar. Den maximala storleken på förfrågningskroppen är 8 MB. Dessa gränser förhindrar missbruk och säkerställer stabil prestanda. Om du överskrider hastighetsgränsen får du ett 429-fel. Justera din klientlogik för att hantera omförsök med exponentiell backoff.
Kontextrutan stöder totalt 100 000 tokens. Detta inkluderar både prompt och svar. Stora kontexter kräver noggrann tokenhantering för att hålla sig inom gränserna.
JSON-läge och funktionsanrop
Använd response_format: {"type": "json_object"} för strukturerad utdata. Detta säkerställer att modellen returnerar giltig JSON, användbart för programmatisk integration. Functon calling fungerar via tools parameter. Definiera verktyg i standard OpenAI-format. Modellen kommer att anropa funktioner vid behov.
Fel och avvisningar förbrukar inte kredit. Detta gäller även om modellen avvisar en förfrågan på grund av den hårda innehållsgränsen. Du betalar endast för faktisk tokenanvändning. Kredit löper aldrig ut, så du kan fylla på när det passar.
Felfhantering och användning
Hantera HTTP-fel elegant. Ett 401-fel indikerar en ogiltig eller utgången API-nyckel. Ett 402-fel betyder att ditt förbetalda kredit är slut. Ett 429-fel signalerar överskriden hastighetsbegränsning. Kontrollera svarskroppen för detaljerade felmeddelanden.
Användning sparas per nyckel. En aktiv nyckel per konto förenklar faktureringen. Om du gör ett misstag, till exempel en dubbel debitering, använder du sidan för Support. Kredit återbetalas inte men är fortfarande giltig. Fel är gratis, så misslyckade begäran tömmer inte ditt saldo.
Sammanfattning och bästa praxis
Börja med bas-URL:en och en giltig nyckel. Använd den uncensored modell-ID för färre avslag. Strömsvar för bättre användarupplevelse. Övervaka hastighetsbegränsningar för att undvika avbrott. Använd JSON-läge för strukturerad data. Hantera fel för att upprätthålla tillförlitlighet. Kredit är förbetald och går aldrig ut. Fyll på med krypto vid behov. Detta API passar sömlöst in i befintliga OpenAI-kodbaser. Inga nya SDK:er krävs. Byt bara bas-URL och nyckel.
