Dokumentasi API

Memulai: Hubungkan Permintaan Pertama Anda

Mulai dengan membuat kunci Anda di dasbor. URL dasar untuk semua permintaan adalah HTTPS://api.filterno.cc/v1. Masukkan kunci Anda di header Otorisasi sebagai token bearer. Pengaturan ini berfungsi dengan klien yang kompatibel dengan OpenAI standar apa pun.

Uji konektivitas segera dengan permintaan penyelesaian sederhana. Endpoint ini menerima format chat standar dan mengembalikan teks mentah tanpa filter konten.

Ganti YOUR_API_KEY dengan string yang diterbitkan ke akun Anda. Badan permintaan menentukan model dan konten pesan. Anda menerima respons yang berisi teks yang dihasilkan.

Endpoint: POST /v1/chat/completions

Kirimkan prompt Anda ke POST /v1/chat/completions. Ini adalah satu-satunya endpoint obrolan yang kami dukung. Anda memberikan instruksi sistem dan pesan pengguna dalam format array.

Pengidentifikasi model adalah "uncensored". Model ini memproses input teks dan mengembalikan output teks. Jangan mengharapkan generasi gambar atau audio di sini.

Atur suhu untuk mengendalikan keacakan. Nilai yang lebih tinggi menghasilkan output yang lebih kreatif. Nilai yang lebih rendah menghasilkan hasil yang deterministik. API secara ketat mengikuti skema OpenAI untuk titik akhir ini.

Endpoint: GET /v1/models

Verifikasi model yang tersedia dengan permintaan GET ke /v1/models. Endpoint ini mengembalikan daftar ID model yang didukung. Anda harus melihat "uncensored" dalam respons.

Endpoint ini mengonfirmasi bahwa kunci API Anda valid. Endpoint ini juga menampilkan detail model. Gunakan untuk masalah debug konektivitas.

Respons mencakup ID model dan tipe objek. Respons tidak mencantumkan harga atau batas. Periksa dokumentasi untuk tarif token.

Parameter: Suhu, Top-P, dan Tools

Kendalikan keragaman generasi dengan suhu dan top_p. Suhu menyesuaikan distribusi probabilitas. Top_p memfilter token berprobabilitas rendah. Bersama-sama, keduanya menyeimbangkan kreativitas dan fokus.

Gunakan pemanggilan fungsi untuk interaksi terstruktur. Tentukan alat dalam body permintaan. Model dapat memanggil fungsi-fungsi ini. Teruskan tool_choice untuk memaksakan perilaku tertentu.

Atur urutan stop untuk mengakhiri generasi lebih awal. Gunakan seed untuk hasil yang dapat direproduksi. Penalti presence dan frequency mengurangi pengulangan. Parameter ini mengikuti konvensi standar OpenAI.

Respons Streaming (SSE) & Penggunaan Token

Aktifkan streaming dengan mengatur stream menjadi true. API mengembalikan Server-Sent Events (SSE). Setiap potongan berisi data token parsial.

Penggunaan token muncul di potongan terakhir. Bacalah untuk melacak biaya. Streaming mengurangi latensi yang dirasakan untuk respons panjang. Ini ideal untuk aplikasi real-time.

Parse struktur data SSE dengan hati-hati. Tangani gangguan jaringan dengan anggun. API memastikan integritas data melalui batas potongan.

Batas, Error, dan Aritmetika Token

Anda mendapatkan 300 permintaan per menit per kunci. Konkurensi dibatasi hingga 8 permintaan simultan. Ukuran tubuh permintaan maksimum adalah 8 MB.

Jendela konteks adalah 100.000 token. Ini mencakup prompt dan completion. Output maksimum adalah 16.000 token. Atur max_tokens untuk membatasi penggunaan.

Tangani kesalahan dengan memeriksa kode status. 401 berarti kunci tidak valid. 402 menunjukkan tidak ada kredit. 429 menandakan batas laju. Coba lagi dengan backoff eksponensial untuk 429.

cURL

Copycurl https://api.filterno.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the top five risks in a standard React application."}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)