Apertus ia API Documentation

1. Quickstart: Connect Your First Request

Base URL on https://api.apertusia.com/v1. Välitä API-avaimesi Authorization-otsakkeessa. Mallin tunniste on uncensored. Tämä asetus toimii kaikkien OpenAI-yhteensopivien asiakasohjelmien kanssa.

Käytä tätä cURL-komentoa testataksesi yhteyden välittömästi. Korvaa YOUR_API_KEY omalla todellisella avaimellasi.

Copycurl https://api.apertusia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 5 python libraries for web scraping"}]
  }'

Todennusvirheet palauttavat 401. Riittämättömät varat palauttavat 402. Käyttörajoitukset palauttavat 429.

2. Tuetut parametrit: Temperature, Top P ja Seed

Säädä satunnaisuutta temperature-arvolla, monimuotoisuutta top_p-arvolla ja toistettavuutta seed-arvolla. Nämä parametrit noudattavat OpenAI:n vakiokäytäntöjä. Aseta temperature arvoon 0.7 tasapainoisen tuloksen saamiseksi tai arvoon 1.0 suuremman luovuuden saamiseksi. Käytä top_p-arvoa rajoittaaksesi otannan todennäköisimpään osaan. seed-parametri takaa identtiset tulokset virheenkorjausta varten.

Esimerkki Python-koodinpätkästä paikalliseen testaamiseen:

Copyfrom openai import OpenAI

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

3. Suoratoistovastaukset Server-Sent Events -tekniikalla

Ota suoratoisto käyttöön asettamalla stream: true. API palauttaa osia Server-Sent Events -tekniikalla. Jokainen osa sisältää osittaisen tekstin ja token-käyttötiedot. Tämä vähentää koettua viivettä pitkissä vastauksissa. Käsittele SSE-tapahtumia päivittääksesi käyttöliittymäsi reaaliajassa.

Node.js-esimerkki virallista SDK:ta käyttäen:

Copyimport OpenAI from "openai";

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

4. Funktiokutsujen ja JSON-tilan määritys

Käytä response_format-parametria arvolla {"type": "json_object"} tiukan JSON-tulosteen varmistamiseksi. Tämä takaa rakenteisen datan ohjelmallisille putkistoille. Ota funktiokutsut käyttöön antamalla tools-taulukko pyynnön rungossa. Malli palauttaa työkalukutsut odotetussa muodossa. Käytä tool_choice-parametria pakottaaksesi tietyn toiminnan.

5. Käyttörajat ja pyyntökoon rajoitukset

Jokainen API-avain tukee 300 pyyntöä minuutissa. Samanaikaisia pyyntöjä on enintään 8 per avain. Pyynnön rungon enimmäiskoko on 8 Mt. Kontekstiikkoni tukee yhteensä 100,000 tokenia. Maksimi tulostekstiä pyyntöä kohden on jopa koko 100,000 tokenin kontekstiikkoni. Jätä max_tokens asettamatta tai aseta se korkealle välttääksesi katkaisun. Virheet eivät kuluta krediittia. Palautuksia ei myönnetä, mutta laskutusvirheet korjataan tuen kautta.

6. Todennus ja virheiden hallinta

Luo avain hallintapaneelista. Kirjaudu sisään Google-tilillä tai sähköpostilla. Avain näkyy välittömästi. Lisää se Authorization: Bearer-otsakkeeseen. Virheelliset avaimet palauttavat virhekoodin 401. Virhekoodi 429 tarkoittaa, että nopeusrajoitus on ylitetty. Virhekoodi 402 tarkoittaa, että esimaksukrediittisi on loppu. Lisää saldoa USDT- tai USDC-maksulla. Krediitit eivät vanhene.

Suoratoisto

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)