API Documentație

URL de bază și autentificare

API se află la https://api.ollamaapidoc.com/v1. Te autentifici folosind un token Bearer în Authorization header. Generează-ți cheia instantaneu prin Google sau email pe panoul de control. Nu este nevoie de număr de telefon. Cheia funcționează cu SDK-urile standard OpenAI prin setarea URL-ului de bază.

Prima ta solicitare

Trimite o cerere POST la /v1/chat/completions cu ID-ul modelului uncensored. Acest endpoint gestionează input text și output text. Suportă streaming, modul JSON și function calling. Puteți testa conectivitatea fără a cheltui credit verificând mai întâi endpoint-ul models.

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

Răspunsul returnează formatarea standard OpenAI. Erorile returnează coduri HTTP adecvate. Verificați corpul pentru error detalii în cazul unei erori. Răspunsurile în flux continuu utilizează Server-Sent Events.

Integrare SDK Python

Instalează biblioteca oficială OpenAI. Configurează clientul cu URL-ul tău de bază și cheia API.apelează endpoint-ul chat completions. Codul rămâne identic cu utilizarea standard OpenAI. Acest lucru asigură o migrare ușoară pentru proiectele existente. Poți ajusta parametri precum temperatura și top_p direct în apel.

Copyfrom openai import OpenAI

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

Gestionați excepțiile pentru limitele de rată sau cheile invalide. Biblioteca transmite tokeni dacă setați stream la true. Această abordare menține baza de cod curată și compatibilă.

Configurare SDK Node.js

Folosește openai npm package. Inițializați clientul cu URL-ul de bază personalizat. Transmiteți cheia API. Sintaxa imită exemplul Python. Această consistență reduce timpul de depanare. Puteți trimite mai multe mesaje într-un array de istoric al conversației.

Copyimport OpenAI from "openai";

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

Analizați răspunsul cu grijă. API-ul returnează un JSON structurat. Gestionarea erorilor este crucială pentru aplicațiile de producție. Prindeți erorile de rețea și erorile specifice API separat. Acest lucru asigură că aplicația dvs. rămâne reactivă în timpul traficului ridicat.

Modul JSON

Activați fluxul de date setând stream parametrul la true. API-ul trimite tokenuri prin Evenimente trimise de server. Primești răspunsuri parțiale în timp real. Acest lucru îmbunătățește experiența utilizatorului pentru output-urile lungi. De asemenea, poți forța output-ul JSON folosind response_format. Acest lucru este util pentru extragerea datelor structurate.

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)

Funcția de apelare a funcțiilor funcționează similar. Definește instrumentele în cererea ta. Modelul returnează apeluri de instrumente. Analizează aceste apeluri în codul tău. Execută-le și alimentează rezultatele înapoi la model. Acest ciclu permite fluxuri de lucru complexe.

Limitări, Erori și Context

Fereastra de context are 100.000 de tokeni. Output-ul maxim este de 16.000 de tokeni per solicitare. Erorile includ 401 pentru chei invalide și 402 pentru credit insuficient. Limitele de rată sunt de 300 de solicitări pe minut. Gestionați-le elegant în aplicația dvs. API-ul nu utilizează niciodată prompturile dvs. pentru antrenament. Confidențialitatea este menținută. Creditul nu expiră.