Panduan Cepat API Tanpa Sensor
Hubungkan klien Anda ke API kami yang kompatibel dengan OpenAI menggunakan URL dasar dan kunci API Anda. Panduan ini mencakup endpoint penting, streaming, dan parameter untuk integrasi cepat.
Autentikasi dan URL Dasar
Mulai dengan mengarahkan SDK Anda ke URL dasar kami dan meneruskan kunci Anda dalam header otorisasi. Kami menyediakan layanan model tunggal langsung tanpa biaya routing proxy. Gunakan standar Authorization: Bearer skema untuk mengautentikasi permintaan. Kunci Anda dibuat segera setelah pendaftaran melalui Google atau email. Pastikan Anda mengganti kunci placeholder dalam konfigurasi klien Anda dengan kunci yang ditampilkan di dasbor Anda. URL dasar adalah https://api.uncensoredmodelsollama.com/v1. Endpoint ini mendukung klien OpenAI-compatible, memungkinkan Anda mengganti penyedia tanpa menulis ulang logika aplikasi Anda. Simpan kunci Anda dengan aman, karena kunci tersebut memberikan akses ke saldo kredit prabayar Anda.
Endpoint Chat Completions
Kirim permintaan teks ke /v1/chat/completions endpoint untuk menghasilkan respons. Endpoint ini menangani riwayat percakapan standar dan prompt sistem. Anda harus menentukan ID model sebagai uncensored dalam tubuh permintaan. API mengembalikan respons yang diformat JSON berisi teks yang dihasilkan dan statistik penggunaan token. Error seperti kredit tidak cukup atau kunci tidak valid dikembalikan dengan kode status HTTP yang sesuai. Gunakan endpoint ini untuk semua tugas generasi teks standar. Endpoint ini tidak mendukung embedding, gambar, atau fine-tuning. Jaga payload Anda di bawah 8 MB untuk memastikan pemrosesan yang andal. Model memproses token input dan output dalam jendela konteks bersama.
Respons Streaming
Aktifkan streaming dengan mengatur stream parameter ke true dalam permintaan Anda. API mengembalikan Peristiwa yang Dikirim Server (SSE) yang berisi potongan teks inkremental. Pendekatan ini mengurangi latensi yang dirasakan bagi pengguna yang menunggu output panjang. Anda menerima informasi penggunaan token di potongan terakhir stream. Terapkan handler stream di klien Anda untuk memproses peristiwa ini secara efisien. Streaming ideal untuk antarmuka obrolan dan aplikasi real-time. Pastikan pustaka klien Anda mendukung penguraian SSE untuk menangani aliran data kontinu dengan benar. Jendela konteks total tetap 100.000 token terlepas dari mode streaming.
Pemanggilan Fungsi dan Mode JSON
Gunakan tools parameter untuk mengaktifkan kemampuan pemanggilan fungsi. Tentukan fungsi Anda dalam body permintaan untuk memungkinkan model mengembalikan data terstruktur. Atur response_format ke {"type": "json_object"} untuk output JSON ketat. Fitur ini berguna untuk mengekstrak data atau menghasilkan payload terstruktur. Model mendukung parameter pilihan alat untuk mengontrol perilaku pemanggilan fungsi. Gunakan fitur-fitur ini untuk mengintegrasikan API ke dalam alur kerja otomatis. Pastikan definisi fungsi Anda sesuai dengan skema input yang diharapkan untuk hasil yang andal. API mengembalikan panggilan alat dalam format OpenAI standar untuk parsing yang mudah.
Parameter dan Batas Laju
Sesuaikan perilaku generasi menggunakan parameter seperti temperature, top_p, dan seed. Setel max_tokens untuk membatasi panjang output, dengan nilai default 2.048 jika tidak ditentukan. API menerapkan batas laju 300 permintaan per menit per kunci. Permintaan simultan dibatasi hingga 8 per kunci. Jika Anda melebihi batas ini, API mengembalikan kode status 429. Permintaan dibebankan berdasarkan penggunaan token aktual, dengan kesalahan dan penolakan gratis. Kredit tidak kadaluarsa, dan jumlah prabayar transparan. Kelola kunci Anda dengan hati-hati, karena setiap akun hanya mendukung satu kunci aktif pada satu waktu.
Batas, Error, dan Konteks
Jendela konteks mendukung 100.000 token untuk input dan output gabungan. Permintaan yang melebihi batas body 8 MB akan gagal. Kesalahan umum termasuk 401 untuk kunci tidak valid dan 402 untuk kredit tidak cukup. Tangani kesalahan ini dengan baik dalam logika aplikasi Anda. API menolak permintaan yang berisi konten seksual melibatkan anak di bawah umur, terlepas dari pengaturan lain. Konten lainnya tetap uncensored untuk penggunaan dewasa yang sah. Pantau penggunaan token Anda untuk menghindari biaya tak terduga. Sistem kredit prabayar memastikan Anda hanya membayar apa yang Anda gunakan. Tidak ada biaya langganan atau biaya tersembunyi yang berlaku untuk integrasi Anda.
cURL
curl https://api.uncensoredmodelsollama.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List all available models in the ollama library."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredmodelsollama.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredmodelsollama.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
stream = 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)Pertanyaan yang sering diajukan
Apa URL dasar models ollama tanpa sensor?
URL dasar adalah HTTPS://api.uncensoredmodelsollama.com/v1. Gunakan titik akhir ini dengan SDK apa pun yang kompatibel dengan OpenAI dengan memperbarui konfigurasi base_url. URL ini melayani model uncensored tunggal secara langsung tanpa routing proxy.
Bagaimana cara menangani respons streaming di Python?
Atur parameter stream menjadi true dalam permintaan Anda. API mengembalikan Server-Sent Events yang berisi chunk teks inkremental. Proses event ini menggunakan handler stream SDK Anda untuk menampilkan output real-time. Data penggunaan token disediakan di chunk terakhir stream.
Apa yang terjadi jika saya melebihi batas laju?
API mengembalikan kode status 429 ketika Anda melebihi 300 permintaan per menit atau 8 permintaan konkuren. Kunci Anda tetap aktif, tetapi permintaan lebih lanjut akan gagal hingga jendela batas laju direset. Pantau penggunaan Anda untuk menghindari gangguan dalam alur kerja aplikasi Anda'.
Dapatkan kunci Anda dalam satu langkah
Daftar, salin kunci, perbarui URL dasar Anda. Selesai.