Panduan Cepat untuk Pengguna Ollama NSFW

Prasyarat dan Autentikasi

Anda memerlukan kunci API dan URL dasar untuk memulai. Daftar di halaman Dapatkan kunci API menggunakan Google atau email. Kunci Anda muncul segera; tidak memerlukan kartu untuk uji coba. URL dasar adalah https://api.ollamansfw.com/v1. Atur ini di lingkungan atau konfigurasi SDK Anda. Pengidentifikasi model adalah uncensored. Ini adalah model bobot terbuka yang berjalan di server kami, berbeda dari GPT atau model vendor lain.

Permintaan Pertama Anda

Kirim permintaan penyelesaian obrolan standar. API mengharapkan array pesan dengan peran dan konten. Gunakan curl untuk menguji konektivitas. Ganti YOUR_API_KEY dengan kunci asli Anda. Respons mengembalikan teks yang dihasilkan di choices[0].message.content. Jika Anda mendapatkan 401, periksa kunci Anda. 402 berarti Anda membutuhkan kredit.

Integrasi SDK Python

Gunakan paket Python openai resmi. Instal melalui pip. Konfigurasikan klien dengan URL dasar kustom dan kunci API. Ini memastikan kompatibilitas dengan endpoint kami. Kode di bawah ini mendemonstrasikan generasi teks sederhana. Ini menangani permintaan dan mencetak hasilnya. Penanganan kesalahan harus menangkap pengecualian HTTP. Pendekatan ini berfungsi untuk klien kompatibel OpenAI apa pun.

Integrasi SDK Node.js

Instal paket Node.js openai. Atur URL dasar dan kunci API dalam inisialisasi klien. Strukturnya mencerminkan contoh Python. Teruskan ID model uncensored. Respons berisi data penyelesaian. Gunakan async/await untuk kode yang bersih. Metode ini ideal untuk aplikasi sisi server atau alat CLI yang membutuhkan akses API langsung.

Respons Streaming

Aktifkan streaming dengan mengatur stream: true. API mengembalikan aliran peristiwa yang dikirim server (SSE). Setiap potongan berisi teks parsial. Potongan terakhir mencakup statistik penggunaan token. Ini mengurangi latensi yang dirasakan untuk respons panjang. Tangani kesalahan streaming dengan baik. SDK menyediakan iterator stream bawaan. Proses setiap potongan untuk memperbarui UI secara real-time.

Batas, Kesalahan, dan Konteks

Jendela konteks adalah 100,000 token total. Output dapat berjalan hingga akhir jendela. Batas laju adalah 300 permintaan per menit. Permintaan paralel dibatasi hingga 8 per kunci. Badan permintaan harus di bawah 8 MB. Kesalahan umum: 401 (kunci tidak valid), 402 (kredit tidak cukup), 429 (batas laju). Kesalahan tidak mengonsumsi kredit. Penolakan untuk konten ilegal gratis. Kredit tidak pernah kedaluwarsa.

cURL

Salincurl https://api.ollamansfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Salinfrom openai import OpenAI

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

Node.js

Salinimport OpenAI from "openai";

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

Streaming

Salinstream = 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)