Perus-URL ja todennus
Käytä annettua perus-URL-osoitetta ja voimassa olevaa API-avainta yhdistääksesi asiakasohjelman. Päätepiste on https://api.qwencodeapikey.com/v1. Sinun on sisällytettävä avaimesi kenttään Authorization header jokaisessa pyynnössä. Tämä varmistaa, että palvelu tunnistaa esimaksatun tilisi oikein.
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"}]
}'
Voit luoda avaimen Google- tai sähköpostitunnuksella rekisteröitymissivulla. Avain ilmestyy välittömästi. Säilytä se turvassa, koska se hallinnoi kuluasi.
Chat Completions Endpoint
Lähetä viestit osoitteeseen /v1/chat/completions päätepiste tekstimäisten vastausten saamiseen. Tämä on standardikäyttöliittymä useimmille OpenAI-SDK:ille. Määrität model kuten uncensored and provide a list of messages in the messages taulukkoa. API käsittelee syötteesi ja palauttaa luodun täydennyksen.
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)
Varmista, että asiakasohjelmistokirjastosi osoittaa oikeaan perus-URL:iin. Mallitunnus uncensored aktivoi avoin painomalli, joka on hienosäädetty vähäisempien kieltojen varmistamiseksi. Se käsittelee keskusteluvuoroja kuten mikä tahansa muu chat-API.
Mallien päätepiste
Kysely GET /v1/models varmistaa saatavilla olevat mallit ja niiden tiedot. Tämä päätepiste palauttaa luettelon avaimellesi saatavilla olevista malleista. Se auttaa vahvistamaan uncensored malli on aktiivinen ja valmis pyyntöjä varten. Käytä tätä asiakasmääritysten vianetsintään ennen täysien kuormien lähettämistä.
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);
Tarkista vastauksen rakenne varmistaaksesi, että SDK:si osaa jäsentää mallilistan oikein. Tämä päätepiste ei kuluta krediittejä, joten se on turvallinen alustuksen tarkistuksiin.
Pyyntöparametrit ja suoratoisto
Tukee vakioparametreja kuten temperature, top_p, stop, ja seed. Ota streamaus käyttöön asettamalla stream: true. API lähettää tokenit Server-Sent Events (SSE) -virran kautta. Token-käytön tilastot ilmestyvät virran viimeisessä palautusosuudessa. Tämä mahdollistaa tuotetun tekstin näyttämisen reaaliajassa.
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)
Aseta max_tokens hallitsemaan tuotoksen pituutta. Oletusarvo on 2 048 tokeniä. Voit lisätä tätä enintään 16 000 tokeniin pyyntöä kohden. Säädä parametreja tasapainottaaksesi luovuutta ja tarkkuutta vastauksissasi.
Nopeusrajoitukset ja rajoitukset
Jokainen avain sallii 300 pyyntöä minuutissa ja 8 samanaikaista pyyntöä. Pyynnön maksimirunkokoko on 8 MB. Nämä rajat estävät väärinkäytön ja varmistavat vakaan suorituskyvyn. Jos ylität nopeusrajoituksen, saat 429-virheen. Säädä asiakasohjelman logiikkaa käsittelemään uudelleenyrittämiset eksponentiaalisella viiveellä.
Konteksti-ikkuna tukee yhteensä 100 000 tokenia. Tämä sisältää sekä prompt- että completion-tokenit. Suurten kontekstien hallinta vaatii huolellista tokenhallintaa rajojen pysymiseksi.
JSON-tila ja funktiokutsut
Käyttö response_format: {"type": "json_object"} rakenteiseen tulokseen. Tämä varmistaa, että malli palauttaa kelvollisen JSON-tiedon, joka on hyödyllistä ohjelmalliseen integraatioon. Funktiokutsut toimivat kautta tools parametri. Määrittele työkalut standardissa OpenAI-muodossa. Malli kutsuu toimintoja tarpeen mukaan.
Virheet ja hylkäykset eivät kuluta luottopisteitä. Tämä pätee myös, jos malli hylkää pyynnön kovaa sisältörajoitusta vastaan. Maksat vain todellisesta token-käytöstä. Luotto ei vanhene, joten voit ladata sen milloin tahansa.
Virheenkäsittely ja käyttö
Käsittele HTTP-virheet sujuvasti. 401-virhe tarkoittaa virheellistä tai vanhentunutta API-avainta. 402-virhe tarkoittaa, että esimaksusaltoni on loppu. 429-virhe tarkoittaa nopeusrajoituksen ylittymistä. Tarkista vastauksen runko yksityiskohtaisten virheviestien saamiseksi.
Käyttö seurataan avainten mukaan. Yksi aktiivinen avain per tili yksinkertaistaa laskutusta. Jos teet virheen, kuten kaksoisperinnän, käytä Tuki-sivua. Saldoa ei palauteta, mutta se pysyy voimassa. Virheet ovat ilmaisia, joten epäonnistuneet pyynnöt eivät kuluta saldoasi.
Yhteenveto ja parhaat käytännöt
Aloita perus-URL-osoitteella ja kelvollisella avaimella. Käytä uncensored mallin tunnus vähemmille kieltäytymisille. Streamaa vastaukset käyttäjäkokemuksen parantamiseksi. Valvonta nopeusrajoja välttääksesi keskeytyksiä. Käytä JSON-tilaa rakenteellisille tiedoille. Käsittele virheet luotettavuuden ylläpitämiseksi. Luotto on esimaksullinen eikä se vanhene koskaan. Täytä kryptolla tarvittaessa. Tämä API sopii saumattomasti olemassa oleviin OpenAI-koodikantoihin. Uusia SDK:ita ei tarvita. Vaihda vain base URL ja avain.