Panduan Cepat: Integrasi API Uncensored

Prasyarat: SDK dan Penyiapan Lingkungan

Instal SDK resmi untuk bahasa pemrograman Anda. Kami mendukung apa saja openai klien yang kompatibel. Layanan kami bertindak sebagai pengganti langsung untuk integrasi OpenAI standar.

Atur variabel lingkungan Anda segera. Ini menghindari pengkodean kredensial secara langsung di file sumber Anda. Kunci API Anda mengidentifikasi akun Anda dan melacak penggunaan.

Gunakan versi pustaka standar. Sebagian besar pengembang sudah memiliki ini terpasang. Jika belum, tambahkan paket ke dependensi Anda.

Autentikasi: Mengatur Kunci API

Masukkan kunci Anda melalui Authorization header. Kami memerlukan token Bearer untuk setiap permintaan. Metode ini standar di semua endpoint yang kompatibel dengan OpenAI.

Buat kunci Anda dari dasbor. Anda menerima satu kunci aktif per akun. Menggantinya akan membuat kunci sebelumnya tidak berlaku secara instan.

Jaga kunci Anda tetap aman. Jangan paparkan dalam kode sisi klien. Endpoint kami memvalidasi kredensial sebelum memproses token.

Endpoint: POST /v1/chat/completions

Kirimkan prompt Anda ke endpoint obrolan. Gunakan model field set to uncensoredIni memastikan permintaan dialihkan ke model khusus kami.

Respons Streaming melalui SSE

Aktifkan streaming dengan mengatur stream: true. Anda menerima potongan teks saat teks tersebut dihasilkan. Ini mengurangi latensi yang dirasakan untuk output panjang.

Parse format Server-Sent Events. Setiap chunk berisi teks parsial. Kumpulkan chunk-chunk ini untuk merekonstruksi respons penuh.

Pantau penggunaan token di potongan terakhir. Peristiwa terakhir mencakup statistik penggunaan lengkap. Ini membantu Anda melacak biaya secara akurat.

Pemanggilan Fungsi dan Penggunaan Alat

Tentukan alat dalam body permintaan Anda. Model mengembalikan argumen terstruktur. Parse argumen-argumen ini dalam logika aplikasi Anda.

Mendukung definisi alat standar. Gunakan tool_choice untuk memaksa perilaku tertentu. Ini bekerja dengan SDK apa pun yang kompatibel dengan OpenAI.

Validkan format output. Pastikan kode Anda menangani argumen yang hilang dengan baik. Model mungkin mengabaikan bidang jika tidak diperlukan.

Mode JSON dan Output Terstruktur

Atur response_format ke json_object. Model mengembalikan JSON yang diformat secara ketat. Ini menghilangkan kesalahan parsing untuk data terstruktur.

Tentukan skema Anda dengan jelas. Model mengikuti instruksi Anda dengan tepat. Gunakan ini untuk ekstraksi data atau generasi konfigurasi.

Tangani kesalahan parsing JSON. Struktur yang tidak valid masih terjadi sesekali. Terapkan logika fallback untuk aplikasi yang tangguh.

Penanganan Kesalahan dan Batasan Laju

Tangani kode status HTTP dengan tepat. A 401 error berarti kunci Anda tidak valid. A 402 error menunjukkan kredit tidak cukup. A 429 error menandakan pembatasan laju.

Hormati batas 300 permintaan per menit. Anda dapat mengirim 8 permintaan konkurens. Melampaui batas-batas ini mengembalikan error 429. Tunggu sebelum mencoba lagi.

Jendela konteks Anda adalah 100,000 token. Ini mencakup input dan output. Kelola anggaran token Anda dengan hati-hati. Output maksimum adalah 16,000 token per permintaan. Error tidak mengonsumsi kredit.

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

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)