Integroi API minuuteissa
Lisää uncensored API olemassa olevaan koodirakenteeseesi ja kiertä sisältökieltäytymiset hetkessä. Tämä quickstart-oppaasi läpi base-URL-osoitteen asettamisen, ensimmäisen pyynnön lähettämisen ja streamausvastauksien käsittelyn ilman kitkaa.
Asennus & Base URL -kokoonpano
Määritä asiakasohjelmisto osoittamaan OpenAI-yhteensopivaan päätepisteeseesi heti.
API:namme sijaitsee osoitteessa https://api.codedeepseek.cc/v1. Sinun tarvitsee vain muuttaa base_url ja anna API-avaimesi. Tämä asennus toimii Pythonin ja Node.js:n virallisilla SDK-kirjastoilla, varmistaen olemassa olevan koodin säilymisen ennallaan. Monimutkaista reititystä tai välityspalvelinasetuksia ei tarvita.
Rekisteröidy Google-tilillä tai sähköpostilla saadaksesi avaimesi välittömästi. Puhelinnumeroa ei tarvita, ja avain näkyy näytöllä heti. Tämä yksinkertaisuus mahdollistaa keskittymisen integrointiin hallinnollisten esteiden sijaan.
Todennus
Sisällytä avaimesi Authorization header jokaista pyyntöä varten. Headerin muotoilu on standardi: Authorization: Bearer YOUR_API_KEY. Emme käytä kyselyparametreja todennukseen, pitäen URL-osoitteemme puhtaina ja turvallisina.
Yksi aktiivinen avain per tili varmistaa selkeän käytön seurannan. Jos tarvitset uuden avaimen, sen luominen korvaa vanhan välittömästi. Tämä ominaisuus on hyödyllinen tunnusten kierrätyksessä tuotantoympäristöissä ilman katkosia.
Ensimmäisen pyynnön lähettäminen
Tee vakio chat.completions kutsu luodaksesi tekstiä sensuroimattomasta mallista.
Käytä mallin tunnus uncensored kaikkiin pyyntöihin. Tämä avoin painotusmalli toimii palvelimillamme eikä se hylkää laillista aikuis-, fiktiivistä tai kiistanalaista sisältöä. Se on suunniteltu kehittäjille, jotka haluavat rajoittamattoman tulostuksen koodaukseen ja luoviin tehtäviin.
Seuraava esimerkki demonstroi peruspyyntöä cURL:lla. Korvaa YOUR_API_KEY oikealla avaimellasi.
curl https://api.codedeepseek.cc/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fix the null pointer in the java service class"}]
}'Varmista, että pyynnön runko sisältää messages tietorakenteella, jossa on vähintään yksi käyttäjäviesti. API odottaa tekstisyötettä ja palauttaa tekstitulosteen. Tämä yksinkertaisuus mahdollistaa nopean prototyypin luonnin ilman monimutkaisten pyyntörakenteiden huolet.
Voit testata päättettä suoraan terminaalissa tai skriptissä. Tämä välitön palautesilmus auttaa sinua varmistamaan yhteyden ennen integraatiota suurempiin sovelluksiin.
Streamausvastaukset SSE:n kanssa
Ota reaaliaikainen tokenin tuotto käyttöön asettamalla stream: true pyyntösi.
Server-Sent Events (SSE) toimittavat merkkejä niiden luomisen aikana, mikä vähentää havaittua viivettä pitkissä tulosteissa. Virran viimeinen lohko sisältää pyynnön kokonaismerkkimäärän. Tämä ominaisuus on välttämätön chat-liittymissä, joissa käyttäjät odottavat välittömiä vastauksia.
from openai import OpenAI
client = OpenAI(base_url="https://api.codedeepseek.cc/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)Käsittele virtaa iteroimalla vastausobjektien läpi. Jokainen objekti edustaa yhtä tokenia tai deltaa. Voit liittää nämä delta-arvot yhteen rakentaaksesi täydellisen vastauksen. Tämä lähestymistapa pitää sovelluksesi responsiivisena jopa suurten kuormien aikana.
Streamaus on tuettu kaikissa mallivastauksissa. Käytä sitä parantaaksesi käyttäjäkokemusta koodiapuohjelmissa tai sisällöntuotantotyökaluissa. uncensored-malli käsittelee pitkiä konteksteja tehokkaasti, varmistaen sujuvan streamauksen myös laajojen tulosten yhteydessä.
Funktio Calling & Tools
Integroi ulkoisia työkaluja määrittelemällä funktioita pyyntöpayloadissa.
API tukee vakiotyyppisiä OpenAI-tyylisiä funktiokutsuja. Määrittele työkalusi kohtaan tools parametri ja anna mallin päättää, milloin niitä kutsutaan. Tämä mahdollisuus mahdollistaa monimutkaisten työvuorojen kuten koodin suorittamisen tai tietojen noutamisen.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.codedeepseek.cc/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);Määritä funktion nimi ja kuvaus selkeästi. Malli palauttaa funktiokutsuobjektin, jos se päättää työkalun olevan tarpeen. Suoritat sitten funktion ja syötät tuloksen takaisin keskusteluun.
Tämä ominaisuus on erityisen hyödyllinen koodausagenteille, jotka tarvitsevat suorittaa koodinpätkiä tai hakea dokumentaatiota. Uncensored-malli ymmärtää kontekstin hyvin, mikä vähentää vääriä positiivisia työkalun valinnassa.
Varmista, että työkalumäärittelyt vastaavat odotettua syöttöskeemaa. Epäyhtenevyydet voivat johtaa virheisiin tai odottamattomaan käyttäytymiseen. Testaa työkaluintegraatiotasi perusteellisesti ennen tuotantoon siirtymistä.
JSON-tila rakenteiselle lähdölle
Pakota malli tuottamaan kelvollinen JSON asettamalla response_format vastaan {"type": "json_object"}.
Tämä tila on ihanteellinen sovelluksille, jotka vaativat strukturoitua dataa, kuten konfiguraatiotiedostoja tai API-vastauksia. Malli yrittää noudattaa JSON-syntaksia, mikä vähentää jälkikäsittelyn tarvetta.
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)Käytä JSON-tilaa yhdessä streamauksen kanssa reaaliaikaiseen rakenteellisen datan toimitukseen. Tämä yhdistelmä on tehokas dynaamisten verkkosovellusten rakentamiseen, jotka käyttävät API-dataa.
Vaikka JSON-tila parantaa rakennetta, se voi joskus tuottaa virheellistä JSONia, jos prompti on epäselvä. Tarkista aina tulosteesi sovelluskoodissasi. Tämä lisäaskel varmistaa luotettavuuden tuotantoympäristöissä.
Epäsuodattamaton malli käsittelee monimutkaisia JSON-rakenteita tehokkaasti. Käytä sitä koodinpätkien, konfiguraatioobjektien tai datamuunnosten luomiseen.
Parametrit: lämpötila, Top-P ja siemenluku
Ohjaa tulostesi satunnaisuutta ja toistettavuutta käyttämällä yleisiä parametreja.
Aseta temperature välillä 0 ja 2 vaihtelevaan luovuuteen. Alhaisemmat arvot tuottavat deterministisempiä tuloksia, kun taas korkeammat arvot lisäävät satunnaisuutta. Käytä top_p ytimenäytteistykseen, joka rajoittaa harkittujen tokenien todennäköisyysmassaa.
The seed parametri mahdollistaa toistettavat tulokset. Aseta tietty siemenarvo saadaksesi saman vastauksen useiden kutsujen aikana. Tämä on hyödyllistä vianetsintään ja testaamiseen.
Yhdistä nämä parametrit mallin käyttäytymisen hienosäätämiseen tiettyä käyttötapaustasi varten. Esimerkiksi käytä matalaa temperaturea ja kiinteää seediä koodin generointiin, jossa johdonmukaisuus on avainasemassa.
Kokeile eri asetuksia löytääksesi optimaalisen tasapainon sovelluksellesi. API tukee kaikkia OpenAI-standardiparametreja, varmistaen yhteensopivuuden olemassa olevien työkalujen kanssa.
Usein kysytyt kysymykset
Mikä on kontekstiruutturajoitus sensuroimattomalle mallille?
Konteksti-ikkuna on 100 000 tokenia, ja se kattaa sekä syötteen että vastauksen. Tämä mahdollistaa laajat keskustelut ja suurten kooditiedostojen käsittelyn. Maksimi lähtö per pyyntö on 16 000 tokenia, tai 2 048, jos max_tokens-arvoa ei ole asetettu.
Miten käsittelemme virheitä, kuten nopeusrajoituksia tai riittämätöntä kredittiä?
Virhe 401 tarkoittaa virheellistä API-avainta. Virhe 402 tarkoittaa, sinulla on riittämättömästi esimaksusaldoa. Virhe 429 tarkoittaa, että olet ylittänyt 300 pyynnön minuuttirajan. Virheet ja hylkäykset eivät kuluta saldoa.
Onko tämä API yhteensopiva olemassa olevien OpenAI SDK:iden kanssa?
Kyllä, se on OpenAI-yhteensopiva API. Voit käyttää virallisia Python- ja Node.js-SDK:ita yksinkertaisesti muuttamalla base URL:n ja API-avaimen. Tämä varmistaa, että olemassa oleva koodisi toimii vähäisillä muutoksilla.