Documentație API & Quickstart

URL de bază și autentificare

Folosește URL-ul nostru de bază și o singură cheie API pentru a te conecta. Endpoint-ul acceptă antete standard. Înlocuiește YOUR_API_KEY cu șirul din panoul dvs.

• URL de bază: https://api.ollamaopenaicompatibleapi.com/v1
• ID Model: uncensored

Autentificarea se bazează pe un token bearer. Transmite-l în Authorization header., Acest lucru asigură compatibilitatea cu orice client compatibil SDK OpenAI. Poți genera o cheie nouă instantaneu prin Google sau email. Nu este necesar un număr de telefon.

Endpoint Completări Chat

Trimite o cerere POST la /v1/chat/completions. Include your messages array and model name. The API returns text output based on your prompt. This works with any provider using standard parameters.

Setează temperatura pentru creativitate sau menține-o scăzută pentru precizie. Poți defini, de asemenea, secvențe de oprire. Serverul procesează solicitarea și returnează completarea. Aceasta este interacțiunea de bază pentru majoritatea integrărilor.

Amintește că erorile nu consumă creditul tău preplătit. Doar completările cu succes sunt facturate. Acest lucru îți protejează bugetul în timpul fazelor de depanare.

Copycurl https://api.ollamaopenaicompatibleapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top 10 Linux kernel security patches from 2023"}]
  }'

Răspunsuri în streaming prin SSE

Activați streaming-ul setând stream: true. Serverul trimite fragmente pe măsură ce sunt generate. Acest lucru reduce semnificativ latența percepută. Primești răspunsuri parțiale în timp real.

Analizați fluxul Server-Sent Events. Fragmentul final conține statisticile de utilizare. Acesta include numerele de tokeni atât pentru input, cât și pentru output. Puteți urmări costurile dinamic în timpul generării.

Această abordare funcționează bine pentru interfețele de chat. Utilizatorii văd textul apărând cuvânt cu cuvânt. Se simte mai responsabil decât așteptarea răspunsului complet. API gestionează stabilitatea conexiunii automat.

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)

Apelarea funcțiilor și modul JSON

Definește instrumentele în corpul cererii. Modelul poate genera date structurate. Folosește response_format cu {"type": "json_object"} pentru JSON strict. Acest lucru asigură un output analizabil de fiecare dată.

Tool definitions include name, description, and parameters. The model decides which tool to call. You execute the function and feed results back. This enables complex agent workflows.

mod JSON dezactivează generarea de text liber. Forțează modelul să respecte schema ta. Folosește acest lucru când te integrezi cu baze de date sau API-uri. Reduce halucinațiile în câmpurile structurate.

Copyfrom openai import OpenAI

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

Limite de rată și corpuri de cereri

Primești 300 de cereri pe minut per cheie. Concurența este limitată la 8 cereri simultane. Dimensiunea maximă a corpului cererii este de 8 MB. Acest lucru se potrivește majorității aplicațiilor care procesează text.

Fereastra de context permite 100.000 de tokeni în total. Acest lucru include atât promptul, cât și completarea. Output-ul maxim per solicitare este de 16.000 de tokeni. Dacă omiți max_tokens, se implică implicit la 2.048.

Gestionați erorile HTTP 429 cu grijă. Ele indică faptul că ați atins limita de rată. Implementați backoff exponențial în codul clientului. Acest lucru previne supraîncărcarea serverului în timpul vârfurilor.

Copyimport OpenAI from "openai";

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

Erori de Autentificare și Limite

O eroare 401 înseamnă că cheia ta este invalidă. Verifică eventualele greșeli de tastare sau sesiunile expirate. O eroare 402 indică un credit insuficient. Reîncarcă prin criptomonede pentru a relua serviciul.

Un status 429 semnalează limitarea ratei. Ai depășit 300 de cereri pe minut. Reduce debitul sau actualizează-ți cheia. API-ul returnează mesaje de eroare clare.

Creditul nu expiră. Poți reîncărca oricând. Reîncărcarea minimă este de $20. Creditele bonus se aplică pentru sume mai mari. Acest lucru menține proiectul tău funcționând fără probleme.