API Dokumentasi

URL Dasar dan Autentikasi

API berada di https://api.ollamaapidoc.com/v1. Anda mengautentikasi menggunakan token Bearer di Authorization header. Buat kunci Anda secara instan melalui Google atau email di dasbor. Tidak diperlukan nomor telepon. Kunci berfungsi dengan SDK OpenAI standar dengan mengatur URL dasar.

Permintaan Pertama Anda

Kirim permintaan POST ke /v1/chat/completions dengan ID model uncensored. Endpoint ini menangani input teks dan output teks. Endpoint ini mendukung streaming, mode JSON, dan pemanggilan fungsi. Anda dapat menguji konektivitas tanpa menghabiskan kredit dengan memeriksa endpoint model terlebih dahulu.

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"}]
  }'

Respons mengembalikan format OpenAI standar. Kesalahan mengembalikan kode HTTP yang sesuai. Periksa body untuk error detail jika terjadi kesalahan. Respons streaming menggunakan Server-Sent Events.

Integrasi SDK Python

Instal perpustakaan resmi OpenAI. Konfigurasikan klien dengan URL dasar dan kunci API Anda. Panggil endpoint penyelesaian chat. Kode tetap identik dengan penggunaan OpenAI standar. Ini memastikan migrasi mudah untuk proyek yang sudah ada. Anda dapat menyesuaikan parameter seperti suhu dan top_p secara langsung dalam panggilan.

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)

Tangani pengecualian untuk batas laju atau kunci tidak valid. Perpustakaan mengalirkan token jika Anda mengatur stream ke true. Pendekatan ini menjaga basis kode Anda tetap bersih dan kompatibel.

Pengaturan SDK Node.js

Gunakan openai paket npm. Inisialisasi klien dengan URL dasar kustom. Luluskan kunci API Anda. Sintaksnya mencerminkan contoh Python. Konsistensi ini mengurangi waktu debugging. Anda dapat mengirim beberapa pesan dalam array riwayat percakapan.

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);

Parse respons dengan hati-hati. API mengembalikan JSON terstruktur. Penanganan kesalahan sangat penting untuk aplikasi produksi. Tangkap kesalahan jaringan dan kesalahan spesifik API secara terpisah. Ini memastikan aplikasi Anda tetap responsif selama lalu lintas tinggi.

Mode Streaming dan JSON

Aktifkan streaming dengan mengatur stream parameter menjadi true. API mengirimkan token melalui Server-Sent Events. Anda menerima respons parsial secara real-time. Ini meningkatkan pengalaman pengguna untuk output panjang. Anda juga dapat memaksakan output JSON menggunakan response_format. Ini berguna untuk ekstraksi data terstruktur.

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)

Pemanggilan fungsi bekerja serupa. Definisikan alat dalam permintaan Anda. Model mengembalikan panggilan alat. Parse panggilan ini dalam kode Anda. Eksekusi dan masukkan hasilnya kembali ke model. Loop ini memungkinkan alur kerja kompleks.

Batas, Error, dan Konteks

Jendela konteks adalah 100.000 token. Output maksimum adalah 16.000 token per permintaan. Error mencakup 401 untuk kunci tidak valid dan 402 untuk kredit tidak cukup. Batas laju dibatasi pada 300 permintaan per menit. Tangani ini dengan baik di aplikasi Anda. API tidak pernah menggunakan prompt Anda untuk pelatihan. Privasi terjaga. Kredit tidak kedaluwarsa.