URL de bază și autentificare
Folosește URL-ul de bază furnizat și o cheie API validă pentru a conecta clientul. Endpoint-ul este https://api.qwencodeapikey.com/v1. Trebuie să incluzi cheia ta în Authorization header al fiecărei solicitări. Acest lucru asigură că serviciul identifică corect contul tău de credit preplătit.
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"}]
}'
Puteți genera o cheie prin Google sau email pe pagina de înscriere. Cheia apare imediat. Păstrați-o în siguranță, deoarece controlează cheltuielile dumneavoastră.
Endpoint Completări Chat
Trimite mesaje la /v1/chat/completions endpoint pentru a obține răspunsuri text. Aceasta este interfața standard pentru majoritatea SDK-urilor OpenAI. Definești model ca uncensored și furnizați o listă de mesaje în messages array. API-ul procesează inputul tău și returnează un completament generat.
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)
Asigură-te că biblioteca clientului pointează către URL-ul de bază corect. ID-ul modelului uncensored activează modelul open-weight, optimizat pentru a avea mai puține refuzuri. Gestionează turele de conversație exact ca orice altă API de chat.
Endpoint Modele
Interogare GET /v1/models a verifica modelele disponibile și detaliile acestora. Acest endpoint returnează o listă de modele accesibile cheii tale. Te ajută să confirmi uncensored model este activ și gata pentru cereri. Folosește acest lucru pentru depanarea configurațiilor client înainte de a trimite payload-uri complete.
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);
Verificați structura răspunsului pentru a vă asigura că SDK-ul analizează corect lista modelelor. Acest endpoint nu consumă credit, fiind sigur pentru verificările de inițializare.
Parametri de solicitare și Streaming
Suportă parametrii standard precum temperature, top_p, stop, și seed. Activați streaming-ul setând stream: true. API trimite tokenii prin Evenimente trimise de server (SSE). Statisticile de utilizare a tokenilor apar în fragmentul final al fluxului. Acest lucru permite afișarea în timp real a textului generat.
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)
Setează max_tokens pentru a controla lungimea outputului. Valoarea implicită este de 2.048 de tokeni. Poți crește această valoare până la 16.000 de tokeni per solicitare. Ajustează parametrii pentru a echilibra creativitatea și precizia în răspunsurile tale.
Limite de rată și constrângeri
Fiecare cheie permite 300 de cereri pe minut și 8 cereri concurente. Dimensiunea maximă a corpului cererii este de 8 MB. Aceste limite previn abuzul și asigură o performanță stabilă. Dacă depășiți rata de cereri, veți primi un cod de eroare 429. Ajustați logica clientului pentru a gestiona reîncercările cu backoff exponențial.
Fereastra de context suportă un total de 100.000 de tokeni. Acest lucru include atât promptul, cât și completarea. Contextele mari necesită o gestionare atentă a tokenilor pentru a rămâne în limite.
Mod JSON și Apelarea Funcțiilor
Utilizare response_format: {"type": "json_object"} pentru output structurat. Acest lucru asigură că modelul returnează JSON valid, util pentru integrarea programatică. Apelarea de funcții funcționează prin tools parametru. Definește instrumentele în formatul standard OpenAI. Modelul va apela funcțiile după cum este necesar.
Erorile și refuzurile nu consumă credit. Acest lucru se aplică chiar dacă modelul refuză o cerere din cauza limitelor stricte de conținut. Plătiți doar pentru utilizarea reală a tokenilor. Creditul nu expiră niciodată, astfel încât vă puteți reîncărca când este convenabil.
Gestionarea erorilor și utilizarea
Gestionați erorile HTTP cu grijă. O eroare 401 indică o cheie API invalidă sau expirată. O eroare 402 înseamnă că creditul preplătit este epuizat. O eroare 429 semnalează depășirea limitei de rată. Verificați corpul răspunsului pentru mesaje de eroare detaliate.
Utilizarea este urmărită pe cheie. O singură cheie activă per cont simplifică facturarea. Dacă comiți o greșeală, cum ar fi o dublă taxare, folosește pagina de Suport. Creditul nu este rambursat, dar rămâne valabil. Erorile sunt gratuite, astfel încât solicitările eșuate nu îți epuizează soldul.
Sumar și Practici Recomandate
Începeți cu URL-ul de bază și o cheie validă. Utilizați uncensored ID-ul modelului pentru mai puține refuzuri. Streamuiește răspunsuri pentru o experiență mai bună a utilizatorului. Monitorizează limitele de rată pentru a evita întreruperile. Folosește modul JSON pentru date structurate. Gestionează erorile pentru a menține fiabilitatea. Creditul este pre-plătit și nu expiră niciodată. Reîncarcă cu criptomonede când este necesar. Acest API se integrează perfect în codebase-urile existente OpenAI. Nu sunt necesare SDK-uri noi. Doar schimbă URL-ul de bază și cheia.