Panduan Cepat: Integrasi API Tanpa Sensor

Prasyarat dan Instalasi SDK

API memerlukan kunci API yang valid dan SDK modern. Instal perpustakaan untuk bahasa pilihan Anda melalui pip atau npm. Kami mendukung pustaka klien OpenAI standar yang menangani autentikasi dan parsing JSON secara otomatis.

Pastikan Anda memiliki Python 3.8+ atau Node.js 18+ yang terinstal. SDK mengelola pengelompokan koneksi dan logika pengulangan untuk Anda. Ini mengurangi kode boilerplate secara signifikan.

Copyfrom openai import OpenAI

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

Mengkonfigurasi URL Dasar dan Kunci API

Arahkan klien Anda ke endpoint khusus kami. Gunakan URL dasar yang disediakan di dasbor Anda. Teruskan kunci API Anda di header Authorization. Ini memastikan permintaan mencapai infrastruktur tanpa sensor secara langsung.

Jangan gunakan URL dasar OpenAI default. Kunci Anda akan gagal jika dialihkan secara salah. Atur URL dasar di objek konfigurasi SDK Anda sebelum mengirim data apa pun.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

Mengirim Permintaan Chat Completion Pertama Anda

Kirim permintaan POST ke /v1/chat/completions. Sertakan ID model dan array pesan. Model merespons dengan konten teks secara langsung. Tidak diperlukan logika routing yang kompleks.

Jaga payload agar sederhana. Mulai dengan satu prompt sistem dan satu pesan pengguna. Verifikasi struktur respons sesuai dengan standar OpenAI. Ini mengonfirmasi bahwa integrasi Anda berfungsi dengan benar.

Copyimport OpenAI from "openai";

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

Menangani Respons Streaming dan Penggunaan Alat

Aktifkan streaming dengan mengatur stream menjadi true. API mengembalikan potongan melalui Server-Sent Events. Setiap potongan berisi teks parsial atau data penggunaan token. Agregasikan potongan-potongan ini untuk menampilkan output real-time.

Penggunaan alat didukung untuk pemanggilan fungsi. Tentukan alat Anda dalam permintaan. Model mengembalikan panggilan alat alih-alih teks biasa ketika sesuai. Parse panggilan alat untuk mengeksekusi logika kustom Anda.

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)

Memahami Batas Token dan Context Window

Jendela konteks mendukung total 100.000 token. Ini termasuk token input dan output. Atur max_tokens untuk membatasi panjang respons. Output maksimum default adalah 2.048 token jika tidak ditentukan.

Pantau penggunaan token di potongan streaming terakhir. Kesalahan tidak mengonsumsi kredit. Ini memungkinkan eksperimen aman tanpa risiko keuangan. Rancang struktur prompt Anda agar tetap dalam batas.

Pemecahan Masalah Error Umum

Periksa kunci API Anda terlebih dahulu. Error 401 menunjukkan kunci tidak valid atau telah kedaluwarsa. Error 402 berarti kredit prabayar Anda telah habis. Isi ulang melalui kripto untuk melanjutkan.

Kesalahan 429 menandakan pembatasan laju. Anda dibatasi hingga 300 permintaan per menit. Kurangi konkurensi Anda atau tunggu sebelum mencoba lagi. Batas tubuh 8 MB juga memicu kesalahan 400 jika melebihi.