API-pika-aloitus & integrointi

Perus-URL ja todennus

Heretic Project tarjoaa yhden isännöidyn päätepisteen tekstigenerointiin. Käytä https://api.hereticproject.com/v1 pohja-URL:ksi. Todennus perustuu bearer-tokeniin, joka välitetään kenttään Authorization header. Luo avain kirjautumalla sisään Google- tai sähköpostitilin kautta hallintapaneelissa. Järjestelmä myöntää yhden aktiivisen avaimen tilille; uuden avaimen luominen mitätöi edellisen välittömästi.

Maksat vain käytetyistä tokenneista. Virheet ja hylkäykset eivät veloita esimaksukrediittistäsi. Uusiin tileihin myönnetään $0,50 kokeilukredito, joka on voimassa seitsemän päivän ajan. Lisäät rahaa USDT:llä (TRC20) tai USDC:llä (Base) summien välillä $20–$500.

Päätepiste /v1/chat/completions

Lähetä viestit standardiin chat-täydennyspäätepisteeseen. Mallin tunnus on uncensored. Se hyväksyy listan viiesobjekteista, joilla on roolit kuten system, user, tai assistant. Malli ei kiistä laillista aikuis-, fiktiivistä tai kiistanalaista sisältöä. Se on avoimen painotuksen malli, joka on hienosäädetty suoraviivaisiin vastauksiin.

Pyyntö palauttaa JSON-objektin, joka sisältää tuotetun tekstin. Kontekstiikkuna tukee yhteensä 100 000 tokenia syötteelle ja tulokselle. Tulostus on rajoitettu 16 000 tokeniin pyyntöä kohden, ellei määritä alempaa max_tokens arvo.

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK -integraatio

Käytä virallista OpenAI:n Python-kirjastoa mukautetulla base URL:llä. Aseta api_key API-merkkijallesi. Määritä base_url osoittamaan Heretic Project -palvelimelle. Tämä mahdollistaa tutkittujen menetelmien kuten chat.completions.create() muuttamatta olemassa olevaa koodirakennettasi merkittävästi.

Asenna kirjasto pip:n kautta. Välitä kirjautumistietosi suoraan asiakasohjelman alustuksessa. Kirjasto hoitaa serialisoinnin automaattisesti. Tämä menetelmä toimii sekä synkronisissa että asynkronisissa työvuoroissa. Varmista, että käsittelet mahdolliset verkkovirheet joustavasti.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticproject.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 SDK -integraatio

Node.js-SDK toimii identtisesti Python-versiion kanssa. Alusta asiakas API-avaimellasi ja oikealla base URL -arvolla. Voit lähettää completion-pyyntöjä käyttäen samoja metodialoituksia. Tämä varmistaa johdonmukaisuuden eri osissa koodikantaasi.

Käsittele vastaukset asynkronisesti. SDK streamaa dataa, jos käytät streamausmetodia. Muuten se palauttaa täyden JSON-vastauksen. Tämä joustavuus tukee sekä eräprosesointia että reaaliaikaisia käyttöliittymiä. Pidä API-avaimesi turvassa ympäristömuuttujissa.

Copyimport OpenAI from "openai";

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

Streamausvastaukset (SSE)

Ota streamaus käyttöön asettamalla stream: true pyynnössäsi. Palvelin lähettää Server-Sent Events (SSE) -tekniikan. Jokainen osa sisältää osittaisen tekstin päivityksen. Tämä vähentää koettua viivettä pääkäyttäjille. Tokenkäyttödata ilmestyy streamin viimeisessä osassa.

Käsittele jokainen delta-objektit kertyäksesi täydellisen vastauksen. Lopeta kuuntelu, kun streami sulkeutuu tai tapahtuu virhe. Tämä menetelmä on ihanteellinen chat-liittymille. Se mahdollistaa käyttäjien nähdä ajatusten muodostumisen reaaliajassa. Ylikuormitus on vähäistä verrattuna täysimittaisiin vastauksiin.

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

Kunnioita nopeusrajoituksia välttääksesi palvelun keskeytykset. Sinulla on oikeus 300 pyyntöön minuutissa per avain. Samanaikaisuus on rajoitettu 8 samanaikaiseen pyyntöön. Pyynnön keho ei voi ylittää 8 Mt:ia. Näiden rajojen ylitys palauttaa tilakoodin 429. Odota hetki ennen uudelleenyritystä.

Todennusvirheet palauttavat 401-virheen. Tämä tapahtuu, jos avain on virheellinen tai vanhentunut. 402-virhe tarkoittaa riittämätöntä esimaksua. Palautusvirheet hoidetaan Tuki-sivun kautta. Luoto ei vanhene. Malli kieltää alaikäisiin liittyvän sisällön. Kaikki muu laillinen sisältö hyväksytään.