Panduan Integrasi

Panduan Cepat: Permintaan pertama Anda

API ini adalah API yang kompatibel dengan openai yang mencerminkan struktur Chat Completions. Anda mengirim teks, menerima teks. Tidak ada endpoint tambahan untuk embedding atau audio yang mengganggu alur kerja Anda. Mulailah dengan mengarahkan klien Anda ke URL dasar kami.

• URL Dasar: HTTPS://api.filtrosemia.com/v1
• ID Model: "uncensored"

Gantilah URL dasar Anda yang lama dalam konfigurasi SDK Anda. Titik akhir menangani segala sesuatu mulai dari roleplay hingga terjemahan tanpa filter biasa.

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

Autentikasi dan Header

Masukkan kunci API Anda di header Authorization standar. Kami menggunakan satu kunci aktif per akun untuk kesederhanaan. Jika Anda membutuhkan yang baru, hasilkan dari dasbor Anda.

• Header: Authorization: Bearer YOUR_API_KEY
• Tidak ada alur OAuth atau token penyegaran untuk dikelola.

Jaga kunci Anda tetap aman. Ini memberikan akses langsung ke kredit prabayar Anda. Kesalahan seperti 401 Unauthorized berarti kunci hilang atau tidak valid.

Copyfrom openai import OpenAI

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

Endpoint Chat Completions

Kirim pesan ke POST /v1/chat/completions. Model mendukung parameter standar seperti temperature, top_p, dan stop urutan. Ini adalah model uncensored yang disesuaikan untuk konten dewasa dan kreatif.

• Mendukung json_object format respons.
• Menerima definisi alat untuk function calling.

Permintaan diproses secara berurutan sesuai batas laju Anda. Pastikan payload Anda tetap di bawah 8 MB.

Copyimport OpenAI from "openai";

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

Respons Streaming (SSE)

Gunakan Server-Sent Events untuk pengiriman token real-time. Ini mengurangi latensi yang dirasakan untuk output panjang. Potongan terakhir berisi statistik penggunaan token lengkap.

• Atur stream: true dalam permintaan Anda.
• Parse stream SSE di klien Anda.

Streaming bekerja identik dengan perilaku SDK OpenAI standar. Anda menangani potongan data saat tiba.

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)

Jendela Konteks dan Batas

Model ini mendukung jendela konteks 100.000 token. Ini memungkinkan beban kerja berat dengan riwayat panjang. Output maksimum adalah 16.000 token per permintaan.

• Output maksimum default: 2.048 token.
• Batas laju: 300 permintaan per menit.

Melebihi batas memicu 429 Too Many Requests error. Sesuaikan konkurensi Anda agar tetap dalam batas. Diperbolehkan 8 permintaan bersamaan per kunci.

Penanganan Kesalahan dan Token

Tangani kesalahan HTTP standar. 402 Payment Required berarti kredit prabayar Anda telah habis. 429 menunjukkan pembatasan laju. 401 sinyal masalah autentikasi.

• Kesalahan gratis. Anda hanya membayar untuk penggunaan token yang berhasil.
• Penolakan karena kebijakan konten juga gratis.

Periksa body respons untuk pesan kesalahan terperinci. Gunakan ini untuk menyesuaikan logika coba ulang atau frekuensi pengisian ulang kredit.