Hahmo API -integraation pikakäynnistys

Asenna SDK

Aloita asentamalla kielen virallinen asiakasohjelmistokirjasto. Tämä varmistaa yhteensopivuuden tarjoamamme OpenAI-yhteensopivan päätepisteen kanssa. Kirjasto hoitaa sinun puolestasi serialisoinnin ja uudelleenyrittämislogiikan.

Python, käytä pipiä. Node.js, käytä npm:iä. Tämä vaihe kestää sekunteja ja asettaa ympäristön seuraaville koodinäytteille.

Määritä base URL

Osoita SDK-asiakkaasi päätepisteeseesi päästäksesi käsiksi uncensored-malliin. Base URL on HTTPS://api.apicharacter.com/v1. Tämä korvaa oletusarvoisen OpenAI-URLin määrityksissäsi.

Ilman tätä muutosta pyynnöt epäonnistuvat tai osuvat väärään palveluun. Sinun tarvitsee asettaa tämä vain kerran alustaessa asiakasinstanssisi.

Aseta API-avaimesi

Syötä avaimesi ympäristömuuttujaan tai asiakasasetuksiin. Autentikointi vaaditaan jokaisessa pyynnössä esiluetun luoton käytön seuraamiseksi. Avaimesi antaa pääsyn uncensored-LLM-päätepisteeseen.

Säilytä tämä arvo turvallisesti. Se toimii ainoana tunnuksena tilillesi. Peruspääsyyn ei tarvita puhelinnumeroa tai lisätodennusta.

Tee ensimmäinen pyyntösi

Lähetä yksinkertainen chat-completion yhteensopivuuden varmistamiseksi. Mallin tunnus on "uncensored". Tämä vahvistaa, että autentikointisi ja perus-URL ovat oikein ennen sovelluksen rakentamista.

Näe esimerkki alla olevasta cURL-pyyntöä varten.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Käsittele suorantovastaukset

Ota suoratoisto käyttöön matalamman viiveen saavuttamiseksi chatliittymissäsi. Aseta stream-parametri arvoksi true pyynnössäsi. SDK tuottaa tokenit niiden syntyessä.

Tämä on kriittistä responsiivisille käyttäjäkokemuksille. Käsittelet osittaisia pätkiä niiden saapuessa Server-Sent Events -tekniikan kautta.

Copystream = 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)

Rajoitukset, virheet ja konteksti

Ymmärrä rajoituksesi välttääksesi palvelun keskeytykset. Saat 100 000 tokennin kontekstikkoneen. Maksimi lähtö on 16 000 tokenia, ellei määritä toisin.

Nopeusrajoitus on 300 pyyntöä minuutissa. Virhekoodi 401 tarkoittaa virheellistä avainta, 402 tyhjää saldoa ja 429 nopeusrajoituksen ylitystä. Huomioi nämä tuotantokäytön skaalauksessa.

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apicharacter.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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apicharacter.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);