Malli API: pika-aloitusopas

Todennus ja base URL

Päätepiste sijaitsee osoitteessa https://api.modelapis.cc/v1. Syötä avin Authorization header Bearer-tokenina. Järjestelmä hylkää pyynnöt, joissa on virheellisiä avaimia 401-virheillä, ja estää yritykset käyttää luottoa, jota sinulla ei ole, 402-vastauksilla. Voit luoda uuden avaimen välittömästi dashboardista, ja vanha avain muuttuu epäaktiiviseksi välittömästi.

Lähettämällä chat-completion

Lähetä POST-pyyntö osoitteeseen /v1/chat/completions viestihistoriallasi. Mallin id on "uncensored" ja se hyväksyy vakioparametreja kuten temperature ja top_p. Tämä kokoonpano toimii minkä tahansa asiakkaan kanssa, joka puhuu OpenAI-protokollaa, mukaan lukien Cursor ja muut kehitystyökalut.

Copycurl https://api.modelapis.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "get current unix timestamp"}]
  }'

Tarkista vastauksesta content kenttä avustajaviestin sisällä. Jos ylität nopeusrajoituksesi, API palauttaa 429-tilakoodin. Voit seurata jäljellä olevaa saldoa suoraan hallintapaneelissa ilman, että sinun tarvitsee lukea otsikoita manuaalisesti.

Streamausvastaukset SSE:n kautta

Ota streamaus käyttöön asettamalla stream: true pyyntörunkossa. API palauttaa palveluntason tapahtumia (SSE) sisältäviä osittaisia tekstin osia. Tämä lähestymistapa on ihanteellinen chatliittymien rakentamiseen, jotka renderöivät tekstin sen synnyttyä.

Copyfrom openai import OpenAI

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

Jokainen lohko sisältää vain fragmentin lopullisesta vastauksesta. Viimeinen lohko sisältää koko pyynnön tokenkäyttötilastot. Tämä mahdollistaa kustannusten seurannan reaaliajassa odottamatta koko generoinnin valmistumista.

Funktikutsut ja työkalut

Määritä työkalut tools parametri ja aseta tool_choice vastaan auto. Malli palauttaa rakenteellisia työkalukutsuja, kun se on aiheellista, mikä mahdollistaa sovelluksesi suorittaa ulkoisia funktioita. Tämä ominaisuus toimii saumattomasti standardien OpenAI SDK:iden kanssa.

Copyimport OpenAI from "openai";

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

Jäsennä tool_calls taulukko avustajaviestissä laukaistaksesi backend-logiikkasi. Voit sitten syöttää tulokset takaisin keskusteluun työkaluvastauksina. Tämä sykli mahdollistaa monimutkaisten agentic-workflowjen suorittamisen ilman API:n ulkopuolelle siirtymistä.

JSON-tilan pakottaminen

Aseta response_format vastaan {"type": "json_object"} pakottaa mallin tuottamaan validia JSONia. Tämä on ratkaisevaa sovelluksille, jotka jäsentävät vastauksen ohjelmallisesti. Malli noudattaa tätä ehtoa tiukasti.

Käytä tätä tilaa, kun tarvitset ennustettavia rakenteita dataputkiisi varten. Se vähentää tarvetta jälkikäsittelyregex-hakeille. Malli pysyy sensuroimattomana myös JSON-tilassa, toimittaen raakaa dataa ilman sisällonsuodattimia.

Tokenirajoitukset ja kontekstiikkuna

Kontekstiluukku tukee jopa 100 000 tokenia sekä promptin että completionin yhteensä. Voit pyytää jopa 16 000 tulostustokenia pyyntöä kohden. Jos et määritä max_tokens, oletusarvoisesti 2 048 tokeniä.

Pyyntöjä on rajoitettu 300:aan minuutissa per avain. Pyyntöjen rungon maksimikoko on 8 Mt. Nämä rajat varmistavat vakaan suorituskyvyn suuren määrän käyttöä varten. Virheet ja hylkäykset eivät kuluta esimaksukrediittiäsi, joten maksat vain onnistuneista tuotannoista.

Virtaus

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)